Meta Conversions API para afiliados: configurar y deduplicar

La Meta Conversions API (CAPI) es el canal servidor a servidor de Meta para eventos de conversión. Tu tracker o tu servidor envía un registro o un depósito directamente a Meta, de modo que la optimización no depende de que un píxel del navegador se dispare en una página que controlas. Para los afiliados, cuyas conversiones ocurren en el sitio de un operador, a menudo es la única forma de reportarlas.

Esta guía cubre ese caso: tú eres dueño del anuncio y de la landing page, el operador es dueño del registro y del cajero, y la conversión te llega como postback.

Qué es la Meta Conversions API

Meta describe la Conversions API como una conexión entre los datos de marketing de un anunciante y los sistemas de Meta. Los datos pueden venir de un servidor, una plataforma web, una app móvil o un CRM, y pueden abarcar eventos del sitio web, eventos de app, eventos de mensajería empresarial y conversiones offline.

Antes se llamaba Facebook Conversions API, y antes aún Server-Side API. «Facebook conversion API», «conversion API Meta» y «CAPI» se refieren al mismo endpoint de la Marketing API de Meta.

Dos términos importan para la configuración:

• Dataset. Los eventos de servidor se vinculan a un ID de dataset en Events Manager. El dataset también contiene tu Meta Pixel, y Meta indica usar el mismo Pixel ID para los eventos del navegador y del servidor.

• Eventos offline. Meta incluye las conversiones offline entre los datos que transporta la Conversions API, así que la «Meta offline conversions API» está documentada en el mismo lugar.

Cómo funciona la CAPI para afiliados

Un funnel de afiliado cruza dos dominios, y solo uno es tuyo, así que tu tracker retransmite cada conversión a Meta:

1. Clic. Un usuario hace clic en tu anuncio. Meta añade un parámetro fbclid a la URL de la landing.

2. El tracker registra el clic. Guarda su propio click ID junto con el fbclid, la dirección IP del visitante, el user agent y la marca de tiempo, y luego pasa el click ID al enlace del operador como sub-ID.

3. Conversión en el sitio del operador. El jugador se registra y hace un primer depósito. El operador registra ambos contra tu sub-ID.

4. Postback. El sistema del operador llama a tu tracker con el sub-ID y el tipo de evento. Nuestra guía de tracking por postback explica cómo se construye esa llamada.

5. El tracker llama a Meta. El tracker busca el clic guardado, convierte el fbclid en el valor fbc que Meta espera (un prefijo fb., un índice de subdominio, una marca de tiempo de creación y el fbclid, unidos por puntos) y envía el evento con su nombre, hora, ID y datos de usuario.

6. Meta intenta hacer el match. Busca a la persona que vio el anuncio o hizo clic en él; las conversiones con match aparecen en los informes y alimentan la entrega.

El punto débil es el paso 2. Meta sigue aceptando un evento de un clic guardado sin su fbclid, pero tiene poco con qué hacer el match salvo que también envíes datos de contacto.

Meta Pixel vs. Conversions API

El Pixel se ejecuta en el navegador del visitante e informa de lo que ocurre en esa página. La CAPI es una solicitud que tu propio sistema envía en cuanto se entera de una conversión, dondequiera que haya ocurrido.

La página de buenas prácticas de Meta recomienda usar la Conversions API además del Pixel y compartir los mismos eventos a través de ambos. Los afiliados tienen que adaptar eso, porque el Pixel no puede ver los eventos que pagan.

Meta Pixel o Conversions API: ¿cuál necesitas?

La mayoría de los afiliados de iGaming necesitan ambos: el Pixel para el comportamiento en la página, la CAPI para registros y depósitos. La pregunta decisiva es dónde se registra la conversión.

• En el sitio del operador. Es la mayor parte del tráfico de afiliados de casino y apuestas deportivas. El Pixel solo ve tus páginas, así que sin la CAPI optimizas para clics de salida, y Meta aprende a encontrar personas que hacen clic en lugar de personas que depositan.

• Tráfico mayoritariamente de iPhone y Safari. Los límites de privacidad del navegador recortan cuánto viven las cookies y cuánto puede reportar un píxel, así que la señal del servidor pesa más.

• Alto volumen. Cada evento que falta es señal que el sistema de entrega nunca recibe, y la entrega se apoya en esa señal, como explica nuestra guía sobre Meta Andromeda.

• Una prueba pequeña en un formulario propio. Si el lead se captura en un solo paso en tu propia página, basta con el Pixel para empezar. Añade la CAPI cuando la prueba se gane un presupuesto.

Un media buyer que lleva ofertas de iGaming en Meta cae en el primer grupo casi siempre.

Cómo configurar la Conversions API con un tracker

La configuración con un tracker tiene cuatro pasos: dataset, método de conexión, eventos y token, y luego los ajustes del tracker y un evento de prueba. Las pantallas de Events Manager cambian, así que revísalas sobre la marcha.

1. Elige o crea el dataset

Necesitas una Meta Business Suite y un Pixel ID. En Events Manager, conecta una fuente de datos web o reutiliza el dataset que ya contiene tu Pixel. Conecta a ese dataset todas las cuentas publicitarias que vayan a optimizar con estos eventos.

2. Elige el método de conexión

El centro de ayuda de Meta enumera tres vías: una integración de partner, una opción habilitada por Meta para eventos web y la configuración manual. Meta también ofrece un Conversions API Gateway, y algunos equipos usan etiquetado del lado del servidor, como un contenedor de Google Tag Manager del lado del servidor.

Para un tracker que recibe postbacks del operador, encaja la configuración manual: los eventos nacen de postbacks, así que el tracker construye las solicitudes por sí mismo. El Gateway, alojado en una cuenta en la nube de tu propiedad, recibe sus eventos de los navegadores a través del Pixel, no del postback de un operador. Un contenedor de etiquetas del lado del servidor podría aceptarlos, pero duplicaría el trabajo del tracker.

3. Eventos y access token

Selecciona solo los eventos que tus postbacks realmente pueden reportar. Un mapeo habitual es CompleteRegistration para un registro y Purchase para un primer depósito.

Genera el access token en Events Manager, en la configuración manual. Solo las personas con privilegios de desarrollador en el negocio ven ese enlace. Después, Meta crea por ti una app y un usuario del sistema de la Conversions API, sin App Review. Si ya tienes tu propia app, asigna el Pixel a un usuario del sistema existente en Business Suite y genera el token allí.

Cualquiera que tenga el token puede enviar eventos a tu dataset. Guárdalo en los ajustes del tracker, nunca en el código de la página ni en una hoja compartida, y cámbialo cuando se vaya alguien que tenía acceso.

4. Lado del tracker y eventos de prueba

Introduce el Pixel ID y el token en la integración de Meta del tracker y asigna a cada estado de postback un nombre de evento. Confirma que el tracker guarda fbclid, IP y user agent en el momento del clic, y que envía esos datos y no la IP de su propio servidor.

Cada evento también necesita action_source, que Meta marca como obligatorio; para un funnel web, el valor habitual es website. Usar la API implica que aceptas que el valor es exacto según tu leal saber y entender.

Para los eventos del sitio web, fija event_source_url en tu propia landing page: Meta lo exige y dice que debe coincidir con tu dominio verificado, así que la URL del operador no tiene cabida ahí. Luego envía una conversión de prueba y comprueba en Events Manager que llega, se deduplica y tiene match.

Deduplicación: cómo evitar eventos contados dos veces

Meta cuenta un evento del navegador y un evento del servidor como una sola conversión cuando el eventID del Pixel es igual al event_id del servidor y el evento del Pixel es igual a event_name. En torno a esa coincidencia:

• Ventana de 48 horas. Meta solo deduplica eventos recibidos en un plazo de 48 horas; una copia posterior con el mismo ID vuelve a contar.

• Gana el primero recibido. Cuando las dos copias no difieren de forma significativa, Meta generalmente conserva la que recibió primero.

• Un segundo método. Meta también hace match por event_name más fbp y/o external_id, usados de forma coherente en ambos lados. Esto generalmente solo funciona cuando el evento del navegador se envía primero; un evento de servidor sin evento de navegador en las 48 horas anteriores se conserva.

• Una sola fuente, sin dedup. Meta no deduplica un flujo solo de navegador ni uno solo de servidor. Dos eventos de servidor idénticos se conservan ambos.

Dónde fallan las configuraciones de afiliados:

1. Un nombre, dos acciones. El Pixel dispara Lead cuando un visitante sale hacia el operador, y el tracker envía Lead para los registros. Meta aprende ahora de dos acciones distintas bajo una misma etiqueta. Dale a cada acción su propio nombre.

2. IDs que nunca se encuentran. La página crea un event_id y el tracker otro. La dedup necesita el mismo nombre de evento y el mismo ID en ambos lados; una discrepancia en cualquiera de los dos deja dos eventos. Si una acción realmente se dispara en ambos lugares, genera el ID una sola vez, en el clic o en la página, y pasa exactamente ese valor al Pixel y al postback.

3. Postbacks tardíos. Los depósitos suelen confirmarse días después del clic. Un postback que llega pasadas 48 horas ya no puede fusionarse con un evento de navegador anterior, así que cuentan ambos. Mantén los eventos de nivel depósito solo en el servidor.

4. Postbacks repetidos. Los operadores reenvían postbacks o mandan actualizaciones de estado del mismo jugador. Los duplicados solo de servidor se conservan, así que el tracker debe enviar cada tipo de evento una vez por clic.

5. Eventos caducados. event_time puede tener como máximo siete días de antigüedad. Si un evento de una solicitud es más antiguo, Meta devuelve un error para toda la solicitud y no procesa nada de ella, así que envía los eventos a medida que llegan en vez de agrupar en lotes un atraso.

Ads Manager cuenta las conversiones según tu configuración de atribución, así que nunca coincidirá exactamente con un recuento de postbacks. Teniendo eso en cuenta, compara registros y depósitos por campaña durante los mismos pocos días: un excedente persistente en Meta apunta a duplicados; un déficit persistente, a eventos rechazados o sin match. Los eventos inflados o inventados corrompen la optimización y ponen en riesgo la cuenta publicitaria, y los operadores buscan los mismos patrones, como se explica en fraude de afiliados en iGaming.

La CAPI de un clic de Meta y los postbacks del tracker

La documentación de Meta dice que, si tienes un Pixel, puedes configurar la Conversions API con Meta para eventos del sitio web en un clic, sin código, sin configuración y sin costes de instalación. Está construida sobre tu Pixel y cubre solo eventos del sitio web. Para una tienda con su propio checkout, eso es todo el funnel; para un afiliado es la landing page, y los registros y depósitos en el dominio del operador siguen llegando solo de los postbacks del tracker.

El riesgo es el solapamiento. Meta fusiona eventos solo según las reglas anteriores, así que un evento del tracker con su propio event_id no se fusionará con una copia basada en el Pixel de la misma acción. Antes de activarla junto a una integración de tracker, da a cada acción un solo nombre y un ID compartido, y luego compara el tracker con Ads Manager durante unos días.

Event Match Quality

Event Match Quality (EMQ) es una puntuación sobre 10 que Meta muestra por evento en Events Manager. Indica lo útil que es la información del cliente de tus eventos de servidor para el match, y actualmente solo cubre eventos web. Meta dice que enviar más parámetros de información del cliente puede subirla, y cita como ejemplos el email, la dirección IP, el nombre y el número de teléfono.

Para un afiliado, los parámetros utilizables son:

• fbc, construido a partir del fbclid guardado. La clave más directamente ligada al clic en el anuncio.

• fbp, la cookie de navegador del Pixel, si tu landing page la establece y el tracker la captura.

• Dirección IP y user agent del clic. El user agent es obligatorio para los eventos del sitio web.

• Email y teléfono, solo si el operador los pasa y tus términos lo permiten.

La página de parámetros de información del cliente de Meta fija las reglas de tratamiento. Normaliza los datos de contacto (email sin espacios sobrantes y en minúsculas, teléfono en dígitos con código de país) y luego hashéalos con SHA-256. IP, user agent, fbc y fbp van sin hash. Los datos de contacto hasheados siguen siendo datos personales, así que envía solo lo que tu política de privacidad y los términos del programa te permiten compartir.

Anuncios de juego: lo que la CAPI no cambia

La política Online Gambling and Games de Meta permite anuncios de juegos de azar y de juegos solo cuando la cuenta publicitaria tiene la autorización de Meta. Eso incluye anuncios cuyas landing pages promocionan el juego sin ofrecerlo, y la política cita como ejemplos los sitios de afiliados y agregadores.

Los anunciantes solicitan la autorización en la pestaña Authorizations and Verifications de Meta Business Suite, con pruebas de que la actividad tiene licencia o es legal por otra vía allí donde quieren segmentar. Antes de segmentar por primera vez una nueva jurisdicción, deben declarar esa intención. Los anuncios autorizados no pueden dirigirse a menores de 18 años ni a los mercados que Meta lista como no admitidos. Para campañas en EE. UU., la legalidad varía según el estado, como muestra nuestro panorama sobre el juego online en EE. UU.

El tracking del lado del servidor mide resultados; no autoriza anuncios. Esto es un resumen de la política publicada por Meta a octubre de 2026, no asesoramiento legal.

Checklist previo al lanzamiento

Antes del lanzamiento, confirma que cada evento llega a Meta una vez, con datos del clic, su propio nombre y un ID compartido:

• Todas las cuentas publicitarias que optimizan están conectadas al dataset.

• El token vive solo en el tracker.

• Cada evento lleva fbc, IP y user agent del clic, además de action_source.

• Cada acción tiene su propio nombre de evento. Donde el Pixel y el tracker la reportan ambos, envían el mismo nombre y el mismo event_id.

• El tracker envía un evento por tipo y por clic, en tiempo real.

• event_source_url apunta a tu dominio de landing.

• Llegó un evento de prueba y tuvo match, y hay programada una comparación periódica entre el tracker y Ads Manager.

Preguntas frecuentes

¿Qué es la Meta Conversions API (CAPI)?

La Conversions API es la API de Meta para enviar eventos de conversión desde tus propios sistemas, como un servidor, un tracker o un CRM, directamente a Meta. La Facebook Conversions API es el mismo producto con su nombre anterior.

¿Cómo se rastrean las conversiones de los anuncios de Meta sin un píxel en la oferta?

Tu tracker guarda el fbclid de cada clic en el anuncio, pasa tu click ID al operador como sub-ID y reenvía el postback del operador a la Conversions API con los datos del clic guardados.

¿Puedo usar solo la CAPI sin el Pixel?

La CAPI funciona sin el Pixel, y para los eventos del lado del operador es lo que haces de todos modos. Aun así, mantén el Pixel en tu landing page: sin él no hay cookie fbp que tus eventos de servidor puedan llevar como clave de match, y Meta aconseja usar ambos.

¿Meta tiene una API y la Conversions API es gratuita?

Sí: la Conversions API forma parte de la Marketing API de Meta. Meta describe la opción de un clic como libre de costes de instalación. Una integración directa cuesta lo que cueste tu tracker, tu servidor o tu herramienta de partner.

¿Qué pasa si activo la CAPI de un clic además de los postbacks del tracker?

La CAPI de un clic cubre eventos del sitio web ligados a tu Pixel, no conversiones en el sitio del operador. El doble conteo aparece cuando el Pixel y el tracker reportan la misma acción con IDs o nombres distintos; alinéalos primero y luego compara el tracker con Ads Manager.

¿Qué es Event Match Quality y por qué importa?

Event Match Quality es la puntuación sobre 10 de Meta que mide hasta qué punto los datos de cliente de tus eventos de servidor se pueden asociar a personas. Los eventos que no se pueden asociar tienen poco peso en los informes y la optimización.

Fuentes

• Meta, Conversions API overview

• Meta, Get started with the Conversions API

• Meta, Deduplicate Pixel and server events

• Meta, Server event parameters

• Meta, Customer information parameters

• Meta, Conversions API best practices

• Meta, Conversions API Gateway

• Meta Business Help Center, Set up and install the Meta Pixel

• Meta Transparency Center, Online Gambling and Games (checked October 28, 2026)

• Meta Business Help Center, Apply for permission to promote online gaming or gambling