بوابة API التحويلات: دعم واجهة API أحداث الخادم غير المرتبطة بالويب

بدءًا من الإصدار 1.6.0 فصاعدًا، بدأت بوابة واجهة API التحويلات في دعم نقطة نهاية API حيث يمكن للمعلنين إرسال أحداث غير مرتبطة بالويب من خادمهم إلى بوابة واجهة API التحويلات. هذا يشبه طريقة واجهة API التحويلات المباشرة. يتمثل الفارق الرئيسي في أن الحدث سيتدفق من خلال بوابة واجهة API التحويلات بدلاً من إرسال الأحداث إلى Graph API لدى Meta مباشرة.

إرسال الطلبات

لإرسال أحداث جديدة، أرسل طلب POST إلى عنصر الربط /events الخاص بواجهة API هذه من المسار التالي: https://<capig.instance.url>/capi/{PIXEL_ID}/events.

وعند النشر على عنصر الربط هذا، تنشئ Meta أحداث خادم جديدة.

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

إنشاء مفتاح وصول

يمكن إنشاء مفتاح وصول لإرسال طلبات واجهة API إلى بوابة واجهة API التحويلات من وحدة تحكم مسؤول بوابة واجهة API التحويلات.

• سجل الدخول إلى واجهة المستخدم لمسؤول بوابة واجهة API التحويلات
• انتقل إلى قسم نظرة عامة
• انقر على "... " من صف بيكسل Meta المرتبط الذي تريده لإنشاء مفتاح وصول
• انقر على إنشاء مفتاح الوصول

راجع أيضًا

• التكوين
• الإعداد
• إدارة حساب AWS
• استكشاف الأخطاء وإصلاحها والتحقق