API Conversions

Gateway API Conversions : prise en charge de l’API des évènements de serveur non web

Depuis la version 1.6.0, le gateway API Conversions prend en charge le point de terminaison d’API qui permet aux annonceurs d’envoyer des évènements non web de leur serveur vers le gateway API Conversions. Le fonctionnement est semblable à celui de la méthode API Conversions - Direct. La principale différence est que l’évènement passe par le gateway API Conversions au lieu d’être envoyé directement à l’API Graph Meta.

Requêtes d’envoi

Pour envoyer de nouveaux évènements, adressez une requête POST à l’arête /events de cette API à partir du chemin suivant : https://<capig.instance.url>/capi/{PIXEL_ID}/events.

Lorsque vous publiez sur cette arête, Meta crée des évènements de serveur.

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

Génération d’une clé d’accès

Une clé d’accès permettant d’envoyer des requêtes d’API au gateway API Conversions peut être générée à partir de la console d’administration du gateway.

  • Connectez-vous à l’UI d’administration du gateway API Conversions.
  • Accédez à la section Vue d’ensemble.
  • Cliquez sur ... dans la ligne de pixel Meta connecté pour laquelle générer une clé d’accès.
  • Cliquez sur Generate Access Key (Générer une clé d’accès).

Vous ne pouvez pas utiliser un token d’accès de la méthode API Conversions - Direct pour adresser des requêtes de serveur au point de terminaison du gateway API Conversions.

Voir aussi