Aller au contenu principal
@capgo/capacitor-install-referrer Statistiques Open source

Installer Referrer Plugin Capacitor

Lisez les données d'install referrer de Google Play et l'attribution AdServices d'Apple depuis 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

Tester sur l'appareil

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

App Store Google Play
Aperçu QR du plugin Install Referrer code

Utiliser @capgo/capacitor-install-referrer

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

Utilisez-le pour obtenir les données Google Play Install Referrer sur Android et les tokens d'attribution Apple AdServices sur iOS via un seul API.

Installer

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

Ce que ce plugin expose

  • getReferrer renvoie les détails de l'attribution d'installation pour Android ou iOS.
  • GetReferrer est un alias de compatibilité obsolète pour la migration depuis cap-play-install-referrer.
  • Android renvoie la chaîne Play referrer, l'horodatage du clic, l'horodatage d'installation et le flag instant app.
  • iOS renvoie un token 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);

Notes de plateforme

Android utilise le service Google Play Install Referrer et nécessite une installation via le Play Store pour obtenir les données de referrer réelles. iOS utilise Apple AdServices car Apple ne propose pas d'équivalent générique pour le referrer d'installation de l'App Store.

Référence complète

Continuer avec l'utilisation de @capgo/capacitor-install-referrer

Si vous utilisez Utiliser @capgo/capacitor-install-referrer pour planifier le travail sur les plugins natifs, 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 Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.

FAQ

FAQ sur le 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 lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-install-referrer" dans le code de votre application.

Est-ce que @capgo/capacitor-install-referrer fonctionne avec React, Vue et Angular ?

Oui. Install Referrer est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-install-referrer ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense 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 à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

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

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Statistiques

Plugins associés

Parcourir tous les plugins →

Déployez les changements d'Install Referrer sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo