Primeros pasos con Adapty Attribution

Adapty Attribution te ayuda a conectar el gasto publicitario con los ingresos por suscripciones en campañas web-to-app, dándote una visión completa de la economía de tu app en un solo lugar.

Para ver tus datos de ingresos en Adapty Attribution, primero debes activar la integración en el Adapty Dashboard. No necesitas introducir claves de API, tokens ni identificadores. Solo tienes que actualizar y configurar el SDK.

Antes de empezar

Para conectar los datos de ingresos con el rendimiento de tus campañas, permite que Adapty registre tus compras:

• Si ya tienes compras in-app implementadas con Adapty, no necesitas hacer nada más en esta etapa.
• Si aún no tienes compras in-app implementadas y quieres usar Adapty, completa los pasos de la guía de inicio rápido para delegar el manejo de compras a Adapty.
• Si ya tienes compras in-app implementadas sin Adapty y no planeas migrar a Adapty, instala el SDK de Adapty para tu plataforma en el modo observador. En esta etapa solo necesitas añadir el SDK a tu proyecto, activarlo con el modo observador habilitado y reportar las transacciones: Esta configuración habilita la atribución web-to-app:
• Cuando los usuarios instalan tu app, el SDK de Adapty obtiene los detalles de instalación a partir de los parámetros del enlace, para que Adapty Attribution pueda obtener los detalles de la campaña.
• El SDK de Adapty conoce todos los eventos relacionados con ingresos dentro de la app y puede atribuirlos a campañas web.

Paso 1. Habilitar la Atribución de Adapty en el SDK

A partir de la versión 4.1 del SDK de Adapty, la Atribución de Adapty está deshabilitada por defecto. Para que el SDK registre instalaciones y entregue los detalles de instalación a tu app, habilítala al activar el SDK:

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(adaptyAttributionEnabled: true)

val config = AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build()

Adapty.activate(applicationContext, config)

AdaptyConfig config = new AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build();

Adapty.activate(getApplicationContext(), config);

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    adaptyAttributionEnabled: true,
  }
});

En versiones del SDK anteriores a la 4.1, Adapty Attribution se activa automáticamente — no se requieren cambios en el código.

Paso 2. Abre Adapty Attribution

Haz clic en el logotipo de Adapty en el encabezado y selecciona Attribution.

Los eventos de suscripción empiezan a fluir hacia Adapty Attribution de forma automática. Los datos de campaña aparecen después de que conectes una fuente de datos en el paso 3.

Para pausar la entrega de eventos, abre Integrations > Adapty en el Adapty Dashboard y desactiva el interruptor.

Eventos compatibles

Por defecto, Adapty envía tres grupos de eventos a User Acquisition:

• Trials
• Suscripciones
• Problemas

Puedes consultar la lista completa de eventos compatibles aquí.

Paso 3. Conecta tu plataforma de anuncios y añade enlaces de seguimiento

Adapty utiliza enlaces de seguimiento para conectar las instalaciones de la app con los datos de las campañas. Debes usar un enlace de seguimiento como URL de destino en cada campaña publicitaria que quieras medir en Adapty Attribution.

Si publicas anuncios en varias plataformas, configura los enlaces de seguimiento para cada una por separado.

Hay dos formas en que Adapty trabaja con plataformas de anuncios:

• Integraciones nativas (Meta Ads, TikTok Ads). Adapty se conecta directamente con la plataforma publicitaria. Los enlaces de seguimiento se generan automáticamente y los parámetros de campaña se rellenan de forma dinámica según dónde se use el enlace. Puedes usar el mismo enlace en distintas campañas, conjuntos de anuncios o creatividades, y Adapty recibirá automáticamente los datos correctos de campaña y gasto publicitario.

• Solo enlaces de seguimiento (el resto de plataformas publicitarias). Adapty no se conecta directamente con la plataforma de anuncios. Los enlaces de seguimiento se crean manualmente y todos los parámetros de campaña deben definirse de forma explícita al crear el enlace. Los datos de gasto en publicidad no están disponibles para estas plataformas.

Para crear un enlace de seguimiento para Meta Ads:

1. Ve a Integrations > Meta en el Adapty Attribution Dashboard y haz clic en Continue with Facebook.

2. Inicia sesión con tu cuenta de Facebook y haz clic en Continue.

3. Revisa los permisos solicitados y haz clic en Save.
4. Cambia a la pestaña Web campaigns y haz clic en Create campaign. Selecciona la aplicación y haz clic en Save.

5. En la pestaña General, despliega la sección iOS y/o Android y pega las URLs de la aplicación en App Store y/o Google Play. Luego haz clic en Save.

6. Copia el valor del campo Click link de un enlace o de un enlace específico de plataforma. Luego, en Meta Ads Manager, abre tu anuncio y pega este enlace como URL de destino.

Important

En el campo Website URL, pega https://api-ua.adapty.io/api/v1/attribution/click. Pega el resto del enlace en el campo URL parameters de la sección Tracking. Esto ayudará a que tu anuncio de Meta sea aprobado. Consulta más recomendaciones para configurar tus anuncios en Meta Ads Manager.

7. Ahora, cuando lances tu anuncio en Meta Ads, sus datos estarán disponibles para su análisis en el dashboard de Adapty Attribution.

Para crear un enlace de seguimiento para TikTok for Business:

1. Ve a Integrations > TikTok Ads en el Adapty Attribution Dashboard y haz clic en Continue with TikTok.

   

2. Inicia sesión con tu cuenta de TikTok y haz clic en Continue.

3. Revisa los permisos solicitados y haz clic en Save.

4. Cambia a la pestaña Web campaigns y haz clic en Create campaign. Selecciona la aplicación y haz clic en Save.

   

5. En la pestaña General, despliega la sección iOS y/o Android y pega las URLs de la aplicación en App Store y/o Google Play. Luego, haz clic en Save.

   

6. Copia el valor del campo Click link para un enlace o para un enlace específico de plataforma. Luego, en TikTok Ads Manager, al crear tu anuncio, pega este valor en el campo Tracking URL dentro de la sección Advanced Settings. Esto permitirá que Adapty conecte las instalaciones y compras con los anuncios en TikTok. Consulta la guía para configurar tu campaña en TikTok Ads.

   

7. Ahora, cuando lances tu anuncio en TikTok for Business, sus datos estarán disponibles para su análisis en el dashboard de Atribución de Adapty.

Para crear un enlace de seguimiento para otras plataformas de anuncios:

1. En el dashboard de Adapty Attribution, abre Integrations y selecciona la tarjeta Custom en el grupo Network. Allí, haz clic en Create link.

   

2. Selecciona tu app de la lista y haz clic en Next.

   

3. Rellena los parámetros del enlace para asociarlo con la campaña y el anuncio que quieres rastrear.

4. Por defecto, estás creando un One Link. Detecta automáticamente la plataforma del usuario y lo redirige a la App Store o a Google Play tras registrar el clic.

   Si prefieres usar URLs de redirección distintas para cada plataforma, desmarca la casilla One Link e introduce manualmente los enlaces a la store de cada plataforma.

   

5. Haz clic en Create.

6. Abre la página de tu enlace de seguimiento y copia el Click link de una de las secciones:

   • One link – usa este enlace para rastrear clics y redirigir automáticamente a los usuarios a la store correcta.
   • iOS link o Android link — versiones opcionales específicas por plataforma si quieres enlaces separados para cada store.

7. Ve a tu plataforma de anuncios y pega el enlace en tu anuncio como URL de destino del anuncio.

Paso 4. Lanza tu campaña web-to-app y consulta los resultados

Una vez que tu campaña esté activa y los usuarios comiencen a instalar tu app, Adapty empieza a atribuir las instalaciones y los ingresos a tus campañas.

En el dashboard de Adapty Attribution analytics, verás métricas a nivel de campaña como:

• Instalaciones y conversiones
• Ingresos por suscripciones y compras
• Desglose de rendimiento por plataforma de anuncios, campaña, conjunto de anuncios y creatividad

Las métricas aparecen en cuanto se reciben los eventos de instalación e ingresos desde tu app. Los datos de gasto en publicidad están disponibles para las plataformas con integraciones nativas.

Más información

Continúa con la documentación detallada sobre el análisis de atribución de Adapty y guías prácticas para ejecutar campañas en las principales plataformas publicitarias:

• Analíticas en Adapty Attribution: Descubre cómo usar el dashboard de analíticas de forma efectiva.
• Métricas en Adapty Attribution: Explora las métricas disponibles para el análisis de adquisición de usuarios.
• Integraciones: Consulta las plataformas publicitarias e integraciones compatibles con Adapty Attribution.
• Lanzar anuncios en Meta Ads Manager: Aprende a configurar y lanzar campañas en Meta Ads Manager.
• Lanzar anuncios en TikTok for Business: Aprende a configurar y lanzar campañas en TikTok for Business.