Integración de la API de Conversiones de Meta (CAPI)

Envía a tu conjunto de datos de Meta, de servidor a servidor, cada conversión aprobada que generan tus partners, para que la entrega de anuncios de Meta optimice con compras reales aunque el píxel del navegador esté bloqueado.

Descripción general

El píxel de Meta se ejecuta en el navegador del comprador, donde los bloqueadores, los ajustes de privacidad de iOS y las preferencias de consentimiento frenan muchos eventos. La API de Conversiones envía esos mismos eventos desde un servidor. AffClix lo hace por ti: cuando una conversión se aprueba, envía un evento de servidor a tu conjunto de datos (píxel) con el nombre de evento que asignes, el valor de la venta y las señales de identidad que permitas.

La configuración lleva unos minutos: conecta Facebook, elige el conjunto de datos de una lista y asigna tus objetivos de AffClix a los eventos estándar de Meta. Si el sitio también usa el píxel, Meta conserva un único evento por conversión, porque AffClix envía el ID de conversión como ID de evento.

Por qué es importante esta integración

  • Recupera conversiones perdidas: las compras que el píxel nunca vio —por bloqueadores, iOS o cookies rechazadas— también llegan a Meta.
  • Mejor optimización: Advantage+ y las campañas de conversión aprenden de las ventas que cierran tus partners.
  • Solo conversiones aprobadas: las pendientes, rechazadas o recortadas nunca se envían, así que Meta optimiza con los ingresos que conservas.
  • Valores reales: cada evento incluye el importe de la venta y la moneda, para una optimización por valor y un ROAS precisos.
  • Sin duplicar el píxel: el ID de conversión de AffClix se envía como ID de evento, así que Meta cuenta una sola compra aunque la informen el píxel y el servidor.
  • Tú decides qué se comparte: elige qué señales de identidad salen de AffClix; la ubicación y los ID externos se cifran con SHA-256 antes de enviarse.
  • Registro completo: cada intento queda registrado con la respuesta de Meta en el informe CAPI Delivery.

Requisitos previos

  • Un plan de AffClix que incluya Conversions API: el menú Integrations → Conversions API.
  • Un conjunto de datos (píxel) de Meta en el Administrador de eventos. Usa el que ya recibe los eventos del navegador del sitio, para que los eventos de servidor y de navegador se unan.
  • Una cuenta de Facebook con acceso a ese conjunto de datos, como persona del Business Manager propietario o mediante una asignación de partner.
  • Conversiones que lleguen a AffClix por postback, píxel o una integración de e-commerce, y que estén aprobadas.
  • Opcional: un código de evento de prueba de Administrador de eventos → tu conjunto de datos → Eventos de prueba, para comprobar la configuración antes del tráfico real.

Paso 1: Prepara tu conjunto de datos en el Administrador de eventos

Todo lo que AffClix necesita ya existe en el Administrador de eventos; solo tienes que saber qué conjunto de datos usar.

01

Abre el Administrador de eventos

En Meta Business Suite, abre Events Manager → Data sources y selecciona el conjunto de datos (píxel) que usa el sitio web.

02

Anota el ID del conjunto de datos

Es el número que aparece bajo su nombre. Normalmente lo elegirás de una lista en AffClix, pero conviene saber cuál es el correcto.

03

Copia un código de prueba (opcional)

Abre la pestaña Test events del conjunto de datos y copia el código, por ejemplo TEST12345. AffClix lo usa solo para el botón Send test event; las conversiones reales nunca lo llevan.

04

Comprueba tu acceso

Asegúrate de que la cuenta de Facebook que vas a conectar puede gestionar este conjunto de datos. Si pertenece al negocio de un cliente, pídele que te lo asigne a ti o al negocio de tu agencia.

¿Sin acceso al Business Manager?

También puedes conectar pegando un token de acceso de la API de Conversiones: Administrador de eventos → tu conjunto de datos → Settings → Conversions API → Generate access token. Consulta el paso 2.

Paso 2: Conecta Facebook en AffClix

01

Abre Conversions API

Ve a Integrations → Conversions API y haz clic en Add destination.

02

Elige Meta CAPI

Selecciona la tarjeta Meta CAPI y ponle un nombre al destino, como Meta – Conjunto principal. Deja Campaign ID vacío para enviar las conversiones de todas las campañas, o introduce el ID de una campaña.

El selector de plataforma del formulario de nuevo destino, con la tarjeta Meta CAPI.
Elige Meta CAPI; el formulario se adapta a ella.
03

Conecta Facebook

Haz clic en Connect Facebook e inicia sesión con la cuenta de Facebook que gestiona el conjunto de datos. Aprueba los permisos que pide Meta: AffClix necesita el permiso de anuncios para enviar eventos. AffClix nunca ve tu contraseña.

La tarjeta de credenciales de Meta con el botón Connect Facebook, la lista «Get these from Meta first» y el campo del token de acceso.
Conecta Facebook, o pega y verifica un token de acceso.
04

Elige el conjunto de datos

De vuelta en AffClix verás Facebook connected. Elige el conjunto de datos en Pixel / Dataset ID. Si no aparece, escribe su ID en ese mismo campo.

05

O pega un token de acceso

Si no aparece Connect Facebook, o prefieres tu propio token de usuario del sistema, pégalo en Access token, haz clic en Verify token & load pixels y elige el conjunto de datos. El indicador de pasos muestra Paste access token → Verify token → Choose dataset.

El inicio de sesión de Facebook dura unos 60 días

Meta concede el acceso conectado durante unos 60 días y no lo renueva automáticamente. Antes de que caduque, abre el destino y haz clic en Reconnect Facebook; el conjunto de datos y la asignación se mantienen. AffClix también te avisa si Meta empieza a rechazar eventos.

Paso 3: Asigna tus objetivos a eventos de Meta

En Meta, el nombre del evento importa: es el evento que Meta registra y con el que optimiza. Usa los nombres de evento estándar de Meta siempre que encajen.

01

Asigna cada objetivo

En Event Mapping & Matching, elige un objetivo en Your goal e introduce el evento de Meta en Platform event; por ejemplo, venta → Purchase, lead → Lead, registro → CompleteRegistration.

La tarjeta Event Mapping & Matching con objetivos asignados a eventos de Meta y las opciones de claves de coincidencia.
Asigna objetivos a los eventos estándar de Meta y elige qué señales se comparten.
02

Decide si quieres un comodín

Una fila con el objetivo * recoge todos los objetivos que no hayas asignado. Elimínala si solo deben enviarse los objetivos de la lista.

03

Elige las claves de coincidencia

En Match keys to send, deja todo sin seleccionar para enviar todas las señales disponibles, o marca solo lo que permita tu política de consentimiento. Más señales significan una mayor calidad de coincidencia de eventos (EMQ) en el Administrador de eventos.

Un objetivo sin fila no se envía

Si un objetivo no tiene fila propia y no hay fila *, sus conversiones se omiten en este destino. Así puedes, por ejemplo, mantener los leads fuera de un conjunto de datos solo de compras.

Las claves de coincidencia, de un vistazo

Click IDs envía el ID de clic basado en fbclid; fbc / fbp envía las cookies de navegador de Meta; IP + UA envía la dirección IP y el navegador del visitante; Geo envía ciudad, región, código postal y país (cifrados); External ID envía tu ID de cliente (cifrado). AffClix no guarda correos electrónicos ni teléfonos, así que nunca se envían.

Paso 4: Guarda y prueba

01

Guarda

Comprueba que Active está activado y haz clic en Create destination.

02

Envía un evento de prueba

Introduce un Test event code en el destino, guarda y haz clic en Send test event en la lista de Conversions API. AffClix envía un Purchase de prueba, que aparece en menos de un minuto en Administrador de eventos → tu conjunto de datos → Test events. Este botón requiere un código de evento de prueba.

03

Confirma los eventos reales

Tras la siguiente conversión aprobada, busca una fila Delivered en Reports → Delivery Logs → CAPI Delivery, y comprueba en Administrador de eventos → Overview que llegan eventos de servidor desde la API de Conversiones.

Ejemplo real

Una marca de moda promociona su tienda con creadores de Instagram y lanza campañas de compras Advantage+ sobre el mismo conjunto de datos. Muchos de sus compradores usan iPhone.

  1. Un comprador sigue desde Instagram el enlace de AffClix de un creador. AffClix registra el clic, incluido el ID de clic de Meta.
  2. El comprador adquiere una chaqueta por 89 €, pero la privacidad de Safari impide que el píxel informe de la compra.
  3. El postback de la marca registra la venta en AffClix y la venta se aprueba.
  4. AffClix envía un evento Purchase al conjunto de datos con valor 89, moneda EUR, el ID de clic y la ubicación cifrada, y el ID de conversión como ID de evento.

Resultado: Meta cuenta la compra que el píxel no vio, la atribuye a la campaña correcta y optimiza la entrega con ventas reales. Cuando el píxel sí se activó con el mismo ID de evento, Meta conserva una sola compra.

Gestión y supervisión de la integración

  • Pausar sin eliminar: usa el interruptor de la fila del destino o desactiva Active.
  • Renovar el acceso: vuelve a conectar Facebook antes de que caduque el acceso de unos 60 días; el destino conserva su conjunto de datos y su asignación.
  • Alertas de credenciales: AffClix revisa cada destino cada hora. Si Meta empieza a rechazar eventos porque un token caducó o se revocó, la fila muestra Reconnect credentials y se envía un correo al propietario del espacio de trabajo.
  • Calidad de coincidencia de eventos: el Administrador de eventos puntúa cada evento de servidor. Permite más claves de coincidencia para mejorarla.
  • Estado de CAPI en cada conversión: el informe de conversiones incluye una columna CAPI con Delivered, Failed o Partial.

Registros de CAPI Delivery

Cada intento queda registrado en Reports → Delivery Logs → CAPI Delivery. Filtra por fecha, plataforma, destino y estado.

El informe CAPI Delivery con los intentos de envío: plataforma, evento, estado y código de respuesta.
Reports → Delivery Logs → CAPI Delivery registra cada intento.
ColumnaQué indica
Platform / EventEl destino y el evento de Meta enviado, por ejemplo Purchase.
StatusDelivered, o Failed con el motivo.
Response codeEl código de estado HTTP que devolvió Meta.
Attempts / RetryableCuántos intentos se hicieron y si el fallo fue temporal y se reintentará.
ErrorEl mensaje de error de Meta, con su ID de seguimiento para solicitudes de soporte.

Solución de problemas

SíntomaCausa probableQué hacer
La lista de conjuntos de datos está vacíaLa cuenta de Facebook no ve el conjunto de datos, o el negocio solo lo comparte mediante una asignación de activos.Escribe el ID del conjunto de datos en el campo, o pide a su propietario que te lo asigne.
«This login did not grant ads_management»Se rechazó el permiso de anuncios en la pantalla de consentimiento de Facebook.Haz clic en Reconnect Facebook y aprueba todos los permisos que pide Meta.
Send test event fallaEl destino no tiene código de evento de prueba.Copia el código de Administrador de eventos → Test events, guárdalo en el destino y vuelve a intentarlo.
La fila muestra Reconnect credentialsEl acceso de Facebook caducó (unos 60 días) o se revocó el token.Abre el destino y haz clic en Reconnect Facebook, o pega un token nuevo.
Meta cuenta las compras dos vecesEl píxel del sitio informa de la compra con otro ID de evento.Haz que el sitio pase el ID de conversión de AffClix como ID de evento del píxel, o usa solo el evento de servidor.
Las conversiones están en AffClix pero no en MetaAún no están aprobadas, o su objetivo no tiene fila en el mapa de eventos y no hay fila *.Aprueba las conversiones o añade una asignación para el objetivo.

Conclusión

Con Meta conectado, cada conversión aprobada que generan tus partners llega a tu conjunto de datos desde el servidor —con el nombre de evento correcto, el valor real y las señales de identidad que permitas—, de modo que Meta informa y optimiza con ventas reales. Renueva el acceso de Facebook cada par de meses y vigila el informe CAPI Delivery.

Nota

Solo se envían a Meta las conversiones aprobadas. Las pendientes, rechazadas o recortadas nunca se envían; una conversión aprobada más tarde se envía en el momento en que se aprueba.

Relacionado: Descripción general de la Conversions API · API de Conversiones de Google Ads · Meta Ads con el WebSDK

Rate this article
★★★★★
Thanks for rating!

Was this article helpful?