Hauptinhalt überspringen

Install-Referrer-Plugin Capacitor-Plugin

Lesen Sie Daten zum Google Play-Install-Referrer und Apple AdServices-Attribution aus Capacitor

Installieren

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

Anleitung

So verwendest du Install Referrer in Capacitor

Auf Gerät testen

Lade die Capgo-App herunter, dann scane den QR-Code code.

Install Referrer Plugin-Vorschau QR code

Verwenden Sie @capgo/capacitor-install-referrer

@capgo/capacitor-install-referrer liest Install-Attributionszeichen in Capacitor-Apps.

Benutzen Sie es, wenn Sie Google Play Install Referrer-Daten auf Android und Apple AdServices-Zuordnungs-Token auf iOS benötigen, über ein API.

Installieren

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

Was diese Plugin-Exposition enthält

  • getReferrer Rückgabewert für Install-Attributionsdetails für Android oder iOS.
  • GetReferrer ist ein veralteter Kompatibilitätsalias für die Migration von cap-play-install-referrer.
  • Android gibt die Play-Bezugszeichenfolge, den Klickzeitstempel, den Installationszeitstempel und die Instant-App-Flagge zurück.
  • iOS gibt ein AdServices-Attributions-Token zurück und kann optional Apples Attribution-Payload abrufen.

Beispielanwendung

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

Apple-Attributions-Payload

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

console.log(result.appleAttribution);

Plattformhinweise

Android verwendet die Google Play Install Referrer-Dienst und erfordert eine Play Store-Installation für echte Referrer-Daten. iOS verwendet Apple AdServices, da Apple kein generisches App Store-Install-Referrer-Äquivalent bereitstellt.

Vollständige Referenz

Fahren Sie mit der Verwendung von @capgo/capacitor-install-referrer fort.

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-install-referrer verwenden Verwendung von @capgo/capacitor-install-referrer für die Planung von native Plugin-Arbeiten, verbinden Sie es mit @capgo/capacitor-install-referrer für die Implementierungsdetails in @capgo/capacitor-install-referrer Getting Started für die Implementierungsdetails in Einstieg Capgo Plugin-Verzeichnis für die Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

Installationsreferenz-Plugin FAQ

Wie installiere ich das Install Referrer-Plugin in einer Capacitor-App?

Run "bun add @capgo/capacitor-install-referrer" (or "npm install @capgo/capacitor-install-referrer"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-install-referrer" in your app code.

Funktioniert @capgo/capacitor-install-referrer mit React, Vue und Angular?

Ja. Install Referrer ist ein Capacitor-Paket, also funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-install-referrer?

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie die Plugin-Major-Version, die Ihrem Capacitor-Major-Version entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README enthält die unterstützten Versionen.

Ist @capgo/capacitor-install-referrer kostenlos und Open-Source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-install-referrer/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Kann ich code aktualisieren, das Install Referrer verwendet, ohne eine App-Store-Bewertung?

Das Installieren oder Upgraden des Plugins ändert die native code, daher ist eine neue App-Store-Bewertung erforderlich. Nachdem Sie dies getan haben, können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates bereitgestellt werden.

Install Referrer ohne Wartezeit auf die App-Überprüfung versenden

Sobald das Plugin in Ihrem Store-Builder integriert ist, Capgo live Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Starten Sie mit Capgo