@capgo/capacitor-appsflyer

Panoramica

Aggiungi supporto per attribution, analytics, deferred deep link e OneLink alla tua app Capacitor

Inizia con initSDK() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Funzionalità principali

• initSDK - Usa questo metodo per inizializzare e avviare SDK di AppsFlyer. Questo API va chiamato non appena l'app viene avviata.
• startSDK - Usa questo metodo per avviare SDK di AppsFlyer, solo in modalità avvio manuale.
• logEvent - Logga un evento in-app.
• setCustomerUserId - Impostando il tuo customer ID, puoi incrociare il tuo ID univoco con quello di AppsFlyer e con gli ID di altri dispositivi. Questo ID è disponibile nei report raw-data e nelle Postback API per il cross-referencing con i tuoi ID interni.

Pubblico API

Metodo	Descrizione
addListener('conversion_callback', listener)	Ascolta i callback di conversione, tra cui onConversionDataSuccess e onConversionDataFail, con OnConversionDataResult payload.
addListener('oaoa_callback', listener)	Ascolta i callback di attribuzione app-open, tra cui onAppOpenAttribution e onAttributionFailure, con OnAppOpenAttribution payload.
addListener('udl_callback', listener)	Ascolta i callback unificati dei deep link con OnDeepLink payload.
initSDK	Usa questo metodo per inizializzare e avviare SDK di AppsFlyer. Questo API deve essere chiamato non appena l'app viene avviata.
startSDK	Usa questo metodo per avviare SDK di AppsFlyer, solo in modalità manual start.
logEvent	Registra un evento in-app.
setCustomerUserId	Impostare il proprio customer ID permette di incrociare il proprio ID univoco con l'ID univoco di AppsFlyer e con gli ID di altri dispositivi. Questo ID è disponibile nei report raw-data e nelle Postback API per il cross-referencing con i tuoi ID interni.
setCurrencyCode	Imposta la valuta usata per gli acquisti in-app. Fornisci un code ISO 4217 di tre caratteri.
updateServerUninstallToken	Passa i token GCM/FCM su Android o i token APNs su iOS quando raccolti da un altro plugin. Usalo per inoltrare i token di misurazione della disinstallazione ad AppsFlyer.
setAppInviteOneLink	Imposta l'ID OneLink usato come link base per l'attribuzione degli inviti.
setOneLinkCustomDomain	Registra i domini OneLink branded in modo che AppsFlyer possa risolvere i parametri di attribuzione nascosti nei link brevi.
appendParametersToDeepLinkingURL	Abilita l'attribuzione per i deep link App Links senza OneLink. Chiama questo metodo prima startSDK(). Includi almeno pid e is_retargeting=true nella mappa dei parametri.
setResolveDeepLinkURLs	Usa questa opzione quando un AppsFlyer OneLink è racchiuso in un altro Universal Link. Permette a SDK di risolvere l'URL annidato, garantendo il corretto funzionamento del deep linking.
addPushNotificationDeepLinkPath	Configura il modo in cui SDK estrae i valori del deep link dai payload delle notifiche push.
setSharingFilter	Impedisce la propagazione degli eventi verso i partner AppsFlyer specificati.
setSharingFilterForAllPartners	Impedisce la propagazione degli eventi verso tutti i partner AppsFlyer. Sovrascrive setSharingFilter.
setSharingFilterForPartners	Impedisce la propagazione degli eventi verso i partner AppsFlyer specificati.
setAdditionalData	Imposta dati aggiuntivi chiave-valore da inviare ad AppsFlyer.
getAppsFlyerUID	Ottieni l'ID dispositivo univoco di AppsFlyer (creato per ogni nuova installazione dell'app).
anonymizeUser	Opt-out dell'utente finale dall'analytics di AppsFlyer (anonimizza i dati utente).
stop	Una volta invocato questo API, il nostro SDK non comunicherà più con i nostri server e smetterà di funzionare. Utile per implementare l'opt-in/opt-out dell'utente.
disableSKAdNetwork	Disabilita SKAdNetwork.
disableAdvertisingIdentifier	Disabilita la raccolta di vari Advertising ID da parte di SDK. Include Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID e Amazon Advertising ID (AAID).
disableCollectASA	Disabilita le attribuzioni di Apple Search Ads.
setHost	Imposta un host personalizzato.
generateInviteLink	Permette ai tuoi utenti esistenti di invitare amici e contatti come nuovi utenti della tua app.
validateAndLogInAppPurchaseAndroid	API per la verifica lato server degli acquisti in-app. Se la validazione ha successo, verrà loggato automaticamente un evento af_purchase con i valori rilevanti.
validateAndLogInAppPurchaseIos	Consulta le definizioni sorgente per il comportamento attuale.
getSdkVersion	Ottieni la versione SDK di AppsFlyer utilizzata nell'app.
enableFacebookDeferredApplinks	Abilita la raccolta dei Facebook Deferred AppLinks. Richiede Facebook SDK e l'app Facebook sul dispositivo target/client. Questo API deve essere invocato prima di inizializzare l'SDK di AppsFlyer perché funzioni correttamente.
sendPushNotificationData	Misura e ottieni dati dalle campagne di push notification.
setCurrentDeviceLanguage	Imposta la lingua del dispositivo. I dati saranno visualizzati nei Raw Data Reports.
logCrossPromoteImpression	Logga un'impression come parte di una campagna di cross-promotion. Assicurati di usare l'ID dell'app promossa così come appare nella dashboard di AppsFlyer.
setUserEmails	Imposta le email degli utenti e cifrale.
logLocation	Registra manualmente la posizione dell'utente.
setPhoneNumber	Verrà inviato come stringa criptata SHA-256.
setPartnerData	Consente l'invio di dati personalizzati per l'integrazione con partner.
logInvite	Usa per registrare un evento in-app di invito utente (af_invite).
setDisableNetworkData	Usa per disattivare la raccolta del nome dell'operatore di rete (carrier) e del nome dell'operatore SIM dal dispositivo.
enableTCFDataCollection	Usa per attivare/disattivare la raccolta automatica dei dati di consenso, per gli utenti che usano una CMP. Il valore del flag verrà mantenuto tra le sessioni dell'app.
setConsentData	Usa questo per impostare manualmente i dati di consenso dell'utente. Se la tua app non usa una CMP compatibile con TCF v2.2, usa il seguente metodo per fornire manualmente i dati di consenso direttamente a SDK.
logAdRevenue	Attribuendo i ricavi pubblicitari, i proprietari delle app ottengono una visione completa del LTV utente e del ROI delle campagne. I ricavi pubblicitari sono generati dalla visualizzazione di annunci in rewarded video, offer wall, interstitial e banner in un'app. Puoi usare questo metodo per registrare i tuoi ricavi pubblicitari.
setConsentDataV2	Usa questo per impostare manualmente i dati di consenso dell'utente. Se la tua app non usa una CMP compatibile con TCF v2.2, usa il seguente metodo per fornire manualmente i dati di consenso direttamente a SDK.
isSDKStarted	Usa questo metodo per verificare se l'SDK di AppsFlyer è già stato avviato nella sessione corrente.
isSDKStopped	Usa questo metodo per verificare se l'SDK di AppsFlyer è attualmente fermo.
disableAppSetId	Disabilita la raccolta dell'AppSet ID. Se chiamato prima dell'init di SDK, l'App Set ID non verrà raccolto. Se chiamato dopo l'init, l'App Set ID verrà raccolto ma non inviato nei payload delle richieste. Solo Android.
validateAndLogInAppPurchaseV2	API per la verifica lato server degli acquisti in-app V2. Se la validazione ha successo, verrà loggato automaticamente un evento af_purchase con i valori pertinenti.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-appsflyer.

Continua da @capgo/capacitor-appsflyer

Se stai usando @capgo/capacitor-appsflyer per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-appsflyer per la funzionalità nativa in Utilizzo di @capgo/capacitor-appsflyer, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.