Aller directement au contenu principal
@capgo/capacitor-installateur de référentiel Analytiques Source

Installer l'extension Referrer Capacitor extension

Lire les données de l'installateur Google Play et l'attribution Apple AdServices à partir de Capacitor

Installer

bun add @capgo/capacitor-install-referrer bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-install-referrer
  • pnpm add @capgo/capacitor-install-referrer
  • yarn add @capgo/capacitor-install-referrer

Guide

Comment utiliser Install Referrer dans Capacitor

Testez sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

App Store Google Play
Installateur de référentiel de plugin preview QR code

En utilisant @capgo/capacitor-install-referrer

@capgo/capacitor-install-referrer lit les signaux d'attribution d'installation dans les applications Capacitor.

Utilisez-le lorsque vous avez besoin de données d'Install Referrer Google Play sur Android et de jetons d'attribution Apple AdServices sur iOS à travers un API.

Installer

bun add @capgo/capacitor-install-referrer
bunx cap sync

Ceci que ce plugin expose

  • getReferrer retourne les détails d'attribution d'installation pour Android ou iOS.
  • GetReferrer est un alias de compatibilité déprécié pour la migration depuis cap-play-install-referrer.
  • Android retourne la chaîne de référentiel Play, le timestamp du clic, le timestamp d'installation et le drapeau d'application instantanée.
  • iOS retourne un jeton d'attribution AdServices et peut optionnellement récupérer le payload d'attribution d'Apple.

Exemple d'utilisation

import { InstallReferrer } from '@capgo/capacitor-install-referrer';

const result = await InstallReferrer.getReferrer();

if (result.platform === 'android') {
  console.log(result.referrer);
}

if (result.platform === 'ios') {
  console.log(result.attributionToken);
}

Payload d'attribution Apple

const result = await InstallReferrer.getReferrer({
  fetchAppleAttribution: true,
  appleAttributionRetryCount: 3,
  appleAttributionRetryDelayMs: 5000,
});

console.log(result.appleAttribution);

Remarques sur les plateformes

L'Android utilise le service Google Play Install Referrer et nécessite une installation de magasin Play pour des données de référentiel réelles. iOS utilise AdServices d'Apple car Apple ne fournit pas un équivalent de référentiel de magasin App Store générique.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-install-referrer

Si vous utilisez Utilisation de @capgo/capacitor-install-referrer pour planifier le travail de plugin natif, connectez-l’à @capgo/capacitor-install-referrer pour les détails d'implémentation dans @capgo/capacitor-install-referrer, Prise en main pour les détails d'implémentation dans Prise en main, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajouter ou mettre à jour des plugins.

FAQ

FAQ du plugin Install Referrer

Comment installer le plugin Install Referrer dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-install-referrer » (ou « npm install @capgo/capacitor-install-referrer »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en charge les natives code. Importez-l’à partir de « @capgo/capacitor-install-referrer » dans votre application code.

Fonctionne-t-il @capgo/capacitor-install-referrer avec React, Vue et Angular ?

Oui. Install Referrer est un Capacitor package, il fonctionne donc avec tout framework web qui tourne à l'intérieur Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor supporte @capgo/capacitor-install-referrer ?

Capgo plugins suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-install-referrer est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-install-referrer/ et le package est gratuit pour l'installer à partir de npm. Les rapports de bogues et les demandes de modification sont les bienvenus.

Puis-je mettre à jour code qui utilise Install Referrer sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin change les natives code, il faut donc une nouvelle construction de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo en direct.

Analytique

Plugins liés

Tous les plugins →

Ship Install Referrer changes without waiting for app review

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel poussent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrer avec Capgo