Conversiones para Meta y Google Ads

Avísale a Meta y a Google Ads qué compras, citas y leads salieron de tus anuncios, pasando por la compuerta que decide qué califica.

Cuando un anuncio trae a alguien que termina comprando, agendando o dejando sus datos, la plataforma de anuncios necesita saberlo para optimizar. Con met.conversions le reportas ese hecho desde tu sistema —el que sabe que el pago entró— y Met lo lleva a Meta (Conversions API) y a Google Ads.

No emites directo. Todo lo que reportas pasa por la compuerta de conversiones, la misma por la que pasan las que proponen el Met y los flujos. La compuerta revisa que haya un anuncio detrás, que el evento esté en la lista del negocio y que el hecho esté respaldado, y te dice qué decidió. Es lo que evita que una integración con un error infle los resultados de las campañas.

Hay dos caminos:

Antes de empezar

• Tu key necesita conversions:write. No funciona con una key de test (403 test_mode_restricted): cada conversión aceptada es un evento real en la cuenta de anuncios.
• El negocio tiene que tener las conversiones encendidas en el panel, con su lista de eventos. Sin eso, todo sale discarded con reason: "integration_inactive".
• Los dos métodos devuelven 201 aunque la compuerta descarte: lee decision siempre.

Una conversión de un contacto

const r = await met.conversions.report({
  contact_id: 4821,
  event_name: 'Purchase',
  value: 250000,
  currency: 'COP',
  bucket: 'pedido-10293',
});

if (r.decision !== 'accepted') console.log('No salió:', r.decision, r.reason);

r = met.conversions.report(
    contact_id=4821,
    event_name="Purchase",
    value=250000,
    currency="COP",
    bucket="pedido-10293",
)
if r["decision"] != "accepted":
    print("No salió:", r["decision"], r.get("reason"))

curl -X POST https://api.met.meteor.com.co/api/v1/conversions \
  -H "Authorization: Bearer $METEOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id":4821,"event_name":"Purchase","value":250000,"currency":"COP","bucket":"pedido-10293"}'

Qué exige la compuerta

Además, un contacto no acepta más de 10 conversiones en 24 horas (el tope por defecto): es el freno para un flujo que se quedó en bucle.

Una conversión web (Pixel)

Si tu sitio dispara el Pixel en el navegador, repórtalo también desde tu servidor con el mismo event_id: Meta junta los dos y no lo cuenta doble.

// En el navegador: fbq('track', 'Purchase', { value: 250000, currency: 'COP' }, { eventID: 'ord-10293' });
const r = await met.conversions.reportWeb({
  event_name: 'Purchase',
  event_id: 'ord-10293',
  fbp: req.cookies._fbp,
  fbc: req.cookies._fbc,
  email: cliente.email,
  event_source_url: 'https://mitienda.co/gracias',
  client_ip_address: req.ip,
  client_user_agent: req.headers['user-agent'],
  value: 250000,
  currency: 'COP',
});

r = met.conversions.report_web(
    event_name="Purchase",
    event_id="ord-10293",
    fbp=request.cookies.get("_fbp"),
    email=cliente_email,
    client_ip_address=ip_del_visitante,
    client_user_agent=user_agent_del_visitante,
    value=250000,
    currency="COP",
)

curl -X POST https://api.met.meteor.com.co/api/v1/conversions/web \
  -H "Authorization: Bearer $METEOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_name":"Purchase","event_id":"ord-10293","fbp":"fb.1.1730000000.123","gclid":"Cj0KCQ…","value":250000,"currency":"COP"}'

• Hace falta al menos una forma de reconocer al visitante: fbp, fbc, email, phone o external_id para Meta; gclid, gbraid, wbraid, email, phone o external_id para Google Ads. Sin ninguna, sale no_match_key.
• email, phone y external_id viajan en claro hasta Met y salen de Met convertidos en hash SHA-256; fbp, fbc y los identificadores de clic de Google van tal cual.
• client_ip_address y client_user_agent son los del visitante, no los de tu servidor: mejoran la coincidencia.
• Este camino no pide evidence: el hecho ya pasó en el navegador.
• Si el visitante llegó por un anuncio de Google, pasa también gclid (o gbraid / wbraid), que sale de la URL de llegada.

Qué responde

{ "decision": "discarded", "reason": "uncorroborated" }

Enterarte de la entrega

accepted dice que salió de la compuerta; la entrega a Meta llega después. Suscríbete a los eventos (scope conversions:read; ver Webhooks):

Errores comunes