Passer au contenu principal
Retour aux plugins
@capgo/capacitor-install-referrer
Tutoriel
par github.com/Cap-go

Install Referrer

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

Guide

Tutoriel sur Install Referrer

Utiliser @capgo/capacitor-install-referrer

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

Utilisez-le lorsque vous avez besoin des données d'installation du référentiel Google Play sur Android et des jetons d'attribution Apple AdServices sur iOS à travers un seul API.

Installation

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

Ce Qu'Exposent Ce Plugin

  • getReferrer renvoie les détails d'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 de référentiel Play, le timestamp du clic, le timestamp d'installation et le drapeau d'instant app.
  • iOS renvoie un jeton d'attribution AdServices d'Apple 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 Plates-formes

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 générique du Magasin d'App.

Référence complète