เกตเวย์ API คอนเวอร์ชั่น: การรองรับ API เหตุการณ์เซิร์ฟเวอร์ที่ไม่ใช่บนเว็บ

ตั้งแต่เวอร์ชั่น 1.6.0 เป็นต้นไป เกตเวย์ API คอนเวอร์ชั่นจะเริ่มรองรับตำแหน่งข้อมูล API ที่ผู้ลงโฆษณาจะสามารถใช้ส่งเหตุการณ์ที่ไม่ใช่บนเว็บจากเซิร์ฟเวอร์ของตนไปยังเกตเวย์ API คอนเวอร์ชั่นได้ วิธีนี้จะคล้ายคลึงกับการใช้ API คอนเวอร์ชั่นแบบโดยตรง ความแตกต่างหลักๆ คือเหตุการณ์จะดำเนินไปตามขั้นตอนผ่านเกตเวย์ API คอนเวอร์ชั่นแทนที่จะส่งเหตุการณ์โดยตรงไปยัง API กราฟของ Meta

ส่งคำขอ

หากต้องการส่งเหตุการณ์ใหม่ ให้ส่งคำขอ POST ไปยังจุดเชื่อมโยงของ 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 คอนเวอร์ชั่น

  • เข้าสู่ระบบไปยัง UI ผู้ดูแลเกตเวย์ API คอนเวอร์ชั่น
  • ไปยังส่วนภาพรวม
  • คลิก "..." จากแถวพิกเซลของ Meta ที่เชื่อมต่อไว้ที่คุณต้องการสร้างคีย์การเข้าถึง
  • คลิกสร้างคีย์การเข้าถึง

โทเค็นการเข้าถึงสำหรับ API คอนเวอร์ชั่นแบบโดยตรงไม่สามารถใช้ส่งคำขอเซิร์ฟเวอร์ไปยังตำแหน่งข้อมูลเกตเวย์ API คอนเวอร์ชั่นได้