Einstieg
Eine Einrichtungshinweis mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation 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-appsflyer`
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/appsflyer/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
Abschnitt: "Installieren"Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten Ihrem AI-Tool hinzu, indem Sie den folgenden Befehl verwenden:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsVerwenden Sie dann den folgenden Prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-appsflyer` 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-appsflyerbunx cap syncImportieren
Abschnitt: "Importieren"import { AppsFlyer } from '@capgo/capacitor-appsflyer';import type { AFAdRevenueData, AFAndroidInAppPurchase, AFAnonymizeUser, AFAppendToDeepLink, AFConsentData, AFConsentOptions, AFCuid, AFCurrency, AFData, AFDisable, AFEmails, AFEnableTCFDataCollection, AFEvent, AFFbDAL, AFFilters, AFHost, AFInit, AFIosInAppPurchase, AFLanguage, AFLatLng, AFLinkGenerator, AFLogInvite, AFOnelinkDomain, AFOnelinkID, AFPartnerData, AFPath, AFPhone, AFPromotion, AFPurchaseDetailsV2, AFPushPayload, AFUninstall, AFUrls,} from '@capgo/capacitor-appsflyer';API Übersicht
Überschrift „API Übersicht“initSDK
Überschrift „initSDK“Verwenden Sie diese Methode, um AppsFlyer SDK zu initialisieren und zu starten. Diese API sollte so schnell wie möglich nach dem App-Start aufgerufen werden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);startSDK
Überschrift „startSDK“Verwenden Sie diese Methode, um AppsFlyer SDK nur im manuellen Startmodus zu starten.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();logEvent
Überschrift „logEvent“Ein in-App-Ereignis protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Abschnitt mit dem Titel ‘setCustomerUserId’Die Festlegung Ihres eigenen Kunden-IDs ermöglicht Ihnen, Ihre eigene eindeutige ID mit der eindeutigen ID von AppsFlyer und den IDs anderer Geräte zu vergleichen. Diese ID ist in den Rohdatenberichten und in den Postback-APIs für die Vergleichbarkeit mit Ihren internen IDs verfügbar.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({} as AFCuid);setCurrencyCode
Abschnitt mit dem Titel ‘setCurrencyCode’Legt die für In-App-Käufe verwendete Währung fest. Geben Sie eine dreibuchstabige ISO 4217 code an.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
Abschnitt mit dem Titel ‘updateServerUninstallToken’Übermitteln Sie GCM/FCM-Tokens auf Android oder APNs-Tokens auf iOS, wenn ein anderer Plugin sie gesammelt hat. Verwenden Sie diese Funktion, um die Entfernungsmessungstoken an AppsFlyer weiterzuleiten.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Abschnitt mit dem Titel ‘setAppInviteOneLink’Legt die OneLink-ID fest, die als Basis-Link für die Einladungsattribuierung verwendet wird.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
Abschnitt mit dem Titel ‘setOneLinkCustomDomain’Registriert benannte OneLink-Domains, damit AppsFlyer die in kurzen Links versteckten Attribution-Parameter auflösen kann.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Abschnitt mit dem Titel ‘appendParametersToDeepLinkingURL’Aktiviert die Attribution für App-Links-Deep-Links ohne OneLink. Rufen Sie diese Methode vorher auf startSDK().
Inkludieren Sie zumindest pid und is_retargeting=true context
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);Use this when an AppsFlyer OneLink is wrapped inside another Universal Link. It lets the SDK resolve the wrapped URL so deep linking still works correctly.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Abschnitt mit dem Titel “addPushNotificationDeepLinkPath”Konfiguriert, wie SDK Werte aus den Push-Benachrichtigungs-Beiträgen extrahiert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Abschnitt mit dem Titel “setSharingFilter”Unterdrückt Ereignisse, die an die angegebenen AppsFlyer-Partner weitergeleitet werden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Abschnitt mit dem Titel “setSharingFilterForAllPartners”Unterdrückt Ereignisse, die an alle AppsFlyer-Partner weitergeleitet werden. Überschreibt setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Abschnitt mit dem Titel “setSharingFilterForPartners”Unterdrückt Ereignisse, die an die angegebenen AppsFlyer-Partner weitergeleitet werden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Abschnitt mit dem Titel “setAdditionalData”Setzt zusätzliche Schlüssel-Wert-Daten, die an AppsFlyer gesendet werden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
Abschnitt mit dem Titel “getAppsFlyerUID”Ermitteln Sie die eindeutige Gerätekennung von AppsFlyer (erstellt für jeden neuen Installationsvorgang einer App).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
Abschnitt mit dem Titel “anonymizeUser”Endbenutzer-Opt-Out von AppsFlyer-Analysen (Anonymisierung von Benutzerdaten).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);Wenn dieser API aufgerufen wird, unterbricht unsere SDK die Kommunikation mit unseren Servern und funktioniert nicht mehr. Verwenden Sie ihn zum Implementieren von Benutzer-Opt-in/Opt-out.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Abschnitt mit dem Titel “disableSKAdNetwork”SKAdNetwork-Auswahl
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Abschnitt mit dem Titel “disableAdvertisingIdentifier”Die Sammlung verschiedener Werbe-IDs durch SDK wird deaktiviert. Dazu gehören Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID und Amazon Advertising ID (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
Abschnitt mit dem Titel “disableCollectASA”Die Apple Search Ads-Zuschreibungen werden deaktiviert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);Einen benutzerdefinierten Host festlegen.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Abschnitt mit dem Titel “generateInviteLink”Ermöglichen Sie Ihren bestehenden Benutzern, ihre Freunde und Kontakte als neue Benutzer zu Ihrer App einzuladen
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Abschnitt mit dem Titel “validateAndLogInAppPurchaseAndroid”API für die Server-Überprüfung von In-App-Käufen. Ein af_purchase-Ereignis mit den relevanten Werten wird automatisch protokolliert, wenn die Überprüfung erfolgreich ist.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
Abschnitt mit dem Titel “validateAndLogInAppPurchaseIos”Siehe die Quelldefinitionen für den aktuellen Vertrag.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
Abschnitt mit dem Titel “getSdkVersion”Ermitteln Sie die AppsFlyer SDK-Version, die in der App verwendet wird.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Abschnitt mit dem Titel ‘enableFacebookDeferredApplinks’Enable the collection of Facebook Deferred AppLinks. Requires Facebook SDK and Facebook app on target/client device. This API must be invoked before initializing the AppsFlyer SDK in order to function properly.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
ZwischenablageAbschnitt mit dem Titel ‘sendPushNotificationData’
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
ZwischenablageAbschnitt mit dem Titel ‘setCurrentDeviceLanguage’
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
ZwischenablageAbschnitt mit dem Titel ‘logCrossPromoteImpression’
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);setUserEmails
Abschnitt mit dem Titel “setUserEmails”Setzen Sie die Benutzer-E-Mail-Adressen und verschlüsseln Sie sie.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
Abschnitt mit dem Titel “logLocation”Der Standort des Benutzers manuell protokollieren
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
Abschnitt mit dem Titel “setPhoneNumber”Wird als SHA-256-verschlüsselter String gesendet.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
Abschnitt mit dem Titel “setPartnerData”Ermöglicht das Senden von benutzerdefinierten Daten für Partner-Integration-Zwecke.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Abschnitt mit dem Titel “logInvite”Verwenden Sie dies, um eine Benutzer-Einladungs-In-App-Ereignis (af_invite) zu protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Abschnitt mit dem Titel “setDisableNetworkData”Verwenden Sie dies, um das Sammeln der Netzwerk-Operator-Name (Carrier) und SIM-Operator-Name vom Gerät auszuschließen.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Abschnitt mit dem Titel “enableTCFDataCollection”Verwenden Sie dies, um die automatische Sammlung von Zustimmungsdaten für Benutzer zu aktivieren/zu deaktivieren, die ein CMP verwenden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
Auf die Zwischenablage kopierenUse this to set user consent data manually. If your app doesn’t use a CMP compatible with TCF v2.2, use the following method to manually provide the consent data directly to the SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);logAdRevenue
Abschnitt mit dem Titel “logAdRevenue”Durch die Zuweisung von Werbeeinnahmen erhalten App-Besitzer einen umfassenden Überblick über die LTV der Benutzer und die ROI der Kampagnen. Die Werbeeinnahmen werden durch die Anzeige von Werbung in belohnten Videos, Angebotswänden, Interstitiellen und Bannern in einer App generiert. Sie können diese Methode verwenden, um Ihre Werbeeinnahmen zu protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Abschnitt mit dem Titel “setConsentDataV2”Verwenden Sie diese Funktion, um die Benutzerwilligungsinformationen manuell zu setzen. Wenn Ihre App kein CMP verwendet, das mit TCF v2.2 kompatibel ist, verwenden Sie die folgende Methode, um die Benutzerwilligungsinformationen direkt an die SDK zu liefern.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({} as AFConsentOptions);isSDKStarted
Abschnitt mit dem Titel “isSDKStarted”Verwenden Sie diese Methode, um zu überprüfen, ob die AppsFlyer SDK bereits in der aktuellen Sitzung gestartet wurde.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
Abschnitt mit dem Titel “isSDKStopped”Verwenden Sie diese Methode, um zu überprüfen, ob die AppsFlyer SDK derzeit angehalten ist.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
Abschnitt mit dem Titel ‘disableAppSetId’Deaktiviert die Sammlung von AppSet-IDs. Wenn dieser Aufruf vor der SDK-Initialisierung erfolgt, werden keine App-Set-IDs gesammelt. Wenn dieser Aufruf nach der Initialisierung erfolgt, werden App-Set-IDs gesammelt, aber nicht in den Anforderungspaketen gesendet. Nur für Android.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
Abschnitt mit dem Titel ‘validateAndLogInAppPurchaseV2’API für die Serververifizierung von In-App-Käufen V2. Wenn die Validierung erfolgreich ist, wird automatisch ein af_purchase-Ereignis mit den relevanten Werten protokolliert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);Quelle der Wahrheit
Abschnitt mit dem Titel ‘Quelle der Wahrheit’Diese Seite wurde aus dem Plugin generiert. Wenn sich die öffentliche __CAPGO_KEEP_0__-Version im Hintergrund ändert, sollte die Synchronisierung erneut durchgeführt werden. src/definitions.ts. Re-run the sync when the public API changes upstream.
Abschnitt mit dem Titel ‘Fortsetzung von Getting Started’
Abschnitt mit dem Titel ‘disableAppSetId’Wenn Sie Einstieg um das Dashboard und die API-Funktionen zu planen, verbinden Sie es mit Mit @capgo/capacitor-appsflyer für die native Fähigkeit in Mit @capgo/capacitor-appsflyer, API-Übersicht für die Implementierungsdetails in API-Übersicht, Einführung für die Implementierungsdetails in Einführung, API-Schlüssel für die Implementierungsdetails in API-Schlüssel, und Geräte für die Implementierungsdetails in Geräten.