API Chất lượng tích hợp

API này đang ở giai đoạn beta. Để được truy cập, vui lòng liên hệ với đại diện của Meta.

Nếu chia sẻ sự kiện trên máy chủ bằng API Chuyển đổi, nhà quảng cáo có thể xem Chất lượng so khớp sự kiện trong Trình quản lý sự kiện. Tuy nhiên, phương thức này chỉ có hiệu quả trên cơ sở từng trường hợp và khó mở rộng quy mô khi đối tác nhà cung cấp công nghệ, đối tác agency hoặc nhà quảng cáo phải quản lý hàng trăm và hàng nghìn Meta Pixel cho doanh nghiệp của họ. API Chất lượng tích hợp có thể góp phần giải quyết vấn đề này bằng cách hợp nhất các số liệu về chất lượng thiết lập theo lập trình trên quy mô lớn.

Giới thiệu về Chất lượng so khớp sự kiện

Chất lượng so khớp sự kiện

Chất lượng so khớp sự kiện (EMQ) là điểm số (trên thang điểm 10) cho biết mức độ hiệu quả của thông tin khách hàng do máy chủ của bạn gửi đến khi so khớp các phiên bản sự kiện với một tài khoản Facebook. Khi chất lượng so khớp sự kiện đạt điểm cao, khả năng phân bổ và hiệu quả quảng cáo có thể được cải thiện. Lưu ý rằng đây là số liệu đang phát triển.

Cách tính

Chất lượng so khớp sự kiện được tính toán dựa trên các thông số thông tin khách hàng do máy chủ của bạn gửi đến thông qua tiện ích tích hợp API Chuyển đổi, chất lượng của thông tin nhận được và tỷ lệ phần trăm số phiên bản sự kiện khớp với một tài khoản Meta.

Cách sử dụng

Chất lượng so khớp sự kiện được dùng để đánh giá liệu bạn có đang gửi thông tin khách hàng phù hợp qua API Chuyển đổi nhằm so khớp sự kiện với một tài khoản Meta không và đã thiết lập chính xác thông số thông tin khách hàng chưa. Với thông số thông tin khách hàng, bạn có thể so khớp các sự kiện với một tài khoản Meta, từ đó ghi nhận lượt chuyển đổi cho quảng cáo và phân phối quảng cáo cho những người có nhiều khả năng sẽ chuyển đổi nhất.

Chất lượng so khớp sự kiện được tính toán theo thời gian thực. Tìm hiểu thêm về cách làm tốt nhất đối với EMQ tại đây.

EMQ hiện chỉ dùng được cho sự kiện trên web. Đối với các loại sự kiện khác như sự kiện offline và sự kiện tại cửa hàng thực, sự kiện trong ứng dụng, khách hàng có tiềm năng chuyển đổi hay bất kỳ tiện ích tích hợp nào ở giai đoạn alpha hoặc beta, hãy liên hệ với đại diện của Meta để được hướng dẫn về cách cải thiện chất lượng so khớp.

Trường hợp sử dụng phổ biến

Đối tác và agency có thể sử dụng API Chất lượng tích hợp để cung cấp bảng điều khiển và thông tin chi tiết về chất lượng, đồng thời giúp nhà quảng cáo nâng cao và tối ưu hóa các tiện ích tích hợp của họ. Đối tác cũng có thể dùng tiện ích tích hợp này để giám sát tính ổn định của tiện ích tích hợp API Chuyển đổi. Nhà quảng cáo có thể dùng điểm cuối này để tổng hợp dữ liệu về chất lượng tích hợp nhằm đưa vào quá trình giám sát.

Xác thực

Xác thực nhà quảng cáo thông qua Trình quản lý kinh doanh

Trong Trình quản lý kinh doanh, hãy chuyển đến phần Người dùng rồi 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.
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.
Đối với mỗi pixel, chọn quyền Quản lý pixel và nhấp vào Lưu thay đổi.
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ị ở đó.
Để tạo mã truy cập, hãy làm theo hướng dẫn tại đây.

Xác thực nền tảng đối tác

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:

Đăng nhập bằng Facebook cho doanh nghiệp (Khuyên dùng)

Đăng nhập bằng Facebook cho doanh nghiệp là giải pháp xác thực và ủy quyền ưu tiên dành cho những nhà cung cấp công nghệ và nhà phát triển ứng dụng kinh doanh cần truy cập vào tài sản của khách hàng doanh nghiệp. Với giải pháp này, bạn có thể chỉ định loại mã truy cập, loại tài sản và những quyền mà ứng dụng của bạn cần rồi lưu dưới dạng một tập hợp (cấu hình). Sau đó, bạn có thể hiển thị tập hợp này cho khách hàng doanh nghiệp để hoàn tất quy trình này và cấp cho ứng dụng của bạn quyền truy cập vào tài sản doanh nghiệp của họ.

Tiện ích Meta Business (Khuyên dùng)

Đối với cách này, Tiện ích Meta Business (MBE) 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. MBE 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. MBE hiện ở giai đoạn beta, vui lòng liên hệ với đại diện của Meta để được truy cập.

Đ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. Nếu bạn là người dùng MBE 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 MBE. 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.

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 đó, đối tác 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ủ.

Truy xuất thông tin về chất lượng tích hợp pixel

Bạn có thể giám sát điểm số Chất lượng so khớp sự kiện trên mỗi sự kiện cùng với các khóa so khớp được gửi đi thông qua điểm cuối API, thông số và trường sau đây:

Điểm cuối

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

Thông số

Thông số Mô tả

Thông số	Mô tả
`agent_name` string	Không bắt buộc. Giá trị được chuẩn hóa của trường partner_agent dùng để chỉ lọc những sự kiện được gửi với thông số partner_agent trong yêu cầu POST /{pixel_id}/events (xem phần cách tốt nhất để ghi nhận sự kiện tại đây và tại đây). Ví dụ: nếu giá trị partner_agent là `[partner_name]_[majorversion]_[minorVersion]`, giá trị được chuẩn hóa dạng string cho đại lý sẽ là `partner_name` viết thường. `agent_name` cho phép bạn đặt thông tin nhận dạng nền tảng của riêng mình khi gửi sự kiện thay mặt cho khách hàng. Nếu bạn là đối tác/agency được quản lý, hãy làm việc với đại diện của Meta để thống nhất về thông tin nhận dạng cho nền tảng của bạn. Nếu là nhà quảng cáo thì gần như bạn không phải lo lắng về việc ghi nhận `agent_name`. Nếu bạn không cung cấp `agent_name`, mọi sự kiện (bất kể có do đại lý gửi hay không) đều sẽ được đưa vào quá trình tính toán EMQ.

agent_name

string

Không bắt buộc.
Giá trị được chuẩn hóa của trường partner_agent dùng để chỉ lọc những sự kiện được gửi với thông số partner_agent trong yêu cầu POST /{pixel_id}/events (xem phần cách tốt nhất để ghi nhận sự kiện tại đây và tại đây).

Ví dụ: nếu giá trị partner_agent là [partner_name]_[majorversion]_[minorVersion], giá trị được chuẩn hóa dạng string cho đại lý sẽ là partner_name viết thường.

agent_name cho phép bạn đặt thông tin nhận dạng nền tảng của riêng mình khi gửi sự kiện thay mặt cho khách hàng. Nếu bạn là đối tác/agency được quản lý, hãy làm việc với đại diện của Meta để thống nhất về thông tin nhận dạng cho nền tảng của bạn.

Nếu là nhà quảng cáo thì gần như bạn không phải lo lắng về việc ghi nhận agent_name.

Nếu bạn không cung cấp agent_name, mọi sự kiện (bất kể có do đại lý gửi hay không) đều sẽ được đưa vào quá trình tính toán EMQ.

Trường

Trường	Mô tả
`event_name` string	Tên của sự kiện tiêu chuẩn hoặc sự kiện tùy chỉnh.
`event_match_quality` AdsPixelCAPIEMQ	Chất lượng so khớp sự kiện cho biết mức độ hiệu quả của thông tin khách hàng do máy chủ của bạn gửi đến khi so khớp các phiên bản sự kiện với một tài khoản Facebook.

Ví dụ

Trình khám phá API Đồ thị

GET/v21.0/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>

cURL

curl -X GET -G \
  -d 'fields="event_match_quality,event_name"' \
  -d 'agent_name="&lt;AGENT_NAME&gt;"' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality

Phản hồi API

{
  "data": [
    {
      "event_match_quality": {
        "composite_score": 5.1,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          }
        ]      
      },
      "event_name": "pLTVPurchase"
    },
    {
      "event_match_quality": {
        "composite_score": 7.2,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "phone",
            "coverage": {
              "percentage": 69.1
            }
          },
          {
            "identifier": "fbp",
            "coverage": {
              "percentage": 96.7
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "fbc",
            "coverage": {
              "percentage": 3.2
            }
          }
        ]
      },
      "event_name": "CompleteRegistration"
    }
  ]
}

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

What is the access token used for?

The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.

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

How should the partner_agent field be formatted?

The partner_agent value in your API GET request should be a normalized lowercase format. This field is now optional.

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

Tìm hiểu thêm

Cách làm tốt nhất đối với API Chuyển đổi.
Thúc đẩy hiệu quả với cách thiết lập API Chuyển đổi được tối ưu hóa.
Cách tốt nhất để tích hợp API Chuyển đổi cho đối tác
Hướng dẫn về chất lượng thiết lập API Chuyển đổi trong Trung tâm trợ giúp doanh nghiệp của Meta:

Cách làm tốt nhất đối với API Chuyển đổi giúp cải thiện hiệu quả quảng cáo. Khi áp dụng những cách làm tốt nhất này đối với API Chuyển đổi, doanh nghiệp có thể giảm chi phí trên mỗi hành động, qua đó cải thiện hiệu quả quảng cáo. Doanh nghiệp nên làm theo những cách làm tốt nhất này khi thiết lập ban đầu, nhưng cũng có thể áp dụng để cập nhật cách thiết lập hiện tại.

Xem thông tin chi tiết về sự kiện trên máy chủ trong Trình quản lý sự kiện trên Meta. Sau khi thiết lập API Chuyển đổi, doanh nghiệp có thể tham khảo bài viết này để tìm hiểu cách giám sát các sự kiện và thông số nhằm đảm bảo cách thiết lập của họ đang hoạt động hiệu quả cũng như xác định cơ hội cải thiện. Doanh nghiệp cũng có thể tham khảo bài viết này để tìm hiểu cách sử dụng thông tin chi tiết về sự kiện trên máy chủ (So khớp sự kiện [Chất lượng so khớp sự kiện hay EMQ]), Độ mới của dữ liệu, Tổng quan về sự kiện và Bỏ trùng lặp sự kiện) trong Trình quản lý sự kiện nhằm cải thiện cách thiết lập API Chuyển đổi.