Getting Started

Copia una riga di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-install-referrer`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/install-referrer/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installa

Potresti utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Usa poi la seguente riga di comando:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-install-referrer` plugin in my project.

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

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

Importa

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

Leggi i dettagli dell'attribuzione

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);
}

Esegui Apple Attribution On iOS

Se desideri che il nativo code chiami l'endpoint di attribuzione di Apple, passa 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);

Apple può restituire 404 mentre i dati di attribuzione sono ancora in preparazione per un token valido. Le opzioni di ritentativo controllano quante volte il plugin nativo ritenta prima di rifiutare. Vedi attribuzione iOS per dettagli sulla piattaforma.

Sottosezione intitolata “Compatibilità Alias”

GetReferrer() è disponibile per le app che migrano da cap-play-install-referrer.

const result = await InstallReferrer.GetReferrer();

Il nuovo code dovrebbe utilizzare getReferrer().

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativo, connettilo con Utilizzando @capgo/capacitor-install-referrer per la capacità nativa in Utilizzando @capgo/capacitor-install-referrer Capgo Directory dei plugin per il workflow del prodotto nella Capgo Directory dei Plugin Capacitor Plugin di Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o aggiornare i plugin, e Alternative plugin per Ionic Enterprise per il workflow del prodotto in Alternative plugin per Ionic Enterprise.