Qué es Meta Conversions API

En términos generales, Conversions API es una tecnología de Meta Business Tools que permite compartir eventos de marketing directamente desde una fuente del negocio hacia Meta. Esa fuente puede ser un servidor web, una plataforma ecommerce, una aplicación, un CRM o determinados sistemas de mensajería.

Además, los eventos enviados pueden utilizarse para medición, atribución y optimización publicitaria, siempre dentro de las políticas y controles aplicables.

Por ejemplo, cuando alguien compra en una tienda online, el navegador puede disparar un evento Purchase mediante Meta Pixel. Al mismo tiempo, el servidor puede enviar el mismo Purchase mediante Conversions API.

Meta Pixel vs Conversions API: cuál debes utilizar

Por otra parte, Meta Pixel y Conversions API no son necesariamente alternativas. Para eventos web pueden trabajar juntos y proporcionar señales desde dos puntos distintos de la infraestructura.

Cómo funciona Meta Pixel + Conversions API

Por ejemplo, supongamos que un usuario realiza una compra. El navegador envía el evento a través de Meta Pixel. Después, tu servidor confirma que la orden realmente fue creada y envía un evento server-side equivalente.

De este modo, para que esto funcione correctamente, ambos eventos necesitan identificadores consistentes. En una implementación típica, el navegador y el servidor comparten el mismo event_id para la misma conversión.

Cómo instalar Meta Conversions API

En primer lugar, Meta ofrece varias rutas de implementación. La mejor depende de tu plataforma, presupuesto, conocimientos técnicos y nivel de control que necesitas.

Qué eventos puedes enviar con Conversions API

En la práctica, los eventos deberían representar acciones reales y relevantes del customer journey. Por ello, no se trata de enviar cualquier interacción posible solamente porque técnicamente puedas hacerlo.

Parámetros esenciales de un evento CAPI

Parámetros básicos de un evento

Cómo evitar conversiones duplicadas

En primer lugar, si envías la misma compra desde Meta Pixel y desde CAPI sin deduplicación, Meta podría recibir dos eventos separados que en realidad representan una única operación.

Por eso, uno de los puntos más importantes de una implementación híbrida consiste en generar un identificador de evento y utilizarlo tanto en browser como en server.

Ejemplo de evento en Meta Pixel

const eventId = "order_84921";

fbq(
  "track",
  "Purchase",
  {
    value: 1499.00,
    currency: "MXN"
  },
  {
    eventID: eventId
  }
);

El servidor reutiliza ese ID

{
  "event_name": "Purchase",
  "event_time": 1787288400,
  "event_id": "order_84921",
  "action_source": "website"
}

Customer Information y Event Match Quality

Por otra parte, para que una señal sea útil, Meta necesita intentar relacionarla con una persona dentro de sus tecnologías. Los parámetros incluidos dentro de user_data ayudan en ese proceso.

Además, dependiendo del evento y de los datos que tengas legítimamente disponibles, puedes enviar señales como correo, teléfono, IP, user agent y determinados identificadores asociados a navegación.

Ejemplo de Meta Conversions API desde servidor

A continuación, el siguiente ejemplo muestra la estructura general de una petición server-side. Utiliza placeholders y evita fijar una versión específica de Graph API para que la guía no quede obsoleta cuando Meta publique una nueva versión.

import hashlib
import time
import requests

PIXEL_ID = "TU_PIXEL_ID"
ACCESS_TOKEN = "TU_ACCESS_TOKEN"
GRAPH_VERSION = "vXX.0"

def sha256(value: str) -> str:
    normalized = value.strip().lower()
    return hashlib.sha256(
        normalized.encode("utf-8")
    ).hexdigest()

payload = {
    "data": [
        {
            "event_name": "Purchase",
            "event_time": int(time.time()),
            "event_id": "order_84921",
            "action_source": "website",
            "event_source_url": "https://tu-dominio.com/gracias",
            "user_data": {
                "em": [
                    sha256("cliente@ejemplo.com")
                ],
                "ph": [
                    sha256("5215512345678")
                ],
                "client_ip_address": "203.0.113.10",
                "client_user_agent": "Mozilla/5.0 ..."
            },
            "custom_data": {
                "currency": "MXN",
                "value": 1499.00,
                "order_id": "84921"
            }
        }
    ]
}

endpoint = (
    f"https://graph.facebook.com/"
    f"{GRAPH_VERSION}/{PIXEL_ID}/events"
)

response = requests.post(
    endpoint,
    params={
        "access_token": ACCESS_TOKEN
    },
    json=payload,
    timeout=20
)

print(response.status_code)
print(response.json())

Ejemplo adicional con un evento Lead

Ejemplo con Lead

{
  "data": [
    {
      "event_name": "Lead",
      "event_time": 1787288400,
      "event_id": "lead_form_7251",
      "action_source": "website",
      "event_source_url": "https://tu-dominio.com/contacto",
      "user_data": {
        "em": [
          "HASH_SHA256_DEL_EMAIL"
        ],
        "ph": [
          "HASH_SHA256_DEL_TELEFONO"
        ]
      }
    }
  ]
}

Cómo probar Meta Conversions API

En primer lugar, nunca implementes CAPI y asumas que funciona solamente porque tu servidor devuelve HTTP 200. También debes comprobar que Meta recibe el evento, interpreta los parámetros y lo relaciona correctamente con tu dataset.

Meta Conversions API desde un CRM

De hecho, uno de los usos más interesantes de CAPI ocurre después de generar un lead. La primera conversión no siempre representa el resultado más valioso.

Por ejemplo, imagina una campaña que genera formularios. De cada 100 leads, quizá solo 20 cumplen los requisitos, 8 reservan una cita y 3 compran. Si tu sistema solamente informa a Meta que llegaron 100 formularios, el algoritmo conoce la parte inicial del proceso, pero no necesariamente cuáles terminaron convirtiéndose en oportunidades de calidad.

Además, Meta recomienda conectar información de CRM en escenarios como campañas optimizadas para conversion leads. De esta forma, el sistema puede recibir señales relacionadas con qué leads terminan siendo más valiosos.

Errores frecuentes al instalar Meta Conversions API

Preguntas frecuentes sobre Meta Conversions API