Zum Hauptinhalt springen

Install Referrer-Plugin Capacitor Plugin

Google Play Install-Referrer-Daten und Apple AdServices-Attribution aus Capacitor auslesen

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

Install Referrer in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

Install Referrer Plugin Vorschau-QR code

@capgo/capacitor-install-referrer verwenden

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

Nutze es, wenn du Google Play Install Referrer-Daten auf Android und Apple AdServices Attribution-Token auf iOS über ein einziges API benötigst.

Installieren

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

Was dieses Plugin bereitstellt

  • getReferrer gibt Details zur Install-Attribution für Android oder iOS zurück.
  • GetReferrer ist ein veralteter Kompatibilitäts-Alias für die Migration von cap-play-install-referrer.
  • Android liefert den Play Referrer String, den Klick-Zeitstempel, den Installations-Zeitstempel und das Instant App Flag zurück.
  • iOS liefert einen AdServices Attribution Token zurück und kann optional das Apple Attribution Payload abrufen.

Anwendungsbeispiel

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 Attribution Payload

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

console.log(result.appleAttribution);

Plattform-Hinweise

Android nutzt den Google Play Install Referrer Service und benötigt eine Play Store Installation für echte Referrer-Daten. iOS nutzt Apple AdServices, da Apple keinen generischen Ersatz für einen App Store Install Referrer anbietet.

Vollständige Referenz

Weiter geht's mit @capgo/capacitor-install-referrer

Wenn du es nutzt @capgo/capacitor-install-referrer verwenden Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-install-referrer für die Implementierungsdetails in @capgo/capacitor-install-referrer, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im 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

FAQ zum Install Referrer Plugin

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

Führe "bun add @capgo/capacitor-install-referrer" (oder "npm install @capgo/capacitor-install-referrer") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-install-referrer".

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

Ja. Install Referrer ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

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

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

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

Ja. Der code Source Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-install-referrer/ verfügbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Install Referrer ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Install-Referrer-Änderungen ausrollen, ohne auf App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo