Meta Conversions API para enlaces cortos: qué funciona hoy

Elido no reenvía conversiones a la Conversions API de Meta hoy. Si has llegado aquí desde la lista de integraciones esperando un interruptor que activar, no hay ninguno, y prefiero decirlo desde el principio antes que mandarte por un camino de configuración que no lleva a ninguna parte. Lo que sigue es lo que Elido sí registra, lo que exige la documentación de Meta (consultado el 2026-10-25) y cómo construir tú mismo la llamada del servidor, con o sin un enlace corto en el camino.

Resumen: Elido te da clics por enlace y, para Shopify y Stripe, ingresos por enlace. Meta quiere un evento con un event_id, datos del cliente con hash y, idealmente, el ID de clic fbc. Eso lo ensamblas tú.

Qué hace y qué no hace Elido por Meta hoy

Este es el estado del código, comprobado en el repositorio el 2026-10-25:

• ID de píxel de Meta: un espacio de trabajo puede guardar uno. Se usa para el píxel del navegador en las páginas splash e intersticiales de Elido. Es una etiqueta del lado del navegador, no CAPI.
• Llamada de Meta desde el servidor: el pipeline de clics contiene una ruta de código de Meta que enviaría un PageView con IP y user agent. Solo se ejecuta cuando existen un ID de píxel y un token de acceso, y los ajustes nunca guardan un token, así que nunca se dispara.
• Conversiones: los pedidos llegan solo mediante webhooks de Shopify y Stripe y se vinculan a un enlace por un valor elido_link_id que tú pasas. No hay un endpoint público de conversiones ni cabecera o cookie de ID de clic.
• fbclid: Elido no lo captura ni lo reenvía.

La página de la función de seguimiento de conversiones describe el mismo modelo de webhooks. Trata cualquier artículo antiguo que prometa un reenvío a Meta con una sola llamada como la descripción de un plan, no de un producto.

Espacio de trabajo de demostración con datos de ejemplo sintéticos, no resultados de clientes.

Esa pantalla sigue siendo útil junto a Meta. Los ingresos por campaña de tus propios pedidos contrastan lo que afirma Ads Manager. Los dos rara vez coinciden al céntimo.

Cómo funciona la Conversions API de Meta

Según la documentación de la Conversions API de Meta (consultado el 2026-10-25), envías un POST a https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events con un token de acceso. El ejemplo actual de la documentación usa v26.0. Unos cuantos límites que conviene conocer antes de escribir código:

• Una petición puede llevar hasta 1.000 eventos.
• event_time puede tener hasta 7 días de antigüedad. Si algún evento del lote es más antiguo, Meta rechaza toda la petición.
• Envía un event_id con cada evento. Si Meta ve el mismo event_id y event_name dos veces, conserva la primera copia, lo que hace seguros los reintentos.

Para el token, la guía de primeros pasos de Meta (consultado el 2026-10-25) recomienda generarlo en Events Manager: elige el píxel, abre Ajustes y usa "Generate access token" en la sección Conversions API. Ese enlace solo es visible para los usuarios con privilegios de desarrollador del negocio. Guarda el token en un secreto del servidor.

Constrúyelo tú mismo, paso a paso

Los pasos son los mismos tanto si el clic vino de un enlace corto, de un código QR o de un anuncio directo.

1. Conserva el ID de clic. La guía de fbp y fbc de Meta (consultado el 2026-10-25) dice que leas fbclid de la URL de destino en el servidor cuando esté presente y lo formatees como fb.1.<creation time in ms>.<fbclid>. Guárdalo como el valor fbc junto con la sesión del visitante y cópialo después al pedido. Guarda también el valor de la cookie _fbp si el píxel puso una.
2. Elige el ID del evento. Usa el ID del pedido, y usa la cadena idéntica en la llamada del píxel del navegador (eventID) y en el evento del servidor (event_id). Dos formatos distintos para el mismo pedido, como ord_98231 y 98231, no se deduplicarán.
3. Normaliza y aplica hash. Según los parámetros de información del cliente de Meta (consultado el 2026-10-25), el correo se recorta y se pasa a minúsculas, y luego se le aplica SHA-256. Los teléfonos pierden símbolos, letras y ceros iniciales y deben incluir el prefijo del país antes del hash. fbc, fbp y client_ip_address nunca llevan hash.
4. Envía el evento cuando se pague el pedido, desde tu backend o desde el gestor de webhooks de pedidos.
5. Verifica en Test Events y luego quita el código de prueba.

Un ejemplo mínimo en Node:

import { createHash } from "node:crypto";

const sha256 = (v) => createHash("sha256").update(v).digest("hex");

const event = {
  event_name: "Purchase",
  event_time: Math.floor(Date.now() / 1000),
  event_id: order.id, // same string the browser pixel uses as eventID
  action_source: "website",
  event_source_url: order.thankYouUrl,
  user_data: {
    em: [sha256(order.email.trim().toLowerCase())],
    fbc: order.fbc,
    fbp: order.fbp,
    client_ip_address: order.ip,
    client_user_agent: order.userAgent,
  },
  custom_data: { currency: "EUR", value: 89.5 },
};

await fetch(
  `https://graph.facebook.com/v26.0/${PIXEL_ID}/events?access_token=${TOKEN}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ data: [event] }),
  },
);

Añade test_event_code al cuerpo mientras pruebas. No registres en los logs la URL completa en producción, porque contiene el token.

Deduplicación y Test Events, las dos trampas

La guía de deduplicación de Meta (consultado el 2026-10-25) describe la coincidencia por event_id más event_name, comparando el eventID del píxel con el event_id del servidor, dentro de una ventana de 48 horas. Dice que esto funciona sobre todo cuando el evento del navegador llega primero y el del servidor lo sigue. También dice que no hay deduplicación alguna si solo usas una fuente.

La herramienta Test Events tiene una trampa. El test_event_code está pensado solo para pruebas, y la página using the API de Meta afirma que los eventos enviados con él no se descartan: llegan a Events Manager y se usan para la segmentación y la medición. Así que una compra de prueba "inofensiva" de 500 EUR cuenta igualmente. Envía unos pocos eventos de prueba pequeños y quita el código de la carga de producción.

Después de empezar a enviar, Meta dice que deberías poder verificar los eventos en unos 20 minutos en la vista general de Events Manager. Comprueba que el nombre del evento coincide con el que envía tu píxel y que el evento muestra datos de usuario coincidentes.

Dónde encaja un enlace corto

Un enlace corto no cambia cómo funciona CAPI. Importa en dos sitios, y solo en dos.

Primero, el ID de clic. Meta añade fbclid a la URL de destino que fijas en el anuncio. Si ese destino es un enlace corto, el parámetro llega al enlace corto. No encontré ningún código en la ruta de redirección de Elido que copie la cadena de consulta entrante al destino. Así que, para los anuncios de Meta, apuntaría el anuncio a la URL final de la página de destino con UTM y reservaría los enlaces cortos para correo, SMS, códigos QR y publicaciones orgánicas. Si de verdad quieres un enlace corto en un anuncio, pruébalo antes con un ?fbclid=test ficticio y comprueba qué recibe tu página de destino.

Segundo, los informes. Etiqueta el checkout de Shopify o Stripe con elido_link_id. El informe de conversiones de Elido muestra entonces los ingresos por enlace y campaña, a partir de tus propios pedidos. El tutorial de Shopify cubre el lado de los webhooks. Para el panorama más amplio de por qué contar solo en el navegador pierde eventos, consulta el seguimiento de conversiones en el servidor y la atribución sin cookies explicada.

Consentimiento y privacidad

El hash no es anonimización. Un hash SHA-256 de una dirección de correo sigue siendo un dato personal bajo el RGPD, porque Meta puede cotejarlo con sus propios registros. En la UE necesitas una base jurídica, que para la medición publicitaria suele ser el consentimiento, y la llamada del servidor debe respetar la misma elección que hizo el visitante en tu banner. Consent Mode v2 para el seguimiento y Schrems II y los píxeles de seguimiento tratan las cuestiones de consentimiento y transferencia. Si un visitante lo rechazó, no envíes nada.

Qué falta en Elido

Reenviar compras a Meta con una sola llamada, capturar fbclid en la redirección y un campo de token de acceso en los ajustes de Meta están sin construir. Están registrados en el backlog del producto, y este artículo cambiará cuando se publiquen. Hasta entonces, la configuración honesta es la anterior: tu servidor envía el evento, y Elido aporta los datos de clics e ingresos a nivel de enlace a su alrededor.

Relacionado en el blog

• Seguimiento de conversiones en el servidor
• ID de clic: gclid y fbclid
• Rastrea las UTM de principio a fin
• Retargeting con enlaces, explicado
• Acortador de URL para Shopify