Seguimiento de conversiones server-side en 2026: guía práctica de la API de conversiones para Meta, Google y los anuncios de ChatGPT

Respuesta breve: una API de conversiones es la interfaz que hay detrás del seguimiento de conversiones server-side. Envía eventos de conversión, como una venta, el envío de un formulario o un registro, desde su propio servidor a una plataforma publicitaria, en lugar de hacerlo desde el navegador del visitante. En Meta se llama API de conversiones (CAPI). En Google, las conversiones avanzadas y la Data Manager API cumplen la misma función, y los anuncios de ChatGPT usan la Conversions API de OpenAI. Meta recomienda usar la CAPI junto con el Pixel, no en su lugar: el mismo evento llega tanto desde el navegador como desde el servidor, y un ID de evento compartido (event_id) sirve para deduplicarlo. El verdadero valor de una configuración server-side es que los datos que reciben las plataformas proceden de sus registros de pedidos y de su CRM, no del navegador.

Hemos redactado esta guía para responsables de marketing y de software de empresas de comercio electrónico y B2B que invierten con regularidad en publicidad en Meta y Google y que tienen un sitio web o un CRM a medida (Laravel, Node.js, .NET) o cierran sus ventas offline. Si vende en Turquía o trabaja con socios turcos, también le resultarán útiles las secciones sobre los datos de clientes turcos y sobre la KVKK, Ley turca n.º 6698 de Protección de Datos Personales. Hemos verificado los datos con la documentación de Meta, Google y OpenAI y con la legislación turca de protección de datos, e indicamos las fuentes secundarias por separado. Este artículo está actualizado a fecha de 31 de octubre de 2026.

¿Qué es una API de conversiones y en qué se diferencia el seguimiento de conversiones server-side del Pixel?

El Pixel es un fragmento de JavaScript que envía el evento desde el navegador del visitante. Un bloqueador de anuncios, una restricción del navegador o una página que no termina de cargarse pueden hacer que el evento se pierda por el camino. Con una API de conversiones, su servidor crea el evento y lo envía directamente a la API de la plataforma. Así también puede enviar eventos que el navegador nunca ve, como la confirmación de un pago, una venta cerrada en una tienda o un lead (cliente potencial) marcado como “cualificado” en su CRM.

¿Qué es Meta CAPI? Es la interfaz server-side de eventos de Meta. También se busca como “Facebook Conversion API”. El Centro de ayuda de Meta en turco la llama “Dönüşümler API’si”, un dato útil si su equipo o su agencia en Turquía usa Meta en turco. Meta recomienda usar la CAPI junto con el Pixel; su documentación para desarrolladores llama a esto “redundant setup” (configuración redundante). Si el eventID del Pixel coincide con el event_id de la CAPI y los nombres de los eventos son iguales, las dos copias cuentan como un solo evento. Esta deduplicación por event_id funciona en las 48 h posteriores a la recepción del primer evento con ese ID, y Meta suele conservar la copia que llega primero. El método alternativo, basado en fbp o external_id, por lo general solo puede hacer coincidir los eventos cuando la copia del navegador llega antes que la del servidor. Por eso, asigne a cada evento un event_id único.

En Google, el equivalente tiene dos partes: las conversiones avanzadas (enhanced conversions), que envían junto con la conversión un correo electrónico y un número de teléfono con hash, y la Data Manager API, que ahora es la vía principal para importar conversiones offline. En los anuncios de ChatGPT, la Conversions API de OpenAI funciona con el mismo principio.

¿Plugin listo para usar, configuración en un clic o integración a medida de la API de conversiones?

No todas las empresas necesitan una configuración a medida. El 15 de abril de 2026, Meta anunció una configuración de la CAPI en un clic para eventos web que no requiere conocimientos técnicos, costo ni mantenimiento; las configuraciones existentes, tanto de partners como a medida, no cambian. Según PPC Land, esta configuración solo cubre la web y no permite elegir qué eventos y parámetros envía: todo lo que envía el Pixel sale también desde el servidor. Los eventos de apps y los eventos offline necesitan una integración aparte. La extensión “Facebook Conversion API” de ikas, una plataforma turca de comercio electrónico, y los niveles de uso compartido de datos de Shopify que utilizan la CAPI son otras opciones listas para usar.

En un sistema de comercio electrónico a medida, lo más limpio es crear el evento a partir de la tabla de pedidos. Analizamos una decisión parecida entre solución lista para usar y desarrollo a medida en nuestro artículo sobre cómo conectar una tienda online con el ERP y la factura electrónica.

¿Qué cambió en Meta, Google y OpenAI en 2026?

La mayoría de los cambios vienen de Google. La fila del 12 de noviembre se basa en fuentes secundarias.

12 de noviembre de 2026: ¿qué cambia el ajuste de Meta “medir conversiones en los dispositivos de los clientes”?

Meta tiene en su Centro de ayuda un artículo titulado “About measuring conversions on customer devices” (acerca de la medición de conversiones en los dispositivos de los clientes). Los detalles proceden de publicaciones especializadas que citan el texto del panel del Administrador de eventos (Events Manager) y el correo electrónico de Meta a los anunciantes. Según PPC Land, el Administrador de eventos muestra “Measurement starting November 12, 2026” bajo la opción “Measure conversions on customer devices”. El ajuste está activado de forma predeterminada en los conjuntos de datos que envían eventos. Puede desactivarlo por conjunto de datos en cualquier momento y no requiere cambios en el código. Según ese mismo informe, el despliegue será gradual a partir del 12 de noviembre. Según MetricMaven, que cita a Meta, la coincidencia se realiza en el dispositivo del cliente. Meta solo sabe que se produjo una compra y a qué campaña se atribuye la conversión. La ventana y el modelo de atribución no cambian.

Según MetricMaven y Stape, la función no está activa para personas que se encuentran en la UE y el Reino Unido. También hay condiciones de elegibilidad, como que el sitio web exija iniciar sesión con un correo electrónico o un número de teléfono. Si esto es correcto, las tiendas con compra como invitado podrían quedar fuera de su alcance. Los puntos que Meta aún no ha explicado son críticos: cómo se deduplicarán las compras recuperadas frente a los eventos de la CAPI, el efecto en las pujas, cómo se gestiona el consentimiento y si se transmiten el valor y la moneda. El momento también es delicado: el 12 de noviembre cae justo después de las campañas del 11.11 (Singles’ Day) y 15 días antes del Black Friday del 27 de noviembre. Nuestro consejo es decidir a partir de la medición y no desactivar el ajuste a ciegas. Esta es nuestra lista de comprobación, en línea con las fuentes del sector:

1. Registre el estado actual: anote, para cada conjunto de datos, si el ajuste está activado o desactivado. Agregue una marca del 12 de noviembre a sus paneles y a sus informes del 11.11 y del Black Friday.
2. Fije una línea de base: calcule, para cada día anterior al 12 de noviembre, la relación “compras declaradas por Meta ÷ pedidos reales”. Después, siga esta relación y cualquier pico de doble conteo durante cuatro a seis semanas.
3. Prepare un holdout: use un grupo de control por región o por campaña para contrastar el incremento declarado con los pedidos reales.
4. En sectores regulados, una opción es desactivar el ajuste hasta que concluya una revisión legal y dejar constancia del motivo.

Configuración de la API de conversiones: cómo implementar paso a paso el seguimiento de conversiones server-side

En nuestra arquitectura de referencia, el registro del pedido o del CRM es la fuente de verdad. Meta, Google y, opcionalmente, OpenAI se alimentan de un único flujo de eventos que se genera a partir de este registro y que incluye el estado del consentimiento. Genere el token de acceso (el token de Meta CAPI) en el Administrador de eventos, en la sección API de conversiones de la pestaña Configuración del Pixel. Solo los usuarios con acceso de desarrollador a la empresa pueden ver este enlace. Mantenga el token en secreto en el servidor.

1. Cree el evento a partir del registro. Una compra se produce cuando se verifica la notificación de pago y se confirma el pedido, no cuando se carga la página de “gracias”. Tratamos este paso en nuestra guía de webhooks de POS virtual (pago con tarjeta en línea).
2. Capture los ID de clic. Para Meta: fbc, generado a partir de fbclid (fb.${subdomain_index}.${creation_time}.${fbclid}), y fbp. Para Google: gclid, gbraid y wbraid. Para OpenAI: la cookie __obref, si sus reglas de consentimiento lo permiten. Estos ID, la dirección IP y el agente de usuario se envían sin hash.
3. Use un único ID de evento. Utilice el número de pedido como eventID del Pixel, event_id de la CAPI, transactionId de Google y campo id de OpenAI.
4. Incluya el consentimiento en el evento. Guarde con el evento la elección del usuario en ese momento. La Data Manager API dispone para ello de los campos adUserData y adPersonalization.
5. Normalice y aplique hash (vea la sección siguiente).
6. Ponga el evento en cola y envíelo de forma idempotente. El evento se escribe en una cola, un proceso worker lo envía y, si el envío falla, lo reintenta a intervalos crecientes. Los reintentos no provocan doble conteo. Meta y OpenAI conservan la primera de las copias que llegan con la misma clave. Google trata un ID de transacción conocido como un ajuste, no como una conversión nueva, y no aumenta el recuento de conversiones.
7. Pruebe y concilie. En Meta, use test_event_code (elimínelo en producción); en Google, validateOnly y requestStatus.retrieve; en OpenAI, validate_only. Una vez en producción, compare a diario el informe de la plataforma con sus pedidos reales.

Reglas de envío por plataforma

Trampas de normalización y hash con datos turcos

Las tres plataformas exigen que los correos electrónicos y los números de teléfono se envíen con hash SHA-256. Un solo carácter distinto produce un hash completamente diferente. Por eso, un error de normalización es una pérdida silenciosa de coincidencias que nunca muestra un mensaje de error.

• Los números de teléfono no se escriben igual en todas partes. El teléfono móvil turco 0532 123 45 67, escrito aquí en formato nacional, se normaliza como 905321234567 antes de aplicar el hash para las API de conversiones de Meta y OpenAI (se elimina el cero inicial, se agrega el código de país, sin “+”). Para la Data Manager API de Google y las cargas de audiencias de OpenAI, pasa a ser +905321234567 (E.164). La propia OpenAI advierte que no debe suponerse que la regla de teléfono de una API se aplica a otra.
• Pasar a minúsculas la İ y la I turcas cambia el hash. El turco tiene un par de letras con punto (İ/i) y otro sin punto (I/ı). Según la regla predeterminada de Unicode, al pasar “İ” a minúsculas se obtiene “i̇”, de dos caracteres (i + U+0307). Solo una configuración regional turca convierte “İ” en una “i” simple e “I” en “ı”. En nuestra prueba, "İLKER".lower() de Python devolvió “i̇lker”, y su hash no coincidió con el de “ilker”. "IŞIK".lower() devolvió “işik” en lugar del turco “ışık”. Desde PHP 8.2, strtolower() solo pasa a minúsculas las letras ASCII, por lo que deja “İ” y “Ş” sin cambios. mb_strtolower(), que usa el helper Str::lower() de Laravel, convierte “İ” en “i̇”. Lo contrario es igual de arriesgado: con una configuración regional turca (toLocaleLowerCase('tr') en JavaScript, ToLower() con la cultura tr-TR en .NET), “[email protected]” se convierte en “ılker@fırma.com”.
• Reglas distintas para correos electrónicos y nombres. En los correos electrónicos, pase el texto a minúsculas de forma independiente de la configuración regional y convierta antes “İ” en “i”. Cuando el teclado de un teléfono móvil pone en mayúscula la primera letra según la regla turca, la dirección puede guardarse como “İlker@…”. En los nombres, las reglas varían: Meta recomienda a–z pero acepta UTF-8, OpenAI pide mantener los acentos y Google los quiere en minúsculas y sin títulos. No está documentado qué forma de los caracteres turcos coincide mejor, así que haga pruebas con sus propios datos.
• La regla de Gmail solo se aplica en Google: en las direcciones gmail.com y googlemail.com, elimine los puntos anteriores a la @ y elimine el signo “+” junto con todo lo que le sigue hasta la @. Las reglas de Meta y OpenAI no incluyen este paso. OpenAI pide expresamente que no se eliminen los puntos ni las etiquetas con “+” en las cargas de audiencias.
• No confunda liras y kuruş. Google exige que el valor cargado tenga el mismo formato y la misma unidad que la etiqueta. Advierte que una unidad distinta, como los centavos o céntimos en número entero (en la lira turca, el kuruş: 100 kuruş equivalen a 1 lira), provoca una “grave inflación del valor de conversión” y que el sistema no convierte la unidad por sí solo. Si se envían tal cual 24990 kuruş, un pedido de 249,90 TL (liras turcas) aparece como 24 990 TL.

Mantenemos la normalización en una única función con pruebas unitarias. Ejemplos de vectores de prueba: “ İ[email protected]” → [email protected] y, para Google, “[email protected]” → [email protected].

Google Data Manager API, conversiones offline y calidad de los leads desde su CRM

Google: conversiones avanzadas y Data Manager API

Según el calendario de Google, desde junio de 2026 las conversiones avanzadas para web y para clientes potenciales son un único ajuste que se activa o se desactiva, y puede desactivarlas para acciones de conversión concretas. Google describe la Data Manager API como la vía principal para importar conversiones offline, por lo que iniciamos los proyectos nuevos directamente con ella. Puntos que debe vigilar al migrar:

• No se requiere token de desarrollador (y, desde el 9 de septiembre de 2026, la Google Ads API también ignora el token). Las cuotas están vinculadas al proyecto de Google Cloud.
• operating_account debe ser la cuenta propietaria de la acción de conversión. No se aceptan cuentas superiores ni subordinadas.
• Las cargas y los ajustes pasan por la misma llamada IngestEvents. Enviar un ID de transacción existente con un valor nuevo cuenta como ajuste. Sobre las retractaciones, la documentación es contradictoria: la guía de actualización y la página de ajustes indican que solo se puede corregir el valor y que el recuento de conversiones no cambia, mientras que la página de conversiones offline habla de retractaciones. Pruebe su escenario de reembolso antes de la puesta en marcha.
• Envíe el GCLID con cada evento siempre que sea posible. Es obligatorio si no recopila datos de usuario con la etiqueta.

La verdadera novedad son las conversiones multifuente (beta). Puede agregar su CRM o su base de datos de pedidos como segunda fuente a una conversión web configurada manualmente con la etiqueta de Google o con GTM. Los registros se deduplican por ID de transacción. En los eventos coincidentes, la fuente agregada sobrescribe el valor de la etiqueta y pasa a ser la única fuente de verdad para el valor. Durante la primera prueba de 14 días, las actualizaciones de valor están desactivadas y las conversiones nuevas no se usan para las pujas.

Meta: cómo enviar de vuelta las etapas de los leads desde el CRM

Para obtener los mejores resultados con la integración Conversion Leads, Meta recomienda guardar en su CRM el Meta Lead ID de 15 a 17 dígitos. Sin él, se envía en su lugar el ID de clic, el número de teléfono o el correo electrónico. Los requisitos: al menos 200 leads al mes; la etapa para la que se optimiza debe producirse en los 28 días posteriores al lead y convertir con una tasa de entre el 1 % y el 40 %; y cargas al menos una vez al día. Meta sitúa el periodo de aprendizaje entre 2 y 4 semanas. En B2B con ciclos de venta largos, cerrar un acuerdo puede llevar más de 28 días. Por eso, quizá deba optimizar para una etapa anterior, como “lead cualificado” en lugar de “ganado”. El mismo cambio de etapa llega a Google a través de la Data Manager API, con el GCLID y el correo electrónico con hash, como conversión avanzada para clientes potenciales. En nuestros proyectos de CRM y ERP, diseñamos los campos de etapa con esta necesidad en mente desde el principio.

La KVKK y el consentimiento: ¿qué preguntas debe plantear a su equipo legal?

Esta sección no constituye asesoramiento jurídico. KVKK es la abreviatura habitual de la Ley de Protección de Datos Personales de Turquía (Ley n.º 6698) y de la autoridad que la aplica. El Consejo de esta autoridad emite decisiones de principio.

• ¿Están separados el aviso informativo y el consentimiento explícito? Según la decisión de principio 2026/347 del Consejo, el aviso informativo (aydınlatma) debe facilitarse antes del tratamiento, sea cual sea la base jurídica. Si se apoya en el consentimiento explícito (açık rıza), los dos textos se redactan por separado, con títulos distintos. Si se apoya en otra base jurídica, no se presenta ningún texto de consentimiento explícito.
• ¿Cuál es la base para transferir datos al extranjero? El artículo 9 de la Ley, en la redacción vigente desde el 1 de junio de 2024, exige una condición de tratamiento y, además, primero una decisión de adecuación o, a falta de ella, garantías adecuadas como un contrato estándar. El contrato estándar debe notificarse a la Autoridad en un plazo de cinco días hábiles desde su firma. El consentimiento explícito es solo una vía excepcional para las transferencias “ocasionales” (arızi). El Reglamento de aplicación define una transferencia ocasional como aquella que no es regular, ocurre una sola vez o unas pocas veces, no es continua y no forma parte del curso normal de la actividad. ¿Encaja en esa definición un flujo de datos que se ejecuta con cada pedido?
• ¿El hash es anonimización? La finalidad del hash es relacionar a la persona con una cuenta en la plataforma; Google también compara los datos con hash con las cuentas que han iniciado sesión. Tratamos el hash como una medida de seguridad, no como anonimización.
• ¿Cuál es el ajuste de consentimiento predeterminado? El Pixel de OpenAI inicializa el consentimiento como true de forma predeterminada. Donde se requiera consentimiento, llame a oaiq('consent', false) antes de init.
• ¿Se dirige con sus anuncios a usuarios en Europa? La política de consentimiento de usuarios de la UE de Google abarca a los usuarios del Espacio Económico Europeo, el Reino Unido y Suiza. Exige un consentimiento válido para recopilar, compartir y usar datos personales con fines de personalización de anuncios. Un exportador con sede en Turquía que llega a usuarios de Alemania mediante productos de Google entra en el ámbito de la política en lo que respecta a esos usuarios. Para el tráfico procedente de Turquía, el marco lo establece la KVKK.

Antes de diseñar la integración, aclare su inventario de datos y sus garantías con una revisión de cumplimiento RGPD y KVKK.

Cómo le ayuda Partnerfy

No vemos una API de conversiones como la instalación de una etiqueta. La vemos como un proyecto de integración que parte de sus datos de pedidos y de su CRM. Primero auditamos sus eventos actuales del Pixel y del servidor. Después, mapeamos el esquema de eventos con Meta, Google y, si es necesario, OpenAI, y fijamos con vectores de prueba la estrategia de event_id y las reglas de normalización. Construimos la capa de envío sobre su stack (por ejemplo, Laravel, Node.js o .NET) con cola, reintentos idempotentes y supervisión de errores, y hacemos que el estado del consentimiento forme parte del evento. Tras la puesta en marcha, también configuramos una vista de conciliación y supervisión que compara los informes de las plataformas con sus pedidos reales. Encontrará los detalles en nuestra página de integraciones de API de conversiones. Para revisar juntos su configuración actual, póngase en contacto con nosotros.

Fuentes

• Meta for Developers: deduplicación, parámetros de información del cliente, uso de la API, token de acceso, Conversion Leads
• Meta: anuncio del 15 de abril de 2026; Centro de ayuda para empresas: acerca de la API de conversiones, acerca de la medición de conversiones en los dispositivos de los clientes
• Google Ads API: obsolescencias, token de desarrollador, blog para desarrolladores, 15 de mayo de 2026
• Ayuda de Google Ads: conversiones avanzadas para clientes potenciales, actualizaciones de los ajustes de conversiones avanzadas, conversiones multifuente
• Google Data Manager API: guía de actualización, conversiones offline, ajustes, events.ingest, modelo de errores, formato, Consent; Google: política de consentimiento de usuarios de la UE
• OpenAI Ads: Conversions API, Measurement Pixel, Custom Audiences, segmentación, registro de cambios, disponibilidad de Ads Manager
• KVKK (en turco): anuncio sobre la decisión de principio 2026/347, Ley n.º 6698; Resmî Gazete (Boletín Oficial de Turquía, en turco): reglamento sobre las transferencias de datos personales al extranjero
• Fuentes técnicas: Unicode SpecialCasing, MDN, Microsoft Learn, PHP strtolower; plataformas listas para usar: ikas, Shopify
• Fuentes secundarias: PPC Land, 27 de octubre de 2026, PPC Land, 27 de abril de 2026, Stape, 22 de octubre de 2026, MetricMaven, 19 de octubre de 2026

Preguntas frecuentes