Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-install-referrer
Tutoriel
@capgo/capacitor-install-referrer

Install Referrer

Lire les données de référence d'installation de Google Play et d'attribution d'Apple AdServices à partir de Capacitor

Guide

Tutoriel sur l'installation du référentiel

Tester sur appareil

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

Install Referrer 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 des données d'installation de Google Play Referrer sur Android et des jetons de tokens d'attribution Apple AdServices sur iOS à travers un seul API.

Installer

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

Ce que ce plugin expose

  • getReferrer retourne les détails d'attribution d'installation pour Android ou iOS.
  • GetReferrer s'est avéré être un alias de compatibilité obsolète 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 de 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 d'Apple

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

console.log(result.appleAttribution);

Remarques sur la plateforme

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 Apple AdServices car Apple ne fournit pas un équivalent de référentiel d'installation de Magasin App générique.

Référence complète

Continuez de la section Utilisation de @capgo/capacitor-install-referrer

Si vous utilisez Utilisation de @capgo/capacitor-install-referrer pour planifier le travail de plugin natif, connectez-l’avec @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 plugins Capgo pour le flux de travail du produit dans Répertoire de plugins 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.