Iniciar sesión
Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este 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.
Instalar
Sección titulada “Instalar”bun add @capgo/capacitor-appsflyerbunx cap syncImportar
Sección titulada “Importación”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 Resumen
Sección titulada “API Resumen”Utilice este método para inicializar y iniciar AppsFlyer SDK. Este API debe llamarse tan pronto como se lance la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.initSDK({} as AFInit);startSDK
Sección titulada “iniciarSDK”Utilice este método para iniciar AppsFlyer SDK, solo en modo de inicio manual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.startSDK();Registrar un evento en la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logEvent({} as AFEvent);setCustomerUserId
Sección titulada “setCustomerUserId”Establecer su propio ID de cliente le permite cruzarreferenciar su propio ID único con el ID único de AppsFlyer y los IDs de otros dispositivos. Este ID está disponible en informes de datos brutos y en las API de Postback para cruzarreferenciar con sus IDs internos.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCustomerUserId({} as AFCuid);setCurrencyCode
Sección titulada “setCurrencyCode”Establece la moneda utilizada para las compras en la aplicación. Proporcione un código de tres caracteres de la norma ISO 4217 code.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({} as AFCurrency);updateServerUninstallToken
Sección titulada “updateServerUninstallToken”Pase tokens de GCM/FCM en Android o tokens de APNs en iOS cuando otro plugin los recopiló. Utilice esto para enviar tokens de medición de desinstalación a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({} as AFUninstall);setAppInviteOneLink
Sección titulada “setAppInviteOneLink”Establece el ID de OneLink utilizado como enlace base para la atribución de invitaciones.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAppInviteOneLink({} as AFOnelinkID);setOneLinkCustomDomain
Sección titulada “setOneLinkCustomDomain”Registra dominios personalizados de OneLink para que AppsFlyer pueda resolver los parámetros de atribución ocultos en enlaces cortos.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({} as AFOnelinkDomain);appendParametersToDeepLinkingURL
Sección titulada “appendParametersToDeepLinkingURL”Habilita la atribución para enlaces profundos de App Links sin OneLink. Llame a este método antes de startSDK()Incluya al menos pid y is_retargeting=true en el mapa de parámetros.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({} as AFAppendToDeepLink);setResolveDeepLinkURLs
Sección titulada “setResolveDeepLinkURLs”Use esto cuando un enlace de AppsFlyer OneLink está envuelto en otro enlace Universal. Permite que el SDK resuelva la URL envuelta para que el enlace profundo siga funcionando correctamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({} as AFUrls);addPushNotificationDeepLinkPath
Sección titulada “addPushNotificationDeepLinkPath”Configura cómo SDK extrae valores de enlaces profundos de los payloads de notificaciones push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({} as AFPath);setSharingFilter
Sección titulada “setSharingFilter”Detiene los eventos de propagarse a los socios de AppsFlyer especificados.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilter({} as AFFilters);setSharingFilterForAllPartners
Sección titulada “setSharingFilterForAllPartners”Detiene los eventos de propagarse a todos los socios de AppsFlyer. Sobrescribe setSharingFilter.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForAllPartners();setSharingFilterForPartners
Sección titulada “setSharingFilterForPartners”Detiene los eventos de propagarse a los socios de AppsFlyer especificados.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setSharingFilterForPartners({} as AFFilters);setAdditionalData
Sección titulada “setAdditionalData”Establece datos clave-valor adicionales para enviar a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({} as AFData);getAppsFlyerUID
Sección titulada “getAppsFlyerUID”Obtenga el ID único de dispositivo de AppsFlyer (creado para cada nueva instalación de una aplicación).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getAppsFlyerUID();anonymizeUser
Sección titulada “anonymizeUser”Derecho del usuario a no ser rastreado por AppsFlyer (Anonimizar datos del usuario).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({} as AFAnonymizeUser);Una vez que se invoca este API, nuestro SDK ya no se comunica con nuestros servidores y deja de funcionar. Útil al implementar la opción de aceptación/rechazo del usuario.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.stop();disableSKAdNetwork
Sección titulada “disableSKAdNetwork”Darse de baja en SKAdNetwork
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({} as AFDisable);disableAdvertisingIdentifier
Sección titulada “disableAdvertisingIdentifier”Deshabilita la recopilación de varios identificadores de publicidad por parte de SDK. Esto incluye el Identificador de Apple para Anunciantes (IDFA), el Identificador de Publicidad de Google (GAID), OAID y el Identificador de Publicidad de Amazon (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({} as AFDisable);disableCollectASA
Sección titulada “disableCollectASA”Darse de baja en las atribuciones de anuncios de Apple Search Ads
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({} as AFDisable);setHost
Sección titulada “setHost”Establecer un host personalizado
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({} as AFHost);generateInviteLink
Sección titulada “generarEnlaceDeInvitación”Permitir a sus usuarios existentes que inviten a sus amigos y contactos como nuevos usuarios a su aplicación
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.generateInviteLink({} as AFLinkGenerator);validateAndLogInAppPurchaseAndroid
Sección titulada “validarYIniciarSesiónCompraEnAplicaciónAndroid”API para la verificación del servidor de compras en la aplicación. Se registrará automáticamente un evento af_purchase con los valores relevantes si la validación es exitosa.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseAndroid({} as AFAndroidInAppPurchase);validateAndLogInAppPurchaseIos
Sección titulada “validarYIniciarSesiónCompraEnAplicaciónIos”Consulte las definiciones de origen para el contrato actual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseIos({} as AFIosInAppPurchase);getSdkVersion
Sección titulada “obtenerVersiónDelSdk”Obtener la versión SDK de AppsFlyer utilizada en la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.getSdkVersion();enableFacebookDeferredApplinks
Sección titulada “habilitarFacebookDeferredApplinks”Habilite la recopilación de Facebook Deferred AppLinks. Requiere Facebook SDK y una aplicación de Facebook en el dispositivo objetivo/cliente. Esta API debe ser invocada antes de inicializar la instancia de AppsFlyer SDK para funcionar correctamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableFacebookDeferredApplinks({} as AFFbDAL);sendPushNotificationData
Sección titulada “enviarDatosDeNotificaciónPush”Mida y obtenga datos de las campañas de notificaciones push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({} as AFPushPayload);setCurrentDeviceLanguage
Sección titulada “establecerIdiomaDelDispositivo”Establezca el idioma del dispositivo. Los datos se mostrarán en los informes de datos brutos.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrentDeviceLanguage({} as AFLanguage);logCrossPromoteImpression
Sección titulada “registrarImpresiónDePromociónTransversal”Registre una impresión como parte de una campaña de promoción transversal. Asegúrese de utilizar el ID de la aplicación promocionada tal como aparece en la consola de AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logCrossPromoteImpression({} as AFPromotion);Establecer correos electrónicos del usuario y cifrarlos.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setUserEmails({} as AFEmails);logLocation
Sección titulada “ubicación de registro”Registrar manualmente la ubicación del usuario.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logLocation({} as AFLatLng);setPhoneNumber
Sección titulada “establecer número de teléfono”Se enviará como una cadena cifrada SHA-256.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPhoneNumber({} as AFPhone);setPartnerData
Sección titulada “establecer datos del socio”Permite enviar datos personalizados para fines de integración de socios.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setPartnerData({} as AFPartnerData);logInvite
Sección titulada “logInvite”Usa para registrar un evento de invitación de usuario en la aplicación (af_invite).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logInvite({} as AFLogInvite);setDisableNetworkData
Sección titulada “setDisableNetworkData”Usa para excluir la recopilación del nombre del operador de red (proveedor) y el nombre del operador SIM del dispositivo.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({} as AFDisable);enableTCFDataCollection
Sección titulada “enableTCFDataCollection”Usa para habilitar/deshabilitar la recopilación automática de datos de consentimiento, para usuarios que usan un CMP. El valor de la bandera se persistirá entre sesiones de la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({} as AFEnableTCFDataCollection);setConsentData
Sección titulada “setConsentData”Usa esto para establecer los datos de consentimiento del usuario manualmente. Si tu aplicación no utiliza un CMP compatible con TCF v2.2, usa el siguiente método para proporcionar los datos de consentimiento directamente a la SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentData({} as AFConsentData);logAdRevenue
Sección titulada “logAdRevenue”Al atribuir la ganancia de publicidad, los propietarios de la aplicación obtienen una visión completa del LTV del usuario y el ROI de la campaña. La ganancia de publicidad se genera al mostrar anuncios en videos recompensados, paredes de ofertas, intersticiales y banners en la aplicación. Puede utilizar este método para registrar su ganancia de publicidad.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({} as AFAdRevenueData);setConsentDataV2
Sección titulada “setConsentDataV2”Utilice esto para establecer los datos de consentimiento del usuario manualmente. Si su aplicación no utiliza un CMP compatible con TCF v2.2, utilice el siguiente método para proporcionar los datos de consentimiento directamente al SDK de manera manual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({} as AFConsentOptions);isSDKStarted
Sección titulada “isSDKStarted”Utilice este método para verificar si el SDK de AppsFlyer ya ha sido iniciado en la sesión actual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStarted();isSDKStopped
Sección titulada “isSDKStopped”Utilice este método para verificar si el SDK de AppsFlyer está actualmente detenido.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.isSDKStopped();disableAppSetId
Sección titulada “disableAppSetId”Deshabilita la recopilación de ID de aplicación. Si se llama antes de SDK init, el ID de la aplicación no se recopilará. Si se llama después de init, el ID de la aplicación se recopilará pero no se enviará en los payloads de solicitud. Solo para Android.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAppSetId();validateAndLogInAppPurchaseV2
Sección titulada “validateAndLogInAppPurchaseV2”API para la verificación del servidor de compras en la aplicación V2. Se registrará automáticamente un evento af_purchase con los valores relevantes si la validación es exitosa.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.validateAndLogInAppPurchaseV2({} as AFPurchaseDetailsV2);Fuente de Verdad
Sección titulada “Fuente de Verdad”Esta página se genera desde el plugin’s src/definitions.tsRe-ejecutar la sincronización cuando los cambios públicos API cambien en la fuente.