@capgo/capacitor-appsflyer

Übersicht

Füge deiner Capacitor App AppsFlyer Attribution, Analytics, Deferred Deep Links und OneLink-Support hinzu

Starte mit initSDK() und den anderen unten aufgeführten Core-Methoden.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	Nativ
Android	Ja	Nativ
Web	Nein	Absichern mit Capacitor.getPlatform()

Kernfunktionen

• initSDK - Nutze diese Methode, um AppsFlyer SDK zu initialisieren und zu starten. Dieser API sollte direkt nach dem App-Start aufgerufen werden.
• startSDK - Nutze diese Methode, um AppsFlyer SDK zu starten (nur im manuellen Startmodus).
• logEvent - Ein In-App-Event loggen.
• setCustomerUserId - Durch das Setzen einer eigenen Customer ID kannst du deine eindeutige ID mit der AppsFlyer-ID und den IDs anderer Geräte abgleichen. Diese ID ist in Raw-Data-Reports sowie in den Postback APIs für den Abgleich mit deinen internen IDs verfügbar.

Öffentliches API

Methode	Beschreibung
addListener('conversion_callback', listener)	Konvertierungs-Callbacks überwachen, einschließlich onConversionDataSuccess und onConversionDataFail, wobei OnConversionDataResult Payloads.
addListener('oaoa_callback', listener)	App-Open-Attribution-Callbacks überwachen, einschließlich onAppOpenAttribution und onAttributionFailure, wobei OnAppOpenAttribution Payloads.
addListener('udl_callback', listener)	Empfangen Sie einheitliche Deep-Link-Callbacks mit OnDeepLink Payloads.
initSDK	Nutzen Sie diese Methode, um AppsFlyer SDK zu initialisieren und zu starten. Dieser API sollte direkt nach dem App-Start aufgerufen werden.
startSDK	Nutze diese Methode, um AppsFlyer SDK zu starten, jedoch nur im manuellen Startmodus.
logEvent	Ein In-App-Event loggen.
setCustomerUserId	Durch das Setzen einer eigenen Customer ID können Sie Ihre eindeutige ID mit der AppsFlyer-ID und den IDs anderer Geräte abgleichen. Diese ID ist in Raw-Data-Reports sowie in den Postback APIs für den Abgleich mit Ihren internen IDs verfügbar.
setCurrencyCode	Legt die Währung für In-App-Käufe fest. Gib einen dreistelligen ISO 4217 code an.
updateServerUninstallToken	Übergeben Sie GCM/FCM-Tokens auf Android oder APNs-Tokens auf iOS, falls diese von einem anderen Plugin gesammelt wurden. Nutzen Sie dies, um Uninstall-Measurement-Tokens an AppsFlyer weiterzuleiten.
setAppInviteOneLink	Legt die OneLink-ID fest, die als Basis-Link für die Invite-Attribution dient.
setOneLinkCustomDomain	Registriert eigene OneLink-Domains, damit AppsFlyer Attributionsparameter in Short-Links auflösen kann.
appendParametersToDeepLinkingURL	Aktiviert die Attribution für App Links Deep Links ohne OneLink. Rufen Sie diese Methode vor startSDK(). Füge mindestens hinzu pid und is_retargeting=true in der Parameter-Map hinzu.
setResolveDeepLinkURLs	Verwende dies, wenn ein AppsFlyer OneLink in einen anderen Universal Link eingebettet ist. So kann SDK die verschachtelte URL auflösen, damit Deep Linking weiterhin korrekt funktioniert.
addPushNotificationDeepLinkPath	Konfiguriert, wie SDK Deep-Link-Werte aus Push-Notification-Payloads extrahiert.
setSharingFilter	Verhindert, dass Events an die angegebenen AppsFlyer-Partner weitergegeben werden.
setSharingFilterForAllPartners	Verhindert die Weitergabe von Events an alle AppsFlyer-Partner. Überschreibt setSharingFilter.
setSharingFilterForPartners	Verhindert, dass Events an die angegebenen AppsFlyer-Partner weitergegeben werden.
setAdditionalData	Setzt zusätzliche Key-Value-Daten, die an AppsFlyer gesendet werden.
getAppsFlyerUID	Ruft die eindeutige AppsFlyer Device ID ab (wird bei jeder neuen App-Installation erstellt).
anonymizeUser	Opt-Out für Endnutzer bei AppsFlyer Analytics (Anonymisierung der Nutzerdaten).
stop	Sobald dieses API aufgerufen wird, kommuniziert unser SDK nicht mehr mit unseren Servern und stellt die Funktion ein. Nützlich bei der Implementierung von User Opt-in/Opt-out.
disableSKAdNetwork	SKAdNetwork opt-out aktivieren.
disableAdvertisingIdentifier	Deaktiviert die Erfassung verschiedener Advertising IDs durch SDK. Dazu gehören Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID und Amazon Advertising ID (AAID).
disableCollectASA	Opt-out von Apple Search Ads Attributionen
setHost	Einen benutzerdefinierten Host festlegen.
generateInviteLink	Ermöglicht es Ihren bestehenden Nutzern, Freunde und Kontakte als neue Nutzer in Ihre App einzuladen.
validateAndLogInAppPurchaseAndroid	API zur Server-Verifizierung von In-App-Käufen. Bei erfolgreicher Validierung wird automatisch ein af_purchase-Event mit den entsprechenden Werten geloggt.
validateAndLogInAppPurchaseIos	Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
getSdkVersion	Gibt die in der App verwendete AppsFlyer SDK-Version zurück.
enableFacebookDeferredApplinks	Ermöglicht das Erfassen von Facebook Deferred AppLinks. Erfordert Facebook SDK und die Facebook-App auf dem Zielgerät. Um korrekt zu funktionieren, muss API vor der Initialisierung des AppsFlyer SDK aufgerufen werden.
sendPushNotificationData	Daten aus Push-Benachrichtigungskampagnen messen und abrufen.
setCurrentDeviceLanguage	Setzt die Sprache des Geräts. Die Daten werden in den Raw Data Reports angezeigt.
logCrossPromoteImpression	Loggt eine Impression im Rahmen einer Cross-Promotion-Kampagne. Verwende dabei unbedingt die App-ID der beworbenen App, so wie sie im AppsFlyer Dashboard angezeigt wird.
setUserEmails	User-E-Mails festlegen und verschlüsseln.
logLocation	Den Standort des Nutzers manuell loggen.
setPhoneNumber	Wird als SHA-256-verschlüsselter String gesendet.
setPartnerData	Ermöglicht das Senden benutzerdefinierter Daten für Partner-Integrationen.
logInvite	Nutze dies, um ein User-Invite In-App-Event (af_invite) zu loggen.
setDisableNetworkData	Nutze dies, um das Sammeln des Netzbetreibers (carrier) und des SIM-Betreibers vom Gerät zu deaktivieren.
enableTCFDataCollection	Nutze dies, um die automatische Erfassung von Consent-Daten für Nutzer mit einer CMP zu aktivieren/deaktivieren. Der Flag-Wert wird über App-Sessions hinweg gespeichert.
setConsentData	Nutze dies, um User-Consent-Daten manuell zu setzen. Wenn deine App keine TCF v2.2-kompatible CMP nutzt, verwende die folgende Methode, um die Consent-Daten direkt an SDK zu übergeben.
logAdRevenue	Durch die Attribuierung von Werbeeinnahmen erhalten App-Besitzer eine vollständige Übersicht über den User LTV und den Kampagnen-ROI. Werbeeinnahmen entstehen durch Anzeigen in Rewarded Videos, Offer Walls, Interstitials und Bannern. Nutze diese Methode, um deine Werbeeinnahmen zu loggen.
setConsentDataV2	Nutze dies, um User-Consent-Daten manuell zu setzen. Wenn deine App keine TCF v2.2-kompatible CMP nutzt, verwende die folgende Methode, um die Consent-Daten direkt an SDK zu übergeben.
isSDKStarted	Nutzen Sie diese Methode, um zu prüfen, ob das AppsFlyer SDK in der aktuellen Session bereits gestartet wurde.
isSDKStopped	Nutzen Sie diese Methode, um zu prüfen, ob das AppsFlyer SDK aktuell gestoppt ist.
disableAppSetId	Deaktiviert die Erfassung der AppSet ID. Wenn dies vor der Initialisierung von SDK aufgerufen wird, wird die AppSet ID nicht erfasst. Nach der Initialisierung wird sie zwar erfasst, aber nicht in den Request-Payloads gesendet. Nur für Android.
validateAndLogInAppPurchaseV2	API zur Server-Verifizierung von In-App-Käufen V2. Wenn die Validierung erfolgreich ist, wird automatisch ein af_purchase-Event mit den entsprechenden Werten geloggt.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-appsflyer.

Weiterlesen bei @capgo/capacitor-appsflyer

Wenn du es nutzt @capgo/capacitor-appsflyer Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/capacitor-appsflyer für die native Funktion in Verwendung von @capgo/capacitor-appsflyer, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.