Un payload de Meta Conversions API es un objeto JSON transmitido mediante HTTP POST a graph.facebook.com. Consiste en tres objetos principales: (1) Metadatos del evento (event_name, event_time, event_id, action_source, event_source_url), (2) user_data (parámetros PII encriptados como em, ph, fbp, fbc y client_ip_address para el emparejamiento), y (3) custom_data (detalles comerciales de transacciones que incluyen value, currency y contents).
1. Por qué los payloads malformados arruinan el matching
La Conversions API de Meta devuelve un HTTP 200 OK incluso si tu payload contiene errores de formato que impiden el emparejamiento. Si un hash de correo electrónico contiene espacios en blanco o una dirección IP está formateada incorrectamente, Meta acepta el evento pero descarta silenciosamente la señal de emparejamiento.
Los webmasters suelen descubrir meses después que su Calidad de Emparejamiento de Eventos (EMQ) ha caído a 3,2 de 10. Comprender cada parámetro requerido y recomendado en la especificación CAPI es crítico para mantener una precisión de atribución óptima.
- Caída silenciosa: Meta API no genera errores fatales por parámetros sin hash o malformados.
- Faltan cookies fbp/fbc: omitirlas reduce las tasas de coincidencia en más del 35%.
- Elige tu modelo
2. Análisis comparativo: Rastreo estándar vs CAPI Control
La tabla siguiente describe las diferencias arquitectónicas y financieras entre el seguimiento pasivo de conversiones y la gobernanza activa de señales:
| Bloque de parámetros | Propiedades clave | Propósito y requisitos |
|---|---|---|
| Metadatos del evento | event_name, event_time, event_id, action_source | Identifica el tipo de evento, marca temporal, clave de deduplicación y canal ('website') |
| user_data | em, ph, fbp, fbc, client_ip_address, client_user_agent | Claves de emparejamiento criptográficas para vincular la acción al perfil de Facebook/Instagram |
| custom_data | value, currency, content_type, contents | Valores financieros utilizados para entrenar modelos de Optimización |
3. Payload JSON de Meta CAPI conforme a RFC
Este payload JSON es completo y está perfectamente estructurado según Meta Graph API v19.0+:
{
"data": [
{
"event_name": "Purchase",
"event_time": 1726521600,
"event_id": "order_1002948",
"event_source_url": "https://brand.com/checkout/thank-you",
"action_source": "website",
"user_data": {
"em": ["f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a"],
"ph": ["4f7b4946394334b071bc8834db4b6e511394c8e74a88383cf852ab086d252eb6"],
"client_ip_address": "172.56.21.89",
"client_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)...",
"fbp": "fb.1.1712345678.987654321",
"fbc": "fb.1.1712345678.AbCdEfGhIjKlMnOpQrStUvWxYz",
"external_id": ["user_cust_88291"]
},
"custom_data": {
"currency": "USD",
"value": 129.50,
"content_type": "product",
"contents": [
{ "id": "SKU-CORE-BLACK", "quantity": 1, "item_price": 129.50 }
]
}
}
]
}Cómo desplegar CAPI Control para solucionar esto hoy
- Step 1: Audit your outbound JSON payload against the specification above.
- Step 2: Verify that `event_id` is identically mirrored between client-side pixel and server CAPI.
- Step 3: Ensure all user emails and phone numbers are normalized before SHA256 hashing.
- Step 4: Use CAPI Control's automated payload validator to catch formatting defects.
Preguntas frecuentes
¿Deben los parámetros `em` y `ph` ser arrays o strings?
La API de Meta admite tanto strings individuales como arrays de strings. Pasar un array te permite transmitir múltiples direcciones de correo electrónico conocidas para un solo usuario para aumentar las tasas de emparejamiento.
¿Cuál es el formato para `fbc` (Cookie de Clic de Facebook)?
Debe seguir la sintaxis estándar: `fb.{subdomain_index}.{creation_time}.{fbclid}`.
¿Qué sucede si se omite `action_source`?
Meta rechaza por defecto el payload con el código de error 100 (Parámetro requerido faltante).
¿Listo para dirigir Meta y Google hacia tu tráfico más rentable?
Integra CAPI Control en menos de 2 minutos. Transmite el 100 % de las señales de conversión gratis para siempre, o activa agentes de IA autónomos de señales para obtener 3 veces mejor tráfico publicitario.