Inizia
Esegui le seguenti istruzioni per installare e configurare il plugin: 1. Esegui il comando `npm install @capgo/plugin-name` nel tuo progetto. 2. Aggiungi la seguente riga di codice al tuo file `capgo.config.js`: ```javascript module.exports = { // ... altre impostazioni ... plugins: ['@capgo/plugin-name'], }; ``` 3. Esegui il comando `capgo build` per generare il pacchetto. 4. Esegui il comando `capgo deploy` per distribuire il pacchetto sul tuo sito web. ```markdown # Installazione e configurazione del plugin Per installare e configurare il plugin, segui le seguenti istruzioni: ### Passo 1: Installazione Esegui il comando `npm install @capgo/plugin-name` nel tuo progetto. ### Passo 2: Configurazione Aggiungi la seguente riga di codice al tuo file `capgo.config.js`: ```javascript module.exports = { // ... altre impostazioni ... plugins: ['@capgo/plugin-name'], }; ``` ### Passo 3: Costruzione del pacchetto Esegui il comando `capgo build` per generare il pacchetto. ### Passo 4: Distribuzione Esegui il comando `capgo deploy` per distribuire il pacchetto sul tuo sito web.
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.
Installa
Sezione intitolata “Installa”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”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 “avviaSDK”Utilizza questo metodo per avviare AppsFlyer SDK, solo in modalità avvio manuale.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();Registra un evento in-app.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Sezione intitolata “setCustomerUserId”Impostando il proprio ID cliente, puoi confrontare il proprio ID univoco con l'ID univoco di AppsFlyer e gli ID degli altri dispositivi. Questo ID è disponibile nei report di dati raw e nelle API Postback per confrontarlo con i propri 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 di disinstallazione a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Sezione intitolata “setAppInviteOneLink”Imposta l'ID OneLink utilizzato come link 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 per consentire a AppsFlyer di risolvere i parametri di attribuzione nascosti nei collegamenti brevi.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Sezione intitolata “appendParametersToDeepLinkingURL”Abilita l'attribuzione per i collegamenti App Links profondi senza OneLink. Chiamare questo metodo prima di startSDK()Includere almeno pid e is_retargeting=true nel dizionario dei parametri.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Sezione intitolata “setResolveDeepLinkURLs”Usa questo quando un OneLink AppsFlyer è avvolto da un altro collegamento universale. Lascia che il SDK risolva l'URL avvolto affinché la navigazione profonda funzioni correttamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Sezione intitolata “addPushNotificationDeepLinkPath”Configura come il SDK estrae i valori dei collegamenti profondi dai payload delle notifiche push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Sezione intitolata “setSharingFilter”Blocca gli eventi dalla propagazione ai partner AppsFlyer specificati.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Sezione intitolata “setSharingFilterForAllPartners”Blocca gli eventi dalla propagazione a tutti i partner AppsFlyer. Sovrascrive setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Sezione intitolata “setSharingFilterForPartners”Blocca gli eventi dalla propagazione ai partner AppsFlyer specificati.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Sezione intitolata “setAdditionalData”Imposta dati chiave-valore aggiuntivi 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 da analisi AppsFlyer (Anonimizza i dati dell'utente).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);Una volta invocato questo API, 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 “disabilitaSKAdNetwork”Disattiva SKAdNetwork
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Sezione intitolata “disabilitaAdvertisingIdentifier”Disabilita la raccolta di vari ID pubblicitari da parte di SDK. Ciò include l'Identità per gli annunci di Apple (IDFA), l'ID pubblicitario di Google (GAID), OAID e l'ID pubblicitario Amazon (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
Sezione intitolata “disabilitaCollectASA”Disattiva le attribuzioni degli annunci di ricerca di Apple.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);Imposta un host personalizzato.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Sezione intitolata “generaInvito”Consenti ai tuoi utenti esistenti di invitare i loro amici e contatti come nuovi utenti per la tua app
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Sezione intitolata “validaEeffettuaLloginDellaSpesaPerAppAndroid”API per la verifica del server delle spese per l'app. Se la validazione è riuscita, verrà registrato automaticamente un evento af_purchase con i valori pertinenti
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
Sezione intitolata “validaEeffettuaLloginDellaSpesaPerAppIos”Vedi le definizioni di riferimento per il contratto corrente
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
Sezione intitolata “ottieniVersioneDelloSdK”Ottieni la versione AppsFlyer SDK utilizzata nell'app
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Sottosezione intitolata “abilitaFacebookDeferredApplinks”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
Copiare nel portapenneSottosezione intitolata “inviaDatiNotificaPush”
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Copiare nel portapenneSottosezione intitolata “impostaLinguaDispositivo”
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
Copiare nel portapenneSottosezione intitolata “registraImpressionePromozioneIncrociata”
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”Registra 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 con 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 con partner.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Sezione intitolata “logInvite”Utilizza per registrare un evento di invito utente 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”Utilizza questo per impostare manualmente i dati di consenso dell'utente. Se la tua 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, gli owner dell'app ottengono una visione completa del LTV degli utenti e del ROI delle campagne. Il reddito pubblicitario è generato dalla visualizzazione di annunci in video ricompensati, muri offerta, interstizi e banner nell'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”Utilizza 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”Utilizza questo metodo per verificare se il SDK AppsFlyer è già stato avviato nella sessione corrente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
Sezione intitolata “isSDKStopped”Utilizza questo metodo per verificare se il SDK AppsFlyer è attualmente fermato.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
Sezione intitolata “disabilitaAppSetId”Disabilita la raccolta dell'ID dell'applicazione. Se chiamato prima dell'inizializzazione di SDK, l'ID dell'applicazione non verrà raccolto. Se chiamato dopo l'inizializzazione, l'ID dell'applicazione verrà raccolto ma non verrà inviato nei payload delle richieste. Solo per Android.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
Sezione intitolata “validaEeffettuaLoginAcquistoAppV2”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à
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin's src/definitions.tsRiepilogo quando le modifiche pubbliche API sono disponibili in linea.