Démarrage
Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce 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.
Installation
Section intitulée “Installation”bun add @capgo/capacitor-appsflyerbunx cap syncImporter
Section intitulée “Importer”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 Vue d'ensemble
Section intitulée “API Vue d'ensemble”initSDK
Section intitulée “initSDK”Utilisez cette méthode pour initialiser et démarrer AppsFlyer SDK. Cette API doit être appelée dès le lancement de l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);startSDK
Section intitulée « startSDK »Utilisez cette méthode pour démarrer AppsFlyer SDK, uniquement en mode de démarrage manuel.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();logEvent
Section intitulée « logEvent »Enregistrer un événement de l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Section intitulée « setCustomerUserId »La définition de votre propre ID client vous permet de croiser votre propre ID unique avec l'ID unique d'AppsFlyer et les IDs d'autres appareils. Cet ID est disponible dans les rapports de données brutes et dans les API de Postback pour la croisance avec vos propres IDs internes.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({} as AFCuid);setCurrencyCode
Section intitulée « setCurrencyCode »Définit la devise utilisée pour les achats en application. fournit un code ISO 4217 à trois caractères code.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
Section intitulée « updateServerUninstallToken »Transmettez les jetons GCM/FCM sur Android ou les jetons APNs sur iOS lorsque l'autre plugin les a collectés. Utilisez cela pour transmettre les jetons de mesure d'annulation à AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Section intitulée « setAppInviteOneLink »Définit l'ID OneLink utilisé comme lien de base pour l'attribution des invitations.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
Section intitulée « setOneLinkCustomDomain »Enregistrez des domaines OneLink personnalisés pour que AppsFlyer puisse résoudre les paramètres d'attribution cachés dans les liens courts.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Section intitulée « appendParametersToDeepLinkingURL »Activez l'attribution pour les liens profonds App Links sans OneLink. Appelez cette méthode avant startSDK()Incluez au moins pid et dans le dictionnaire des paramètres. is_retargeting=true Copier dans le presse-papiers
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Utilisez cela lorsque l'OneLink AppsFlyer est enveloppé dans un autre lien universel.
Il permet au __CAPGO_KEEP_0__ de résoudre l'URL enveloppée afin que le deep linking fonctionne correctement.Use this when an AppsFlyer OneLink is wrapped inside another Universal Link. It lets the SDK resolve the wrapped URL so deep linking still works correctly.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Configure comment le __CAPGO_KEEP_0__ extrait les valeurs de lien profond à partir des payloads de notifications push.Configures how the SDK extracts deep link values from push notification payloads.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);Copier dans le presse-papiers
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Section intitulée « setSharingFilterForAllPartners »Empêche les événements de se propager à tous les partenaires AppsFlyer. Remplace setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Section intitulée « setSharingFilterForPartners »Empêche les événements de se propager aux partenaires AppsFlyer spécifiés.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Section intitulée « setAdditionalData »Fixe des données clés-valeurs supplémentaires à envoyer à AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
Section intitulée « getAppsFlyerUID »Obtenez l'ID unique de l'appareil AppsFlyer (créé pour chaque nouvelle installation d'une application).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
Section intitulée « anonymizeUser »Opt-out de l'utilisateur final des analyses AppsFlyer (Anonymisez les données de l'utilisateur).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);Une fois que cette API est invoquée, notre SDK ne communique plus avec nos serveurs et cesse de fonctionner. Utilisez lorsque vous implémentez l'opt-in/opt-out de l'utilisateur.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Section intitulée « disableSKAdNetwork »Opt-out du réseau SKAd
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Section intitulée « disableAdvertisingIdentifier »Désactive la collecte de diverses identifiants publicitaires par le SDK. Cela inclut l'identifiant Apple pour les annonceurs (IDFA), l'identifiant publicitaire Google (GAID), OAID et l'identifiant publicitaire Amazon (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
Section intitulée “désactiverCollectASA”S'abonner à l'opt-out des attributions de Apple Search Ads.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);setHost
Section intitulée “setHost”Définir un hôte personnalisé.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Section intitulée “générerInviteLink”Permettre à vos utilisateurs existants d'inviter leurs amis et contacts comme nouveaux utilisateurs à votre application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Section intitulée “validerEtSeConnecterAchatAppliAndroid”API pour la vérification serveur des achats en application. Un événement af_purchase avec les valeurs pertinentes sera enregistré automatiquement si la validation est réussie.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
Section intitulée « validateAndLogInAppPurchaseIos »Voir les définitions de source pour le contrat actuel.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
Section intitulée « getSdkVersion »Obtenez la version AppsFlyer SDK utilisée dans l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Section intitulée « enableFacebookDeferredApplinks »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
Copier dans le presse-papierSection intitulée « sendPushNotificationData »
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Section intitulée « setCurrentDeviceLanguage »Définir la langue de l'appareil. Les données seront affichées dans les Rapports de données brutes
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
Section intitulée « logCrossPromoteImpression »Enregistre une impression en tant que partie d'une campagne de cross-promotion. Assurez-vous d'utiliser l'ID de l'application promue tel qu'il apparaît dans l'interface de dashboard d'AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);setUserEmails
Section intitulée « setUserEmails »Définir les adresses e-mail des utilisateurs et les chiffrer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
Section intitulée « logLocation »Enregistrer manuellement la localisation de l'utilisateur
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
Section intitulée « setPhoneNumber »Sera envoyé sous forme de chaîne chiffrée SHA-256.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
Section intitulée « setPartnerData »Permet d'envoyer des données personnalisées pour les besoins de l'intégration avec les partenaires.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Section intitulée « logInvite »Utilisez pour enregistrer un événement d'invitation en-ligne (af_invite) dans l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Section intitulée « setDisableNetworkData »Utilisez pour vous désabonner de la collecte du nom de l'opérateur de réseau (carrier) et du nom de l'opérateur SIM du dispositif.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Section intitulée « activer la collecte de données TCF »Utilisez pour vous inscrire/désinscrire de la collecte automatique de données de consentement, pour les utilisateurs qui utilisent un CMP. La valeur de la bannière sera persistante entre les sessions de l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);Utilisez cela pour définir les données de consentement de l'utilisateur manuellement. Si votre application ne utilise pas un CMP compatible avec la version 2.2 de TCF, utilisez la méthode suivante pour fournir les données de consentement directement à l'SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);En attribuant les revenus publicitaires, les propriétaires d'applications obtiennent une vue complète de la valeur à vie de l'utilisateur et du ROI des campagnes. Les revenus publicitaires sont générés en affichant des publicités sur des vidéos rémunérées, des murs d'offres, des interstitiels et des bannières dans une application. Vous pouvez utiliser cette méthode pour enregistrer vos revenus publicitaires.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Section intitulée « Définir les données de consentement V2 »Utilisez cela pour définir les données de consentement de l'utilisateur manuellement. Si votre application ne utilise pas un CMP compatible avec la version 2.2 de TCF, utilisez la méthode suivante pour fournir les données de consentement directement à l'SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({} as AFConsentOptions);isSDKStarted
Section intitulée « isSDKStarted »Utilisez cette méthode pour vérifier si l'SDK AppsFlyer a déjà été démarré dans la session en cours.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
Section intitulée « isSDKStopped »Utilisez cette méthode pour vérifier si l'SDK AppsFlyer est actuellement arrêté.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
Section intitulée « disableAppSetId »Désactive la collecte de l'ID d'application. Si appelé avant l'initialisation de l'SDK, l'ID d'application ne sera pas collecté. Si appelé après l'initialisation, l'ID d'application sera collecté mais pas envoyé dans les payloads de requête. Seul Android.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
Section intitulée « validateAndLogInAppPurchaseV2 »API pour la vérification serveur des achats en application V2. Un événement af_purchase avec les valeurs pertinentes sera automatiquement enregistré si la validation est réussie.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);Source Of Truth
Section intitulée « Source Of Truth »Cette page est générée à partir du plugin’s src/definitions.tsRe-run the sync when the public API changes upstream.