API de conversiones

Gateway de la API de conversiones: asistencia de la API de eventos del servidor fuera de la web

A partir de la versión 1.6.0., el gateway de la API de conversiones comenzó a admitir el punto de conexión de la API en el que los anunciantes pueden enviar eventos fuera de la web desde el servidor al gateway de la API de conversiones. Esto es similar a lo que sucede con el método directo de la API de conversiones. La diferencia principal es que el evento pasará por el gateway de la API de conversiones en vez de enviar eventos de manera directa a la API Graph de Meta.

Enviar solicitudes

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

Cuando realizas 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 la API al gateway de la API de conversiones desde la consola de administración del gateway de la API de conversiones.

  • Iniciar sesión en la UI de administración del gateway de la API de conversiones
  • Ve a la sección de información general.
  • Haz clic en "..." en la fila del píxel de Meta conectado para la que deseas generar una clave de acceso.
  • Haz clic en Generar clave de acceso.

No se puede usar un token de acceso para la API de conversiones: directo para hacer solicitudes del servidor al punto de conexión del gateway de la API de conversiones.

Más información