Inizia a utilizzare
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo 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.
Installazione
Sottosezione intitolata “Installazione”Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo abilità al tuo strumento AI utilizzando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi utilizza la seguente richiesta:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-appsflyer` plugin in my project.Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:
bun add @capgo/capacitor-appsflyerbunx cap syncImporta
Sezione intitolata “Importa”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 Panoramica
Sezione intitolata “API Panoramica”initSDK
Sezione intitolata “initSDK”Utilizza questo metodo per inizializzare e avviare AppsFlyer SDK. Questo API dovrebbe essere chiamato non appena l'app viene avviata.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);startSDK
Sezione intitolata “startSDK”Utilizza questo metodo per avviare AppsFlyer SDK, solo in modalità avvio manuale.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();logEvent
Sezione intitolata “logEvent”Inserisci un evento in-app.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Sezione intitolata “setCustomerUserId”Imposta il tuo ID cliente per poter riferirti al tuo ID univoco e a quelli degli altri dispositivi tramite AppsFlyer. Questo ID è disponibile nei report dei dati raw e nelle API Postback per la corrispondenza con i tuoi ID interni.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({} as AFCuid);setCurrencyCode
Sezione intitolata “setCurrencyCode”Imposta la valuta utilizzata per le transazioni in-app. Inserisci un codice ISO 4217 a tre caratteri code.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
Sezione intitolata “updateServerUninstallToken”Passa i token GCM/FCM su Android o APNs su iOS quando un altro plugin li ha raccolti. Utilizza questo per inviare i token di misurazione dell'eliminazione del server a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Sezione intitolata “setAppInviteOneLink”Imposta l'ID OneLink utilizzato come link di base per l'attribuzione degli inviti.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
Sezione intitolata “setOneLinkCustomDomain”Registra i domini OneLink personalizzati affinché AppsFlyer possa risolvere i parametri di attribuzione nascosti nei link brevi.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Sezione intitolata “appendParametersToDeepLinkingURL”Abilita l'attribuzione per i link profondi di App Links senza OneLink. Chiamare questo metodo prima di startSDK()Includere almeno pid e is_retargeting=true nei parametri della mappa.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Sezione intitolata “setResolveDeepLinkURLs”Usa questo quando un OneLink AppsFlyer è avvolto dentro un altro Universal Link. Lascia che il SDK risolva l'URL avvolto in modo che la deep linking funzioni correttamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Sezione intitolata “addPushNotificationDeepLinkPath”Configura come il SDK estrae i valori di deep link dai payload delle notifiche push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Sezione intitolata “setSharingFilter”Fermi gli eventi dalla propagazione ai partner AppsFlyer specificati.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Sezione intitolata “setSharingFilterForAllPartners”Fermi gli eventi dalla propagazione a tutti i partner AppsFlyer. Sovrascrive setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Sezione intitolata “setSharingFilterForPartners”Impedisce agli eventi di propagarsi ai partner AppsFlyer specificati.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Sezione intitolata “setAdditionalData”Imposta ulteriori dati chiave-valore da inviare a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
Sezione intitolata “getAppsFlyerUID”Ottieni l'ID dispositivo univoco di AppsFlyer (creato per ogni nuova installazione di un'app).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
Sezione intitolata “anonymizeUser”Disattiva l'utente per gli analytics di AppsFlyer (Anonimizza i dati dell'utente).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);Una volta che questo API viene invocato, il nostro SDK non comunica più con i nostri server e smette di funzionare. Utile quando si implementa l'opt-in/opt-out dell'utente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Sezione intitolata “disableSKAdNetwork”Disattiva SKAdNetwork
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Sezione intitolata “disableAdvertisingIdentifier”Disabilita la raccolta di vari ID pubblicitari da parte del SDK. Ciò include l'Identità per gli annunci di Apple (IDFA), l'ID pubblicitario di Google (GAID), OAID e l'ID pubblicitario di Amazon (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
Sezione intitolata “disableCollectASA”Disattiva le attribuzioni degli annunci di ricerca di Apple.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);setHost
Sezione intitolata “setHost”Imposta un host personalizzato.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Sezione intitolata “generateInviteLink”Consenti ai tuoi utenti esistenti di invitare i loro amici e contatti come nuovi utenti per il tuo app
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Sezione intitolata “validateAndLogInAppPurchaseAndroid”API per la verifica del server delle compravendite in-app. Un evento af_purchase con i valori pertinenti verrà registrato automaticamente se la verifica è riuscita.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
Sezione intitolata “validateAndLogInAppPurchaseIos”Vedi le definizioni di origine per il contratto corrente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
Sezione intitolata “getSdkVersion”Ottenere la versione AppsFlyer SDK utilizzata nell'app.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Sezione intitolata “abilitaFacebookDeferredApplinks”Abilitare la raccolta di Facebook Deferred AppLinks. Richiede Facebook SDK e Facebook app sul dispositivo/client target. Questa API deve essere invocata prima dell'inizializzazione della AppsFlyer SDK per funzionare correttamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
Sezione intitolata “inviaDatiNotificaPush”Misura e ottieni dati dalle campagne di notifiche push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Sezione intitolata “impostaLinguaDispositivo”Imposta la lingua del dispositivo. I dati saranno visualizzati nei rapporti di dati Raw
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
Sezione intitolata “logCrossPromoteImpression”Logga un'impressione come parte di una campagna di promozione incrociata. Assicurati di utilizzare l'ID dell'app promossa come appare nel pannello di controllo di AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);setUserEmails
Sezione intitolata “setUserEmails”Imposta gli indirizzi email degli utenti e criptali.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
Sezione intitolata “logLocation”Logga manualmente la posizione dell'utente
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
Sezione intitolata “setPhoneNumber”Verrà inviato come stringa crittografata SHA-256.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
Sezione intitolata “setPartnerData”Consente di inviare dati personalizzati per scopi di integrazione partner.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Sezione intitolata “logInvite”Utilizza per registrare un evento di invito in-app (af_invite).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Sezione intitolata “setDisableNetworkData”Utilizza per escludere la raccolta del nome dell'operatore di rete (carrier) e del nome dell'operatore SIM dal dispositivo.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Sezione intitolata “enableTCFDataCollection”Utilizza per abilitare/disabilitare la raccolta automatica dei dati di consenso, per gli utenti che utilizzano un CMP. Il valore della flag verrà persistito tra le sessioni dell'applicazione.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
Sezione intitolata “setConsentData”Usa questo per impostare manualmente i dati di consenso degli utenti. Se il tuo app non utilizza un CMP compatibile con TCF v2.2, utilizza il seguente metodo per fornire manualmente i dati di consenso direttamente al SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);logAdRevenue
Sezione intitolata “logAdRevenue”Attribuendo il reddito pubblicitario, i proprietari dell'app guadagnano una visione completa del valore a lungo termine degli utenti e del rendimento del ROI delle campagne. Il reddito pubblicitario è generato dalla visualizzazione di annunci in video ricompensati, muri offerta, interstizi e banner all'interno di un'app. Puoi utilizzare questo metodo per registrare il tuo reddito pubblicitario.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Sezione intitolata “setConsentDataV2”Usa questo per impostare manualmente i dati di consenso degli utenti. Se il tuo app non utilizza un CMP compatibile con TCF v2.2, utilizza il seguente metodo per fornire manualmente i dati di consenso direttamente al SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({} as AFConsentOptions);isSDKStarted
Sezione intitolata “isSDKStarted”Usa questo metodo per verificare se il SDK AppsFlyer è già stato avviato nella sessione corrente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
Sottosezione intitolata “isSDKStopped”Usa questo metodo per verificare se l'SDK AppsFlyer è attualmente sospeso.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
Sottosezione intitolata “disableAppSetId”Disabilita la raccolta dell'ID di AppSet. Se chiamato prima dell'SDK init, l'ID di AppSet non verrà raccolto. Se chiamato dopo l'init, l'ID di AppSet verrà raccolto ma non verrà inviato nei payload delle richieste. Solo per Android.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
Sottosezione intitolata “validateAndLogInAppPurchaseV2”API per la verifica server di acquisti in-app V2. Un evento af_purchase con i valori pertinenti verrà registrato automaticamente se la verifica è riuscita.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);Fonte di Verità
Sottosezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin src/definitions.tsRiepilogare la sincronizzazione quando le informazioni pubbliche API cambiano in fase di sviluppo
Continua da Inizia a utilizzare
Sezione intitolata “Continua da Inizia a utilizzare”Se stai utilizzando Inizia a utilizzare per pianificare dashboard e API operazioni, connettilo con Utilizza @capgo/capacitor-appsflyer per la capacità nativa in Utilizza @capgo/capacitor-appsflyer API Overview per i dettagli di implementazione in API Overview Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi, e Dispositivi per i dettagli di implementazione in Dispositivi.