Integrar Meta Ads con Adapty Attribution

La integración de Adapty Attribution con Meta te permite rastrear y optimizar el rendimiento de tus campañas en Facebook, Instagram, Messenger y Audience Network.

Paso 1. Conecta tu cuenta de Facebook

Para conectar Meta Ads a Adapty Attribution, ve a Integrations > Meta desde la barra lateral izquierda. Tienes dos opciones:

• Continue with Facebook: se conecta mediante OAuth. Úsala si accedes a Meta Ads Manager con tu cuenta personal o de empresa de Facebook.
• Add system token: se conecta usando un token de usuario del sistema permanente. Úsala si tu organización gestiona cuentas publicitarias a través de un usuario del sistema de Meta Business.

Important

Asegúrate de que tu cuenta de Facebook tiene acceso a las campañas y píxeles que necesitas.

1. 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.

Genera un token de acceso de usuario del sistema en Meta Business Settings y añádelo a Adapty Attribution.

Important

Antes de empezar, necesitas un usuario del sistema en tu portfolio de Meta Business con las cuentas publicitarias que quieres rastrear ya asignadas. También necesitas una app añadida al portfolio; la seleccionas al generar el token.

En Meta Business Settings, genera el token:

1. Ve a Business Settings.
2. En Users, selecciona System users.
3. Selecciona tu usuario del sistema y haz clic en Generate new token.
4. Selecciona tu app en el desplegable.
5. En la lista de permisos, activa ads_read. Es el único permiso que Adapty Attribution necesita para leer los datos de tus campañas y anuncios.
6. Haz clic en Generate token.
7. Copia el token y guárdalo en un lugar seguro. Meta solo lo muestra una vez.

Note

El ajuste Token expiration controla cuánto tiempo permanece activa la conexión. Un token con fecha de expiración debe regenerarse y reconectarse antes de que expire, o la atribución se detendrá. Un token sin fecha de expiración evita esto, pero es una credencial de larga duración. Guárdalo de forma segura y revócalo si alguna vez queda expuesto.

En Adapty Attribution, añade el token:

1. Haz clic en Add system token.

2. Pega el token y haz clic en Connect.

Tras esto, todas tus cuentas publicitarias se añadirán a Adapty Attribution. Puedes continuar con la incorporación de campañas.

Paso 2. Añade campañas

Una sola campaña puede cubrir el App Store, Google Play y tu funnel web al mismo tiempo. Dos elementos hacen que la conexión funcione:

• Enlace de seguimiento: Va en tu anuncio. Cuando un usuario toca el anuncio, Adapty registra el clic, redirige al usuario al destino y, posteriormente, atribuye la instalación y las compras a ese anuncio. Cada destino tiene su propio enlace.
• Pixel: Se selecciona en la campaña, a partir de los píxeles de tu cuenta de Meta. Envía esas conversiones de vuelta a Meta, para que Meta pueda optimizar la campaña con compras reales. Un solo píxel puede servir a los tres destinos, o cada destino puede tener el suyo propio.

Para añadir una nueva campaña de Meta a Adapty Attribution:

1. Ve a la pestaña Web Campaigns y haz clic en Create configuration.

   

2. En la pestaña General, despliega la sección iOS y/o Android y pega las URLs de la aplicación de App Store y/o Google Play.

   

3. Copia el valor del campo Click link. Luego, en Meta Ads Manager, abre tu anuncio y pega este enlace. Esto permitirá que Adapty vincule las instalaciones y compras con los anuncios de Meta.

   

4. Para enviar los eventos de conversión de vuelta a Meta, también puedes asociar tus píxeles de Meta con campañas en Adapty Attribution. Para ello, selecciona uno de tus píxeles existentes en el desplegable Pixel. Tras seleccionar un píxel, puedes hacer clic en Send test event para verificar la conexión.

La sección Web funnel funciona de la misma manera. Las compras en un web funnel ocurren fuera de tu app, por lo que Meta solo se entera de ellas a través del píxel que selecciones aquí. Esta misma sección te proporciona el snippet para instalar el píxel en tu funnel y los parámetros para etiquetar tus URLs de anuncios.

Un píxel diferente por destino mantiene las compras de iOS, Android y web separadas para la optimización y los informes; el mismo píxel en todos los destinos las combina. La lista Web Campaigns muestra esa elección por configuración, bajo Pixel (iOS), Pixel (Android) y Pixel (Web), con el nombre e ID del píxel. Una sección sin píxel muestra un guion, y un píxel seleccionado en las tres secciones aparece tres veces.

Paso 3. Mapear eventos

Para enviar eventos de conversión a Meta y optimizar las campañas, debes configurar el mapeo de eventos en la sección Events mapping. Esto permite que Adapty envíe automáticamente eventos de suscripción cuando los usuarios realizan acciones en tu app.

En la sección Events mapping, activa los eventos que quieras rastrear en Meta Ads Manager. Para cada evento habilitado, selecciona el evento de Meta correspondiente en el desplegable o define uno personalizado. Por defecto, Adapty mapea los eventos de Adapty a los eventos estándar de Meta.

Haz clic en Save para aplicar la configuración del mapeo de eventos.

Configuración adicional

Parámetros adicionales

El campo Additional parameter te permite añadir datos personalizados para análisis fuera de Adapty. Es útil cuando necesitas pasar datos específicos de campaña o usuario a herramientas de análisis externas o partners de atribución.

En el campo Additional parameter, introduce los datos personalizados que quieras incluir en el seguimiento de atribución. El parámetro adicional se incluirá en todos los datos de atribución enviados a Meta y puede utilizarse para análisis y optimización avanzada de campañas.

Por ejemplo, si estás ejecutando varias variaciones de la misma campaña, podrías añadir variant=A o variant=B para distinguir entre diferentes enfoques creativos.

Configuración

La pestaña Settings controla cómo Adapty asocia las acciones de los usuarios con tus campañas de Meta Ads. Estos ajustes determinan las ventanas de tiempo para la atribución determinista y probabilística.

Para configurarlos, ve a la pestaña Settings en la configuración de tu campaña. Aquí encontrarás dos ajustes principales:

• Ventana de coincidencia determinista: utiliza identificadores exactos del dispositivo (como IDFA en iOS o Advertising ID en Android) para asociar usuarios con campañas con alta precisión. Configúrala en 168 horas (7 días) para obtener la máxima precisión de atribución — este es el valor predeterminado y recomendado. Cuando un usuario hace clic en tu anuncio de Meta e instala la app dentro de esta ventana, Adapty puede atribuir de forma definitiva la instalación a ese clic concreto usando identificadores del dispositivo.

• Ventana de coincidencia probabilística: Usa modelado estadístico y huellas de dispositivo para emparejar usuarios cuando la coincidencia determinista no es posible. Configúrala en 6 horas para la mayoría de las campañas; este es el valor predeterminado y funciona bien en la mayoría de los casos. Para campañas con grandes volúmenes de clics, puedes reducirla a 1-2 horas. Para los usuarios que no se pueden emparejar de forma determinista (por configuración de privacidad u otros factores), Adapty utiliza la coincidencia probabilística dentro de esta ventana más corta.

Haz clic en Save para aplicar tu configuración.

Anulación de ingresos

Si registras eventos de prueba y quieres que Meta los atribuya a ingresos, usa la sección Revenue override. Aparece cuando el evento Trial started está habilitado. La anulación se aplica únicamente a Trial started — Trial converted y Subscription started siempre incluyen sus ingresos reales.

Para cada objetivo de evento de prueba, establece el porcentaje del precio de suscripción que se notificará como ingresos. Por ejemplo, con un 30%, Adapty envía el 30% del precio de suscripción como valor de conversión para los eventos de prueba.

Para añadir una anulación:

1. Activa Trial started en la sección Events mapping.
2. En Revenue override, haz clic en Add override.
3. Selecciona el evento objetivo e introduce un porcentaje de ingresos (0–100).
4. Haz clic en Save.

Prueba calificada

Una prueba se califica una vez que transcurre un número determinado de horas sin que sea cancelada. Usa la sección Qualified trial para retener los eventos de prueba hasta que se califiquen, de modo que Meta solo reciba las pruebas que los usuarios mantuvieron.

Para cada objetivo de evento de prueba, establece el número de horas de espera. Adapty cuenta las horas desde el inicio de la prueba y envía el evento cuando se cumple el plazo. Si el usuario desactiva la renovación automática antes del plazo, Adapty nunca envía el evento. Si el usuario vuelve a activar la renovación automática antes del plazo, Adapty envía el evento según lo previsto.

Para retener un evento de prueba hasta que sea válido:

1. Activa Trial started en la sección Events mapping.
2. En Qualified trial, haz clic en Add event.
3. Selecciona el evento objetivo e introduce el número de horas de espera, de 1 a 24.
4. Haz clic en Save.

Adapty envía el evento calificado con la hora de inicio original del período de prueba, por lo que Meta lo registra en el día en que comenzó.

Revenue override y Qualified trial funcionan de forma independiente, y puedes aplicar ambos al mismo evento de prueba. Revenue override cambia el valor que recibe Meta; Qualified trial cambia cuándo lo recibe. Con ambos activos, Adapty retiene el evento hasta que la prueba se cualifica y luego lo envía con el valor de ingresos sobreescrito. Ninguno tiene preferencia sobre el otro — prueba qué funciona mejor para tus campañas.

LTV Predicho

La optimización de valor de Meta puja por el valor de una conversión, pero por sí sola solo ve el pago que se está reportando — así que una prueba mensual y una suscripción anual parecen casi iguales en el momento de la puja. Usa la sección Predicted LTV para enviar a Meta un valor de vida predicho junto con la conversión, para que Meta puje por lo que probablemente valdrá el usuario en el horizonte que elijas.

Adapty genera la predicción a partir de los ingresos reales de tu propia app, agrupados por país, store, dispositivo y localización, y la asocia a una conversión que ya ha enviado.

El LTV Predicho se activa para una app cuando sus datos permiten generar una predicción significativa. Adapty recalcula esto a diario y muestra la situación actual de la app en la sección Predicted LTV. Trial started y Subscription started se miden por separado, y cualquiera de los dos activa la app al completar ambas barras:

• Al menos 100 conversiones de ese evento atribuidas a Meta en cada una de las últimas 4 semanas completas.
• Al menos 5 valores predichos distintos, con el más alto al menos 3 veces mayor que el más bajo.

Meta añade dos requisitos que Adapty no puede verificar por ti: el dataset debe estar fuera de Core Setup y la cuenta publicitaria debe tener un modelo de valor validado en uso.

Para enviar valores predichos a una campaña:

1. En Events mapping, activa Trial started o Subscription started y asígnalo a un evento de Meta.
2. En Predicted LTV, activa Send predicted LTV to Meta.
3. En Anchor event, selecciona el evento que mapeaste en el paso 1.
4. En Prediction horizon, elige el horizonte temporal del valor: 30, 90, 180 o 365 días.
5. En Target event, selecciona el evento de Meta al que se asociará el valor predicho. La lista muestra únicamente los eventos a los que esta campaña mapea el anchor. Meta acepta valores predichos solo en Purchase, Subscribe, StartTrial, CompleteRegistration, AddPaymentInfo y eventos personalizados.
6. Haz clic en Save.
7. Para que Meta pueda usar los valores, en Events Manager abre tu dataset y selecciona el evento objetivo en Value and Currency Metrics. Haz clic en Set up pLTV y elige After [Event Name] events, ya que Adapty entrega el valor después de la conversión, no junto con ella.

Meta acepta un solo evento de anclaje y un solo horizonte por dataset, por lo que las campañas que comparten un píxel deben enviar el mismo par. Si guardas una campaña cuyo par no coincide con el de otra campaña activa en ese píxel, el guardado se rechaza y el error indica la campaña con la que debes alinearte.

Adapty prepara el valor predicho cuando envía la conversión de anclaje y lo entrega 24 horas después, dentro de la ventana de 7 días de Meta para asociar un valor a una conversión. Hay tres casos que cambian lo que recibe Meta:

• Cuando el evento ancla lo gestiona Qualified trial, las 24 horas comienzan una vez que el evento de prueba llega a Meta. Una prueba cancelada antes de cualificarse no envía ni la conversión ni un valor predicho.
• Cuando Adapty no tiene predicción para el grupo de ese usuario — por ejemplo, un país en el que empezaste a comprar recientemente — la conversión se envía de todas formas, sin valor predicho.
• Desactivar Send predicted LTV to Meta también elimina los valores predichos que aún estén pendientes de entrega.

Adapty envía los valores predichos en USD.

Una vez que Events Manager no muestre problemas abiertos para la integración, Meta necesita aproximadamente dos semanas para entrenar su modelo antes de que puedas lanzar la primera campaña de pLTV. Para leer los resultados, en Ads Manager, añade la columna pLTV del evento objetivo, como StartTrial pLTV, a través de Columns > Customize columns > Results ROAS. Adapty entrega cada valor un día después de la conversión, así que espera un día tras el fin de una campaña antes de leer sus cifras finales.

Enviar todos los eventos

Por defecto, Adapty solo reporta los eventos de los usuarios que provienen de alguna de tus campañas de Meta. La opción Send all events reporta todas las instalaciones y transacciones, incluidas las de usuarios orgánicos y no atribuidos.

No la recomendamos a menos que tus campañas envíen muy pocas conversiones a Meta para optimizar, ya que mezclar eventos orgánicos y no atribuidos con los eventos de tus campañas reduce la precisión de la optimización de Meta.

Si decides activarlo, en la configuración de la campaña selecciona Send all events (forward organic/non-attributed events to this pixel) y haz clic en Save.