Démarrage
Copier un prompt de configuration avec les étapes d'installation et la guide markdown complète 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.
Installer
Section intitulée “Installer”bun add @capgo/capacitor-appsflyerbunx cap syncImporter
Section intitulée « Import »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 »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 en application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Section intitulée “setCustomerUserId”La mise en place 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 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 vers 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 »Enregistre les domaines personnalisés OneLink 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 »Active l'attribution pour les liens App Links profonds sans OneLink. Appelez cette méthode avant startSDK().
Incluez au moins pid et is_retargeting=true dans le dictionnaire de paramètres.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Section intitulée « setResolveDeepLinkURLs »Utilisez cela lorsque un OneLink AppsFlyer est encapsulé dans un autre lien universel. Cela permet au SDK de résoudre l'URL encapsulée afin que la mise en page profonde fonctionne correctement.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Section intitulée « addPushNotificationDeepLinkPath »Configure comment SDK extrait les valeurs de lien profond à partir des payloads de notification push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Section intitulée « setSharingFilter »Arrête les événements de se propager aux partenaires AppsFlyer spécifiés.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Section intitulée « setSharingFilterForAllPartners »Arrête 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 »Arrête 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 »Définit 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 d'AppsFlyer (créé pour chaque nouvelle installation d'une application).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
Section intitulée « anonymizeUser »Désactivation de l'utilisateur pour les analyses d'AppsFlyer (anonymisation des 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. Utilisable lors de l'implémentation de l'opt-in/opt-out de l'utilisateur.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Section intitulée « disableSKAdNetwork »S'abonner à la non collecte de SKAdNetwork
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 d'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 « disableCollectASA »S'abonner à la non collecte des attributions des annonces Apple Search Ads
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);Définir un hôte personnalisé
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Section intitulée « generateInviteLink »Permettre à vos utilisateurs existants d'inviter leurs amis et contacts comme de nouveaux utilisateurs à votre application
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Section intitulée « validateAndLogInAppPurchaseAndroid »API pour la vérification du 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 »Obtenir la version AppsFlyer SDK utilisée dans l'application
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Section intitulée « activer les liens de défaillance de Facebook »Activer la collecte des liens de défaillance de Facebook. Exige Facebook SDK et l'application Facebook sur le dispositif cible/client. Cette API doit être invoquée avant d'initialiser l'SDK AppsFlyer pour fonctionner correctement.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
Section intitulée « envoyer les données de notification de poussée »Mesurer et obtenir des données des campagnes de notification de poussée.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Section intitulée « Définir la langue du dispositif »Définir la langue du dispositif. 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 « enregistrer l' impression de promotion croisée »Enregistrez une impression en tant que partie d'une campagne de promotion croisée. Assurez-vous d'utiliser l'ID de l'application promue tel qu'il apparaît dans l'interface de bord de 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”Il 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 des besoins d'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 utilisateur en application (af_invite).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Section intitulée “setDisableNetworkData”Utilisez pour vous désinscrire 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 “enableTCFDataCollection”Utilisez pour vous inscrire/désinscrire de la collecte automatique des données de consentement, pour les utilisateurs qui utilisent un CMP. La valeur de la bannière sera persistée entre les sessions de l'application.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
Section intitulée “setConsentData”Utilisez cela pour définir les données de consentement de l'utilisateur manuellement. Si votre application ne utilise pas un CMP compatible avec TCF v2.2, utilisez la méthode suivante pour fournir les données de consentement directement au SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);logAdRevenue
Section intitulée “logAdRevenue”En attribuant le revenu publicitaire, les propriétaires d'applications gagnent une vue complète de la valeur à long terme de l'utilisateur et du ROI des campagnes. Le revenu publicitaire est généré par la mise en page d'annonces 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 votre revenu publicitaire.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Section intitulée “setConsentDataV2”Utilisez cela pour définir les données de consentement de l'utilisateur de manière manuelle. Si votre application ne utilise pas un CMP compatible avec TCF v2.2, 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 actuelle.
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ée avant l'initialisation de SDK, l'ID d'application ne sera pas collecté. Si appelée après l'initialisation, l'ID d'application sera collecté mais ne sera pas envoyé dans les payloads de requête. Seulement pour 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 De Vérité
Section intitulée « Source De Vérité »Cette page est générée à partir du plugin’s src/definitions.tsRe-run the sync when the public API changes upstream.