Einstieg

GitHub

Einen Setup-Vorschlag mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin kopieren.

        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.

Installieren

Sie können unser AI-gestütztes Setup verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer AI-Anwendung mit folgendem Befehl hinzu:

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

Dann verwenden Sie folgenden Prompt:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten angegebenen plattform-spezifischen Anweisungen befolgen:

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

Importieren

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

Attributionsdetails lesen

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

Attributionsdaten von Apple auf iOS abrufen

Wenn Sie native code aufrufen möchten, um die Apple-Attributions-Endpunkt aufzurufen, übergeben Sie 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 kann zurückgeben 404 solange die Attributionsdaten noch vorbereitet werden, bevor ein gültiger Token vorliegt. Die Wiederholungsoptionen steuern, wie oft der native Plugin wiederholt, bevor er abgelehnt wird. Siehe iOS-Attribution für Details zur Plattform.

KompatibilitätsAlias

GetReferrer() ist für Apps verfügbar, die von cap-play-install-referrer.

const result = await InstallReferrer.GetReferrer();

Neue code sollten verwendet werden getReferrer().

Fortschrittlich von Getting Started

Wenn Sie Getting Started verwenden Getting Started um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-install-referrer Verbinden Sie @capgo/capacitor-install-referrer mit dem native Capability in Verwenden Sie @capgo/capacitor-install-referrer Capgo Plugin-Verzeichnis Verbinden Sie Capgo Plugin-Verzeichnis mit dem Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo Verbinden Sie Capacitor Plugins von Capgo mit der Implementierungsdetail in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.