Démarrage

Installer

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

Importer

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

Lire les détails de l'attribution

const result = await InstallReferrer.getReferrer();

if (result.platform === 'android') {
  console.log('Install referrer:', result.referrer);
  console.log('Click timestamp:', result.clickTimestampSeconds);
  console.log('Install timestamp:', result.installBeginTimestampSeconds);
}

if (result.platform === 'ios') {
  console.log('AdServices token:', result.attributionToken);
}

Récupérer l'attribution d'Apple sur iOS

If you want native code to call Apple’s attribution endpoint, pass fetchAppleAttribution.

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

// result.appleAttribution is the parsed Apple attribution response.
// See the iOS attribution page for the Apple-provided payload fields.
console.log(result.appleAttribution);

pendant que les données d'attribution sont encore en cours de préparation pour un jeton valide. Les options de réessai contrôlent combien de fois le plugin natif réessaye avant de rejeter. Voir 404 l'attribution sur iOS Si vous souhaitez que le natif __CAPGO_KEEP_0__ appelle l'endpoint d'attribution d'Apple, passez les options de configuration appropriées pour le plugin natif. pour les détails de la plateforme.

Alias de compatibilité

GetReferrer() est disponible pour les applications en cours de migration depuis cap-play-install-referrer.

const result = await InstallReferrer.GetReferrer();

Les nouvelles code devraient utiliser getReferrer().