API Chuyển đổi

Thiết lập API Chuyển đổi dưới dạng nền tảng

Nếu cung cấp cách thiết lập Meta Pixel trong dịch vụ quản lý thẻ, bạn nên cân nhắc việc thêm các chức năng của API Chuyển đổi. Khi tích hợp với API Chuyển đổi, khách hàng của bạn có thể gửi trực tiếp sự kiện trên web đến Facebook, mà không cần phải phụ thuộc vào sự kiện Pixel trên trình duyệt.

Sự kiện trên máy chủ và sự kiện trên trình duyệt

Trước khi bắt đầu, bạn cần hiểu rõ mối quan hệ giữa sự kiện trên máy chủ và Meta Pixel. Sự kiện trên máy chủ được gửi qua API Chuyển đổi, đồng thời được dùng trong hoạt động đo lường, báo cáo và tối ưu hóa theo cách tương tự như sự kiện Pixel trên trình duyệt.

Nếu gửi sự kiện Pixel trên trình duyệt giống như gửi thư qua đường hàng không thì gửi sự kiện trên máy chủ giống như gửi thư qua đường bộ. Cả hai đều là cơ chế vận chuyển gói hàng (dữ liệu về một sự kiện) đến địa chỉ đích (ID pixel). Do vậy, bạn thực sự nên tích hợp API Chuyển đổi trên nền tảng của mình dưới dạng tiện ích của dịch vụ Meta Pixel hiện tại (thay vì plugin hoặc dịch vụ riêng biệt) vì những lý do sau đây:

  • Sự kiện trên máy chủ sử dụng ID pixel làm đích đến
  • Sau khi được gửi đến Facebook, sự kiện trên máy chủ được xử lý theo cách tương tự như sự kiện Pixel trên trình duyệt
  • Dễ bỏ trùng lặp hơn
  • Khách hàng có thể sử dụng dễ dàng. Ví dụ: theo mặc định, khách hàng có thể gửi sự kiện trên máy chủ cùng với sự kiện trên trình duyệt.

Sau khi tích hợp nền tảng của mình với API Chuyển đổi, bạn nên gửi sự kiện trên web qua cả trình duyệt và máy chủ. Cách dự phòng như vậy giúp đảm bảo độ tin cậy của tín hiệu. Những sự kiện mà trước đây có thể bị mất ở phía trình duyệt vì nhiều lý do liên quan đến mạng giờ sẽ được ghi lại qua API Chuyển đổi.

Để gửi sự kiện qua trình duyệt và máy chủ, bạn phải đặt đúng event_id cho sự kiện tương ứng. Như vậy, Facebook mới có thể bỏ trùng lặp sự kiện của bạn một cách chính xác.

Điều kiện tiên quyết

  1. Một nền tảng web có thể chia sẻ sự kiện lên Facebook. Ví dụ: công cụ tạo trang web, trình quản lý thẻ hoặc nền tảng AdTech.
  2. Thông báo thích hợp cho người dùng cùng xác nhận đồng ý của họ về việc chia sẻ dữ liệu sự kiện với Facebook, theo yêu cầu của Điều khoản về Công cụ kinh doanh trên Facebook.
  3. Một người đại diện của Facebook
  4. Điều kiện tiên quyết tiêu chuẩn để tích hợp API Chuyển đổi:

Để bắt đầu cung cấp API Chuyển đổi dưới dạng nền tảng, ứng dụng của bạn cần thực hiện quy trình Xét duyệt ứng dụng. Trong quá trình đó, bạn phải yêu cầu cấp độ truy cập, tính năng và quyền sau đây:

Bắt đầu

Nếu đây là lần đầu tiên bạn sử dụng API Chuyển đổi, hãy làm theo các bước sau để tạo Doanh nghiệp, ứng dụng trên Meta, Meta Pixel và người dùng hệ thống. Sau đó, bạn sẽ có thể dùng mã truy cập dành cho người dùng hệ thống để gửi sự kiện trên máy chủ qua API Chuyển đổi.

Bước 1: Tạo doanh nghiệp.

Bước 2: Tạo ứng dụng trên Meta cho doanh nghiệp bạn mới tạo.

Bước 3: Tạo Meta Pixel cho doanh nghiệp bạn mới tạo:

Bước 4: Tạo mã truy cập dành cho người dùng hệ thống.

Bước 5: Gửi sự kiện trên máy chủ đến Meta Pixel.

Gửi sự kiện thay mặt cho khách hàng

Sau khi gửi thành công sự kiện trên máy chủ đến Meta Pixel của riêng mình, bạn có thể chọn cách gửi sự kiện thay mặt cho khách hàng.

Đối với Meta Pixel do Trình quản lý kinh doanh của đối tác sở hữu hoặc quản lý

  1. Trong Trình quản lý kinh doanh, chuyển đến phần Người dùng và chọn tab Người dùng hệ thống. Nhấp vào người dùng hệ thống cụ thể mà bạn đang sử dụng cho API Chuyển đổi.
  2. Chuyển đến hộp thoại Chỉ định tài sản và chọn Pixel. Sau đó, chọn những Pixel mà bạn muốn thay mặt gửi sự kiện.
  3. Đối với mỗi Pixel, chọn quyền Quản lý pixel và nhấp vào Lưu thay đổi.
  4. Quay lại trang chi tiết của người dùng hệ thống. Xác minh rằng các Pixel đã chọn hiển thị ở đó.

Đối với Facebook Pixel không do đối tác quản lý

Trước tiên, bạn phải yêu cầu ủy quyền để gửi sự kiện thay mặt cho khách hàng. Bạn có thể xác thực theo những cách sau đây:

Tiện ích Facebook Business (khuyên dùng)

Đối với cách này, Tiện ích Facebook Business (FBE) sẽ trả về tất cả thông tin cần thiết để gửi sự kiện thay mặt cho khách hàng theo quy trình sau. FBE cung cấp một điểm cuối để truy xuất mã truy cập dành cho người dùng hệ thống được tạo trong Trình quản lý kinh doanh của khách hàng. Quy trình này bao gồm quyền gửi sự kiện trên máy chủ, đồng thời được thực hiện tự động và theo cách bảo mật.

Điểm cuối nêu trên cần có mã truy cập dành cho người dùng làm thông số đầu vào. Đối với người dùng FBE mới, hãy gọi điểm cuối này để tìm nạp mã truy cập dành cho người dùng hệ thống sau khi bạn thiết lập xong FBE. Người dùng hiện tại cần yêu cầu xác thực lại trước khi gọi điểm cuối API mới.

Mã truy cập dành cho người dùng hệ thống của khách hàng

Đối với cách này, bạn phải yêu cầu khách hàng tạo mã truy cập dành cho người dùng hệ thống theo cách thủ công thông qua API Chuyển đổi bên trong Cài đặt Pixel. Sau đó, bạn có thể dùng mã đó để gửi sự kiện đến Pixel của nhà quảng cáo.

Người dùng hệ thống hoặc người dùng hệ thống là quản trị viên phải cài đặt ứng dụng sẽ được dùng để tạo mã truy cập. Khi thiết lập như vậy, ứng dụng của bạn sẽ được phép gọi API thay mặt cho người dùng hệ thống hoặc người dùng hệ thống là quản trị viên nêu trên.

Hãy làm theo tài liệu Bắt đầu của chúng tôi và yêu cầu nhà quảng cáo cung cấp mã dành cho người dùng hệ thống. Nhớ sử dụng Meta Pixel và mã truy cập của riêng bạn để thử nghiệm.

Khách hàng chia sẻ Meta Pixel với Trình quản lý kinh doanh của đối tác

Đối với cách này, khách hàng chia sẻ Meta Pixel của họ với đối tác thông qua cài đặt Trình quản lý kinh doanh hoặc thông qua API. Sau đó, bạn có thể chỉ định người dùng hệ thống của đối tác cho pixel của khách hàng và tạo mã truy cập để gửi sự kiện trên máy chủ.

Phân bổ sự kiện cho nền tảng của bạn bằng trường partner_agent

Để phân bổ sự kiện API Chuyển đổi cho nền tảng của bạn, hãy sử dụng trường partner_agent. Nhờ vậy, bạn có thể đặt thông tin nhận dạng nền tảng của mình khi gửi sự kiện thay mặt cho khách hàng. Làm việc với Người đại diện của Facebook để thống nhất thông tin nhận dạng cho nền tảng của bạn. Sau đó, gửi thông tin này kèm theo mỗi sự kiện trên máy chủ.

Phần tải dữ liệu sự kiện mẫu

Nếu thông tin nhận dạng nền tảng của bạn là datapartner, sau đây là phần tải dữ liệu mẫu cho sự kiện mua hàng được gửi thay mặt cho khách hàng của bạn:

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

Câu hỏi thường gặp

Sending events sent via the Conversions API is just like sending events via Facebook Pixel. The only difference is that the event is sent via the server, instead of the browser. So, why make an effort to integrate with the Conversions API? Here are some important use cases:

Capture offline and down-funnel events

If someone uses an advertisers’ website to sign up for a credit card, they can send events such as ViewContent, Application Start, and Application Submit via the browser to the Facebook Pixel. However, the end user still needs to be approved for this credit card. The Approval event happens offline and cannot be sent via browser. To register this final step, the advertiser can send the Approval via the Conversions API.

Signal resiliency

Browser side events can be lost for many reasons:

  • The user might navigate away before the page has finished loading.
  • Ad blockers could prevent the event from firing.
  • The changing internet landscape might change the way inter-domain messages are sent.

These examples can all be mitigated by sending events via the Conversions API.

Sensitive data

Many advertisers have expressed concerns about sharing data via the browser when that data could be seen or inspected. This can be mitigated by sending data via the Conversions API.

For example, advertisers may want to send data like profit margin or lifetime value (LTV) along with a purchase event. This way, ads can be optimized towards a specific type of customer.

Liên kết vĩnh viễn

Since browser events are always vulnerable to obstacles, we recommend that you only send events collected from the Conversions API sources. For example, if:

  • One of the ways your customer ingests data into your platform is via a browser JavaScript tag, or
  • You send that data to Facebook via the Conversions API

the data is open to the browser-side risks.

To take full advantage of the Conversions API, no part of the data flow should be reliant on the browser.

Liên kết vĩnh viễn

We recommend that you provide advertisers with a way to test this connection on your own platform.

  1. Send a test event via the Conversions API to the advertiser’s pixel. Look for a 200 return code.
  2. Update the status of the connection appropriately.
Liên kết vĩnh viễn

Facebook tries to deduplicate identical events sent through the Facebook Pixel and the Conversions API. We determine if events are identical based on their event_id and event_name. For more information, see Handling Duplicate Pixel and Conversions API Events.

Liên kết vĩnh viễn

The external_id parameter is a string that represents a user on an advertiser's system. These IDs help improve ads attribution and create audiences.

You can send external_ids via browser or the Conversions API, but you must be consistent across channels. For example, if you send a browser pixel event with external_id set to 123, your server event for that same user should also have external_id set to 123.

Liên kết vĩnh viễn