English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Configurar el píxel web de Adapty

Si captas usuarios a través de un funnel web o una página de destino, el píxel web de Adapty conecta cada visita con el anuncio que la originó. El píxel asigna a cada visitante un click ID. Cuando el visitante realiza un pago, pasas ese click ID junto con la transacción, y Adapty Attribution relaciona la compra con la campaña, el conjunto de anuncios y el anuncio exactos.

El píxel está disponible para campañas de Meta Ads y TikTok for Business.

Note

Si tu embudo se ejecuta en FunnelFox, no necesitas el píxel. Consulta Integrar FunnelFox con la atribución de Adapty.

Cómo funciona

Al cargar la página, el píxel:

  • Asigna al visitante un click_id y lo almacena en el navegador durante 7 días.
  • Captura las señales publicitarias de la URL de la página: los IDs de clic de Meta (fbclid) y TikTok (ttclid), los identificadores y nombres de campaña, conjunto de anuncios y anuncios, y los parámetros utm_*.
  • Envía el click_id y las señales capturadas a Adapty en segundo plano.

En el momento del pago, solo adjuntas el click_id a la transacción. Adapty lo relaciona con las señales que el píxel ya envió y determina el canal publicitario automáticamente.

Tip

El píxel solo registra las visitas a los anuncios. Para llevar las compras a Atribución de Adapty, conecta Stripe o Paddle.

Antes de empezar

Conecta Meta Ads o TikTok for Business a Adapty Attribution y añade una configuración de campaña. Adapty genera el fragmento de píxel por cada configuración de campaña, por lo que necesitas una para poder copiar el fragmento.

El píxel lee los datos del anuncio desde la URL de tu página de destino, por lo que tus anuncios deben incluir los parámetros de seguimiento de Adapty. Sin ellos, Adapty atribuye la compra a la red, pero no a la campaña, el conjunto de anuncios o el anuncio. Consulta Etiqueta las URLs de tus anuncios para funnels web.

Instalar el píxel

  1. En Adapty Attribution, abre la configuración de tu campaña de Meta Ads o TikTok.
  2. En la pestaña General, despliega la sección Web funnel y copia el valor del campo Pixel snippet.
Pixel snippet field in the Web funnel section of a campaign configuration in Adapty Attribution
  1. Pega el snippet en el <head> de cada página de tu funnel:
<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

El valor data-code identifica tu app y la campaña. Es un identificador público, no un secreto.

El píxel escribe una cookie de origen y una entrada en localStorage, y lee los IDs de clic de anuncios al cargar la página. Tú eres el responsable del tratamiento de datos de tu funnel y tienes la base legal para ello.

Por defecto, el píxel se ejecuta al cargar la página. Para condicionarlo al consentimiento, añade data-consent="denied" al snippet — el píxel no almacena ni envía nada hasta que concedas el consentimiento desde tu banner de cookies:

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'
Warning

Condiciona el píxel al consentimiento para el tráfico de la UE/EEE. La normativa ePrivacy exige consentimiento previo para el almacenamiento en el navegador, y un píxel de atribución de origen propio no está exento.

El fragmento se carga de forma asíncrona, por lo que window.adaptyPixel no existe en la línea inmediatamente posterior a la etiqueta <script>. Llama a la API de consentimiento desde el callback de tu banner de consentimiento, o protege una llamada temprana con if (window.adaptyPixel) { ... }.

Notas de uso

  • Funnels de una sola página: La navegación del lado del cliente mantiene el mismo click_id, por lo que un funnel creado como una single-page app funciona sin configuración adicional.
  • Estabilidad del Click ID: Leer el click_id al cargar la página o en el momento del pago devuelve el mismo valor. Si el visitante vuelve a entrar al funnel desde un nuevo anuncio, el clic más reciente tiene prioridad.
  • Renovaciones: Asocia el click_id únicamente a la transacción inicial. Adapty atribuye las conversiones de prueba y las renovaciones de suscripción a través de la propia suscripción.