Getting Started
Ein Setup-Vorschlag kopieren, der die Installationsanweisungen und die vollständige Markdown-Anleitung für diesen Plugin enthält.
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.
Install
Installbun add @capgo/capacitor-appsflyerbunx cap syncImport
Importimport { 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
API ÜbersichtinitSDK
__CAPGO_KEEP_0__ initSDKVerwenden Sie diese Methode, um AppsFlyer SDK zu initialisieren und zu starten. Diese API sollte alsbald nach dem App-Start 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();Ein Ereignis im App-Verlauf protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Abschnitt mit dem Titel ‘setCustomerUserId’Durch die Festlegung Ihres eigenen Kunden-IDs können Sie Ihre eigenen eindeutigen IDs mit den eindeutigen IDs von AppsFlyer und den IDs anderer Geräte abgleichen. Diese ID ist in den Rohdatenberichten und in den Postback-APIs für den Abgleich 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’Ü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 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’Aktiviere die Attribution für App-Links-Deep-Links ohne OneLink. Rufe diese Methode vorher startSDK()Zumindest pid und is_retargeting=true im Parametermap.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Abschnitt mit dem Titel „setResolveDeepLinkURLs“Verwenden Sie dies, wenn ein AppsFlyer OneLink innerhalb eines anderen Universal Links eingeschlossen ist. Es ermöglicht es der SDK , die eingeschlossene URL so tief zu linken, dass die Tiefenlinkfunktion korrekt funktioniert.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Abschnitt mit dem Titel „addPushNotificationDeepLinkPath“Konfiguriert, wie die SDK Tiefenlinkwerte aus Push-Benachrichtigungs-Beuteln 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“Verhindert die Weitergabe von Ereignissen an alle AppsFlyer-Partner. Überschreibt setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Abschnitt mit dem Titel „setSharingFilterForPartners“Verhindert die Weitergabe von Ereignissen an die angegebenen AppsFlyer-Partner.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Abschnitt mit dem Titel „setAdditionalData“Setzt zusätzliche Schlüssel-Wert-Daten zum Senden an AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
Abschnitt mit dem Titel „getAppsFlyerUID“Holt 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, funktioniert unsere SDK nicht mehr mit unseren Servern und hört auf zu funktionieren. Zu empfehlen, wenn Sie Benutzer-Opt-in/Opt-out implementieren.
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 den 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“Zustimmung zur Apple Search Ads-Zuschreibung ablehnen.
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, ihren Freunden und Kontakten als neue Benutzer zu Ihrer 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’Holen Sie sich 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’Aktivieren Sie die Sammlung von Facebook Deferred AppLinks. Erfordert Facebook SDK und Facebook-App auf Ziel-/Klienten-Device. Diese API muss vor der Initialisierung der AppsFlyer SDK aufgerufen werden, um richtig zu funktionieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
Abschnitt mit dem Titel ‘sendPushNotificationData’Messung und Datenabruf aus Push-Benachrichtigungs-Kampagnen.
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 Raw Data Reports 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 erscheint.
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ückgegeben wird die Möglichkeit, benutzerdefinierte Daten für die Partnerintegration bereitzustellen.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Abschnitt mit dem Titel ‘logInvite’Wird verwendet, um eine Benutzer-Einladungs-App-Event (af_invite) zu protokollieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Abschnitt mit dem Titel ‘setDisableNetworkData’Wird verwendet, um die Sammlung des Netzwerk-Netzbetreiber-Namens (Carrier) und des SIM-Netzbetreiber-Namens vom Gerät zu deaktivieren.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Abschnitt mit dem Titel ‘enableTCFDataCollection’Verwenden Sie diese Funktion, 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
Abschnitt mit dem Titel ‘setConsentData’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.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 von Kampagnen.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Kopieren Sie in die 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.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’App-Set-ID-Kollektion deaktivieren. Wenn diese Methode vor der SDK-Initialisierung aufgerufen wird, wird die App-Set-ID nicht gesammelt. Wenn diese Methode nach der Initialisierung aufgerufen wird, wird die App-Set-ID 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 Server-Verifizierung 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 sich upstream ändert.
Weitermachen von Getting Started
Abschnitt mit dem Titel „Weitermachen von Getting Started”Wenn Sie das verwenden Getting Started um das Dashboard und die API-Operationen 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äte.