API Chuyển đổi

Cổng API Chuyển đổi: Hỗ trợ API Sự kiện ngoài trang web từ máy chủ

Kể từ v1.6.0, Cổng API Chuyển đổi đã bắt đầu hỗ trợ điểm cuối API cho phép nhà quảng cáo gửi các sự kiện ngoài trang web từ Máy chủ của họ đến Cổng API Chuyển đổi. Điểm cuối này tương tự như phương thức API Chuyển đổi trực tiếp. Điểm khác biệt chính là sự kiện sẽ chuyển qua Cổng API Chuyển đổi thay vì được gửi trực tiếp đến API Đồ thị của Meta.

Gửi yêu cầu

Để gửi sự kiện mới, hãy gửi yêu cầu POST đến cạnh /events của API này từ đường dẫn sau: https://<capig.instance.url>/capi/{PIXEL_ID}/events.

Khi bạn đăng lên cạnh này, Meta sẽ tạo sự kiện mới từ máy chủ.

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

Tạo khóa truy cập

Bạn có thể sử dụng bảng điều khiển quản trị của Cổng API Chuyển đổi để tạo khóa truy cập nhằm gửi yêu cầu API đến Cổng API Chuyển đổi.

  • Đăng nhập vào giao diện người dùng quản trị của Cổng API Chuyển đổi
  • Chuyển đến phần Tổng quan
  • Nhấp vào "..." từ hàng Meta Pixel đã kết nối mà bạn muốn tạo khóa truy cập
  • Nhấp vào Tạo khóa truy cập

Bạn không thể sử dụng mã truy cập cho API Chuyển đổi trực tiếp để gửi yêu cầu máy chủ đến điểm cuối Cổng API Chuyển đổi.

Xem thêm