Einstieg
Kopieren Sie eine Einrichtungsanweisung mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin.
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: Installierenbun add @capgo/capacitor-appsflyerbunx cap syncImportieren
Abschnitt: Importierenimport { 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
Abschnitt: API ÜbersichtinitSDK
Abschnitt: initSDKRufen Sie diese Methode auf, um AppsFlyer SDK zu initialisieren und zu starten. Diese API sollte so schnell wie möglich nach dem Start des Apps aufgerufen werden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);Verwenden Sie diese Methode, um AppsFlyer SDK nur in der manuellen Startmodus zu starten.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();Ereignisse in der App protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Abschnitt mit dem Titel ‘setCustomerUserId’Mit der eigenen Kunden-ID können Sie Ihre eigene eindeutige ID mit der eindeutigen ID von AppsFlyer und den IDs anderer Geräte 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 ein.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
Abschnitt mit dem Titel “updateServerUninstallToken”Übertrage GCM/FCM-Tokens auf Android oder APNs-Tokens auf iOS, wenn ein anderes Plugin sie gesammelt hat. Verwende dies, um Entfernungsmessungstoken an AppsFlyer weiterzuleiten.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Abschnitt mit dem Titel “setAppInviteOneLink”Setze die OneLink-ID, die als Basis-Link für Einladungsattribuierung verwendet wird.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
Abschnitt mit dem Titel “setOneLinkCustomDomain”Registriere benutzerdefinierte OneLink-Domains, damit AppsFlyer die in kurzen Links versteckten Attribuierungsparameter auflösen kann.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Abschnitt mit dem Titel “appendParametersToDeepLinkingURL”Aktiviere die Attribution für App-Links-Deep-Links ohne OneLink. Rufe diese Methode vorher startSDK()auf. pid und is_retargeting=true in der Parameterkarte.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Abschnitt mit dem Titel „setResolveDeepLinkURLs“Verwenden Sie dies, wenn eine AppsFlyer OneLink innerhalb einer anderen Universal Link eingeschlossen ist. Es ermöglicht es der SDK , die eingeschlossene URL so tief zu verlinken, dass die Verlinkung noch richtig funktioniert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Abschnitt mit dem Titel „addPushNotificationDeepLinkPath“Konfiguriert, wie die SDK Werte aus den Push-Benachrichtigungen extrahiert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Abschnitt mit dem Titel „setSharingFilter“Unterbindet die Weitergabe von Ereignissen an die angegebenen AppsFlyer-Partner.
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”Ermittelt die einzigartige 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);Sobald dieser API aufgerufen wird, kommuniziert unsere SDK nicht mehr mit unseren Servern und funktioniert nicht mehr. Zu empfehlen, wenn Sie die Implementierung von Benutzer-Opt-in/Opt-out durchführen.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Abschnitt mit dem Titel “disableSKAdNetwork”Opt-out von SKAdNetwork
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Abschnitt mit dem Titel “disableAdvertisingIdentifier”Deaktiviert die Sammlung verschiedener Werbe-IDs durch die SDK. 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“Opt-out von Attributen für Apple Search Ads.
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
Ermöglichen Sie Ihren bestehenden Benutzern, ihre Freunde und Kontakte als neue Benutzer zu Ihrem App einzuladen.Auf die Zwischenablage kopieren
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
__CAPGO_KEEP_0__ 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.API for server verification of in-app purchases. An af_purchase event with the relevant values will be automatically logged if the validation is successful.
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
Auf die Zwischenablage kopierenAbschnitt mit dem Titel “sendPushNotificationData”
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Abschnitt mit dem Titel ‘setCurrentDeviceLanguage’Die Sprache der Geräte einstellen. Die Daten werden in den Rohdatenberichten angezeigt
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
Abschnitt mit dem Titel ‘logCrossPromoteImpression’Ein Eindruck als Teil einer Kreuzwerbungs-Kampagne protokolliert. Stellen Sie sicher, dass Sie die ID der beworbenen App verwenden, wie sie in der AppsFlyer-Dashboard angezeigt wird
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);setUserEmails
Abschnitt mit dem Titel ‘setUserEmails’Die Benutzer-E-Mail-Adressen setzen und sie verschlüsseln
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
Abschnitt mit dem Titel ‘logLocation’Die Standortdaten des Benutzers manuell protokollieren
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
Abschnitt mit dem Titel “setPhoneNumber”Als SHA-256-geschützter String gesendet.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
Abschnitt mit dem Titel “setPartnerData”Zurücklieferung von benutzerdefinierten Daten für die Partnerintegration.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Abschnitt mit dem Titel “logInvite”Zur Protokollierung eines Benutzer-Invites (af_invite) verwenden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Abschnitt mit dem Titel “setDisableNetworkData”Zur Deaktivierung der Erfassung des Netzwerk-Netzbetreiber- und SIM-Netzbetreiber-Namens vom Gerät verwenden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Abschnitt mit dem Titel ‘enableTCFDataCollection’Verwenden Sie dies, um sich für/aus die automatische Erfassung von Zustimmungsdaten anzumelden, für Benutzer, die ein CMP verwenden.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
ZwischenablageUse 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);Zwischenablage
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Indem Sie Werbeeinnahmen zuordnen, erhalten App-Besitzer einen umfassenden Überblick über die LTV der Benutzer und die ROI der Kampagnen.Use 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.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”Die Sammlung von AppSet-IDs deaktiviert. Wenn diese Methode vor der SDK-Initialisierung aufgerufen wird, werden keine App-Set-IDs gesammelt. Wenn diese Methode nach der Initialisierung aufgerufen wird, werden App-Set-IDs gesammelt, aber nicht in Anforderungspayloads gesendet. (Android nur)
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 ein af_purchase-Ereignis mit den relevanten Werten automatisch protokolliert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);Quelle der Wahrheit
Abschnitt mit dem Titel „Quelle der Wahrheit“Diese Seite wird aus dem Plugin generiert. src/definitions.tsRe-run die Synchronisation, wenn die öffentliche API upstream geändert wird.