Salta al contenuto principale

Installazione Referrer Plugin Capacitor

Leggi i dati di install referrer di Google Play e l'attribuzione Apple AdServices da Capacitor

Installa

bun add @capgo/capacitor-install-referrer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-install-referrer
  • pnpm add @capgo/capacitor-install-referrer
  • yarn add @capgo/capacitor-install-referrer

Guida

Come usare Install Referrer in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima QR del plugin Install Referrer code

Utilizzo di @capgo/capacitor-install-referrer

@capgo/capacitor-install-referrer legge i segnali di attribuzione dell'installazione nelle app Capacitor.

Usalo quando hai bisogno dei dati Google Play Install Referrer su Android e dei token di attribuzione Apple AdServices su iOS tramite un unico API.

Installa

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

Cosa espone questo plugin

  • getReferrer restituisce i dettagli di attribuzione dell'installazione per Android o iOS.
  • GetReferrer è un alias di compatibilità deprecato per la migrazione da cap-play-install-referrer.
  • Android restituisce la stringa Play referrer, il timestamp del click, il timestamp di installazione e il flag dell'instant app.
  • iOS restituisce un token di attribuzione AdServices e può facoltativamente recuperare il payload di attribuzione di Apple.

Esempio d'uso

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 di attribuzione Apple

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

console.log(result.appleAttribution);

Note sulla piattaforma

Android utilizza il servizio Google Play Install Referrer e richiede un'installazione tramite Play Store per ottenere dati referrer reali. iOS utilizza Apple AdServices poiché Apple non fornisce un equivalente generico del referrer di installazione dell'App Store.

Riferimento completo

Continua da Using @capgo/capacitor-install-referrer

Se stai usando Utilizzo di @capgo/capacitor-install-referrer per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-install-referrer per i dettagli di implementazione in @capgo/capacitor-install-referrer, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin Install Referrer

Come installo il plugin Install Referrer in un'app Capacitor?

Esegui "bun add @capgo/capacitor-install-referrer" (o "npm install @capgo/capacitor-install-referrer"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-install-referrer" nel code della tua app.

@capgo/capacitor-install-referrer funziona con React, Vue e Angular?

Sì. Install Referrer è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-install-referrer?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-install-referrer è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-install-referrer/ e il pacchetto è gratuito su npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Install Referrer senza la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche all'Install Referrer senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo