Conversions API

Conversions API Gateway: API-Unterstützung für Nicht-Web-Server-Events

Seit v1.6.0 unterstützt das Conversions API Gateway den API-Endpunkt, sodass Werbetreibende jetzt Nicht-Web-Events von ihrem Server an das Conversions API Gateway senden können. Dies entspricht in etwa der Conversions API Direct-Methode. Der Hauptunterschied besteht darin, dass das Event das Conversions API Gateway durchläuft und Events nicht direkt an die Meta Graph API gesendet werden.

Anfragen senden

Um neue Events zu senden, erstelle eine POST-Anfrage an die /events-Edge dieser API von diesem Pfad aus: https://<capig.instance.url>/capi/{PIXEL_ID}/events.

Wenn du in dieser Edge postest, erstellt Meta neue Server-Events.

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

Zugriffsschlüssel generieren

Ein Zugriffsschlüssel zum Senden von API-Anfragen an das Conversions API Gateway kann über die Admin-Konsole des Conversions API Gateway generiert werden.

  • Melde dich über die Admin-Bedienoberfläche des Conversions API Gateway an.
  • Navigiere zum Abschnitt Übersicht.
  • Klicke in der Zeile „Verbundenes Meta-Pixel“, in der du einen Zugriffsschlüssel generieren möchtest, auf „...“.
  • Klicke auf Zugriffsschlüssel generieren.

Ein Zugriffsschlüssel für Conversions API Direct kann nicht verwendet werden, um Serveranfragen an den Conversions API Gateway-Endpunkt zu senden.

Siehe auch