--- title: "Configurar el píxel web de Adapty" description: "Instala el píxel web de Adapty en tu funnel web para que las compras realizadas a través de Stripe o Paddle se atribuyan a los anuncios que las generaron." --- > **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill && claude plugin install adapty-sdk-integration@adapty` — other tools: `npx skills add adaptyteam/adapty-sdk-integration-skill --all` Si captas usuarios a través de un funnel web, el píxel web de Adapty conecta cada visita al anuncio que la originó. El píxel asigna un click ID a cada visitante. Cuando el visitante realiza un pago, pasas ese click ID junto con la transacción, y Adapty Attribution asocia 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. :::tip El píxel solo registra las visitas procedentes de anuncios. Para incorporar las compras en la Atribución de Adapty, conecta [Stripe](ua-stripe) o [Paddle](ua-paddle). ::: ## Cómo funciona \{#how-it-works\} 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 anuncio, 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 tienes que adjuntar el `click_id` a la transacción. Adapty lo relaciona con las señales que ya envió el píxel y determina el canal publicitario de forma automática. ## Antes de empezar \{#before-you-start\} Conecta [Meta Ads](ua-facebook) o [TikTok for Business](ua-tiktok) 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, así que necesitas una para copiar el fragmento. ## Instalar el píxel \{#install-the-pixel\} 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**. 3. Pega el snippet en el `` de cada página de tu funnel: ```html ``` El valor `data-code` identifica tu app y la campaña. Es un identificador público, no un secreto. ## Etiqueta las URLs de tus anuncios \{#tag-your-ad-urls\} El píxel lee los datos de los anuncios desde la URL de tu página de destino. Las redes publicitarias añaden automáticamente su propio ID de clic (`fbclid` o `ttclid`), que identifica la red, pero no la campaña, el conjunto de anuncios ni el anuncio. Para atribuir las compras hasta el anuncio exacto, añade los parámetros de seguimiento a tus anuncios: 1. En la sección **Web funnel** de la configuración de la campaña, copia el valor del campo **Ad URL parameters**. 2. En la red publicitaria, pega el valor a nivel de **ad**: - **Meta**: En el campo **URL parameters** del anuncio. - **TikTok**: Bajo la URL de destino del anuncio, en **Build URL parameters**. El valor contiene macros de la red. La red las sustituye por los valores reales de campaña, grupo de anuncios y anuncio en el momento del clic. Los parámetros no incluyen valores `utm_*`, así que puedes mantener tu propio esquema UTM para tus propias analíticas — Adapty no lo requiere. ## Gestionar el consentimiento \{#manage-consent\} 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: ```js 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 `