contexto: Página/área: Sitio web de marketing de Capgo. Rol: Oración de copia de sitio web. Visto en: componente Hero.astro. Clave de mensaje `hero_subtitle_v2` (Subtítulo del héroe V2).
Copia 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”You can use our AI-Assisted Setup to install the plugin. Add the Capgo skills to your AI tool using the following command:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsLuego utiliza el siguiente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-appsflyer` plugin in my project.Si prefieres la configuración manual, instala el complemento ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:
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 empezar a utilizar AppsFlyer SDK. Este API debe llamarse tan pronto como se inicie la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.initSDK({ devKey: 'dev-key-123', appID: 'app-id-123',});console.log(result);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';
const result = await AppsFlyer.startSDK();console.log(result);Registrar un evento en la aplicación
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.logEvent({ eventName: 'event' });console.log(result);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({ cuid: 'cuid' });setCurrencyCode
Sección titulada “setCurrencyCode”Establece la moneda utilizada para compras en la aplicación. Proporciona un código de tres caracteres de ISO 4217 code.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setCurrencyCode({ currencyCode: 'USD' });updateServerUninstallToken
Sección titulada “updateServerUninstallToken”Envíe tokens de GCM/FCM en Android o tokens de APNs en iOS cuando otro plugin los haya recopilado. Utilice esto para enviar tokens de medición de desinstalación a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.updateServerUninstallToken({ token: 'token-123' });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({ onelinkID: 'onelink-id-123' });setOneLinkCustomDomain
Sección titulada “setOneLinkCustomDomain”Registra dominios de OneLink personalizados para que AppsFlyer pueda resolver parámetros de atribución ocultos en enlaces cortos.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setOneLinkCustomDomain({ domains: ['example.com'] });appendParametersToDeepLinkingURL
Sección titulada “appendParametersToDeepLinkingURL”Permite la atribución para enlaces profundos de App Links sin OneLink. Llame a este método antes startSDK().
Incluya al menos pid y is_retargeting=true en el mapa de parámetros.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.appendParametersToDeepLinkingURL({ contains: 'contains', parameters: {},});setResolveDeepLinkURLs
Sección titulada “setResolveDeepLinkURLs”Use esto cuando un enlace de AppsFlyer OneLink está envuelto dentro de otro enlace Universal. Le permite a SDK resolver la URL envuelta para que la enrutamiento profundo siga funcionando correctamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setResolveDeepLinkURLs({ urls: ['https://example.com'] });addPushNotificationDeepLinkPath
Sección titulada “addPushNotificationDeepLinkPath”Configura cómo el SDK extrae valores de enlaces profundos de los payloads de notificaciones push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.addPushNotificationDeepLinkPath({ path: ['path/to/file'] });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({ filters: ['filter'] });setSharingFilterForAllPartners
Sección titulada “setSharingFilterForAllPartners”Detiene los eventos de propagarse a todos los socios de AppsFlyer. Sobreescribe 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({ filters: ['filter'] });setAdditionalData
Sección titulada “setAdditionalData”Establece datos clave-valor adicionales para enviar a AppsFlyer.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setAdditionalData({ additionalData: {} });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';
const result = await AppsFlyer.getAppsFlyerUID();console.log(result);anonymizeUser
Sección titulada “anonymizeUser”Opt-out del usuario de la analítica de AppsFlyer (anonymizar datos de usuario).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.anonymizeUser({ anonymizeUser: true });Una vez que se invoca este API, nuestra SDK ya no se comunica con nuestros servidores y deja de funcionar.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.stop();console.log(result);disableSKAdNetwork
Sección titulada “disableSKAdNetwork”Optar fuera de SKAdNetwork
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableSKAdNetwork({ shouldDisable: true });disableAdvertisingIdentifier
Sección titulada “disableAdvertisingIdentifier”Desactiva la recopilación de varios IDs de publicidad por parte de SDK. Esto incluye la Identidad para Anunciantes de Apple (IDFA), el ID de Publicidad de Google (GAID), OAID y el ID de Publicidad de Amazon (AAID).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableAdvertisingIdentifier({ shouldDisable: true });disableCollectASA
Sección titulada “disableCollectASA”Optar fuera de las atribuciones de Apple Search Ads.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.disableCollectASA({ shouldDisable: true });setHost
Sección titulada “setHost”Establecer un host personalizado.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setHost({ hostPrefixName: 'host-prefix', hostName: 'host',});generateInviteLink
Título de la sección “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';
const result = await AppsFlyer.generateInviteLink({ brandDomain: 'example.com' });console.log(result);validateAndLogInAppPurchaseAndroid
Título de la sección “validarYIniciarSesiónDeCompraEnAplicaciónAndroid”API para la verificación del servidor de compras en la aplicación. Si la validación es exitosa, se registrará automáticamente un evento af_purchase con los valores relevantes.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.validateAndLogInAppPurchaseAndroid({ currency: 'USD', publicKey: 'public-key-123', signature: 'signature', purchaseData: 'purchase-data', price: 'price',});console.log(result);validateAndLogInAppPurchaseIos
Título de la sección “validarYIniciarSesiónDeCompraEnAplicaciónIos”Consulte las definiciones de origen para el contrato actual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.validateAndLogInAppPurchaseIos({ currency: 'USD', inAppPurchase: 'in-app-purchase', price: 'price', transactionId: 'transaction-id-123',});console.log(result);getSdkVersion
Título de la sección “obtenerVersiónDelSdk”Obtener la versión SDK de AppsFlyer utilizada en la aplicación.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.getSdkVersion();console.log(result);enableFacebookDeferredApplinks
Sección titulada “habilitarFacebookDeferredApplinks”Habilita la recopilación de Facebook Deferred AppLinks. Requiere Facebook SDK y la aplicación de Facebook en el dispositivo objetivo/cliente. Este API debe ser invocado antes de inicializar la instancia de AppsFlyer SDK para funcionar correctamente.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.enableFacebookDeferredApplinks({ enableFacebookDAL: true });console.log(result);sendPushNotificationData
Sección titulada “enviarDatosDeNotificaciónPush”Medir y obtener datos de las campañas de notificaciones push.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.sendPushNotificationData({ pushPayload: {} });setCurrentDeviceLanguage
Sección titulada “establecerIdiomaDelDispositivo”Establece el idioma del dispositivo. Los datos se mostrarán en Informes de Datos Brutos
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.setCurrentDeviceLanguage({ language: 'en-US' });console.log(result);logCrossPromoteImpression
Sección titulada “registrarImpresiónDePromociónTransversal”Registra una impresión como parte de una campaña de promoción cruzada. 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';
const result = await AppsFlyer.logCrossPromoteImpression({ appID: 'app-id-123', campaign: 'campaign', parameters: {},});console.log(result);setUserEmails
Sección titulada “setUserEmails”Set the user emails and encrypt them.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.setUserEmails({ emails: ['user@example.com'] });console.log(result);logLocation
Sección titulada “logLocation”Registrar manualmente la ubicación del usuario
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.logLocation({ latitude: 48.8566, longitude: 2.3522,});console.log(result);setPhoneNumber
Sección titulada “setPhoneNumber”Se enviará como una cadena cifrada SHA-256.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.setPhoneNumber({ phone: '+15555550123' });console.log(result);setPartnerData
Sección titulada “setPartnerData”Permite enviar datos personalizados para fines de integración de socios.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.setPartnerData({ data: {}, partnerId: 'partner-id-123',});console.log(result);logInvite
Sección titulada “logInvite”Use to log a user-invite in-app event (af_invite).
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.logInvite({ eventParameters: {}, channel: 'channel',});console.log(result);setDisableNetworkData
Sección titulada “setDisableNetworkData”Utilice para desactivar la recopilación del nombre del operador de red (proveedor) y del nombre del operador SIM del dispositivo.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setDisableNetworkData({ shouldDisable: true });enableTCFDataCollection
Sección titulada “enableTCFDataCollection”Utilice para habilitar/deshabilitar la recopilación automática de datos de consentimiento, para usuarios que usan un CMP.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.enableTCFDataCollection({ shouldEnableTCFDataCollection: true });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({ data: { isUserSubjectToGDPR: true } });logAdRevenue
Sección titulada “logAdRevenue”Al atribuir la renta publicitaria, los propietarios de la aplicación obtienen una visión completa de la LTV del usuario y el ROI de la campaña. La renta publicitaria se genera al mostrar anuncios en videos recompensados, paredes de ofertas, intersticiales y banners en una aplicación. Puede utilizar este método para registrar su renta publicitaria.
import { AppsFlyer, MediationNetwork } from '@capgo/capacitor-appsflyer';
await AppsFlyer.logAdRevenue({ monetizationNetwork: 'monetization-network', mediationNetwork: MediationNetwork.IRONSOURCE, currencyIso4217Code: 'USD', revenue: 1,});setConsentDataV2
Sección titulada “setConsentDataV2”Utilice este método 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 a la SDK.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
await AppsFlyer.setConsentDataV2({ isUserSubjectToGDPR: true, hasConsentForDataUsage: true, hasConsentForAdsPersonalization: true, hasConsentForAdStorage: true,});isSDKStarted
Sección titulada “isSDKStarted”Utilice este método para comprobar si el SDK de AppsFlyer ya ha sido iniciado en la sesión actual.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.isSDKStarted();console.log(result);isSDKStopped
Sección titulada “isSDKStopped”Utilice este método para comprobar si el SDK de AppsFlyer está actualmente detenido.
import { AppsFlyer } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.isSDKStopped();console.log(result);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, AFPurchaseType } from '@capgo/capacitor-appsflyer';
const result = await AppsFlyer.validateAndLogInAppPurchaseV2({ purchaseDetails: { purchaseType: AFPurchaseType.oneTimePurchase, purchaseToken: 'purchase-token-123', productId: 'product-id-123', },});console.log(result);Fuente de Verdad
Sección titulada “Fuente de Verdad”Esta página se genera a partir del plugin’s src/definitions.tsRe-ejecuta la sincronización cuando cambia el API público en la fuente.
Sigue adelante desde Getting Started
Sección titulada “Sigue adelante desde Getting Started”Si estás utilizando Getting Started planificar la consola y las operaciones API, conecte con Usando @capgo/capacitor-appsflyer para la capacidad nativa en Usando @capgo/capacitor-appsflyer, API Resumen para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, API Claves para el detalle de implementación en API Claves, y Dispositivos para los detalles de implementación en Dispositivos.