API de conversiones

Puerta de enlace de la API de conversiones: compatibilidad con la API de eventos del servidor que no son de web

A partir de la versión 1.6.0, la puerta de enlace de la API de conversiones es compatible con el extremo de la API desde el cual los anunciantes pueden enviar eventos que no son de web desde su servidor a la puerta de enlace de la API de conversiones. Es similar al método de envío directo mediante la API de conversiones. La principal diferencia radica en que el evento pasará a través de la puerta de enlace de la API de conversiones en lugar de enviar eventos directamente a la API Graph de Meta.

Enviar solicitudes

Para enviar nuevos eventos, realiza una solicitud POST al perímetro /events de esta API desde esta ruta: https://<capig.instance.url>/capi/{PIXEL_ID}/events.

Al realizar una publicación en este perímetro, Meta crea nuevos eventos del servidor.

curl -i -X POST \
  -d '{
  "accessKey": "<ACCESS_KEY_VIA_CAPIG_UI>",
  "data": [
    {
      "event_name": "Purchase",
      "event_time": <Unix timestamp in seconds, must be within the last seven days>,
      "user_data": {
        "em": [
          "973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b"
        ],
        "ph": [
          "ce3a598687c8d2e5aa6bedad20e059b4a78cca0adad7e563b07998d5cd226b8c"
        ],
        "client_ip_address": "123.123.123.123",
        "client_user_agent": "CLIENT_USER_AGENT",
        "fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
        "fbp": "fb.1.1558571054389.1098115397"
      },
      "contents": [
        {
          "id": "product123",
          "quantity": 1,
          "delivery_category": "home_delivery"
        }
      ],
      "custom_data": {
        "currency": "usd",
        "value": 123.45
      },
      "event_source_url": "http://test.com/product/123",
      "action_source": "website"
    }
  ]
}' \
https://<capig.instance.url>/capi/<PIXEL_ID>/events

Generar claves de acceso

Se puede generar una clave de acceso para enviar solicitudes de API a la puerta de enlace de la API de conversiones desde la consola para administradores de la puerta de enlace de la API de conversiones.

  • Inicia sesión en la IU de administración de la puerta de enlace de la API de conversiones.
  • Accede a la sección Información general.
  • Haz clic en el icono “...” de la fila del píxel de Meta conectado desde la que quieres generar una clave de acceso.
  • Haz clic en Generar clave de acceso.

Los identificadores de acceso para la API de conversiones directa no se pueden utilizar para realizar solicitudes del servidor al extremo de la puerta de enlace de la API de conversiones.

Más información