Dataset Quality API

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 điểm chất lượng so khớp sự kiện trong Trình quản lý sự kiện trên Meta. Tuy nhiên, phương thức này chỉ áp dụng cho 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. Dataset Quality API (tên cũ là Integration Quality API) 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 tập dữ liệu theo lập trình trên quy mô lớn.

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

Đối tác và agency có thể sử dụng Dataset Quality API để 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ập dữ liệu nhằm đưa vào quá trình giám sát.

Các yêu cầu khi thiết lập

Quyền sở hữu và truy cập

Xác thực nhà quảng cáo bằng Trình quản lý kinh doanh trên Meta

1. Trong Trình quản lý kinh doanh, đi đế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ị ở đó.
5. Để 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 nhóm (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 lựa chọn này, khách hàng chia sẻ Meta Pixel của họ với đối tác bằng cách sử dụng phần 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ủ.

Khách hàng tạo mã thủ công qua Trình quản lý sự kiện

Nhà quảng cáo có thể tạo mã truy cập trong Trình quản lý sự kiện để thiết lập API Chuyển đổi và truy cập vào Dataset Quality API. Bạn có thể đặt cấu hình tiện ích tích hợp trực tiếp hoặc chia sẻ mã truy cập đã tạo với đối tác để gửi sự kiện đến Meta. Bạn có thể sao chép và lưu mã mới này. Lưu ý rằng Meta sẽ không lưu trữ các mã này. Mã được tạo sẽ có thể tìm nạp dữ liệu chất lượng và gửi sự kiện qua API Chuyển đổi.

Quyền của người dùng

• Để thực hiện lệnh gọi API, người dùng hoặc người dùng hệ thống (tối thiểu) cần có quyền của người dùng sau: Quyền truy cập một phần -> Sử dụng tập dữ liệu sự kiện
• Quyền truy cập của người dùng có thể được cấp (hàng loạt) bằng cách làm theo hướng dẫn tại đây.

Quyền của ứng dụng

• Cơ bản: Nếu quản lý một vài tập dữ liệu trên Meta và/hoặc muốn thử nghiệm Dataset Quality API, bạn cần có các quyền sau đây đối với ứng dụng: ads_read và (ads_management hoặc business_management).

• Nâng cao: Nếu thay mặt doanh nghiệp khác quản lý lượng lớn tập dữ liệu trên Meta và/hoặc cần giới hạn tốc độ cao hơn, bạn cần có cấp độ nâng cao của quyền đối với ứng dụng ads_management và tính năng ứng dụng Quyền truy cập tiêu chuẩn để quản lý quảng cáo. Để có tính năng và quyền đối với ứng dụng ở cấp độ nâng cao, bạn cần thực hiện quy trình xét duyệt ứng dụng.

Truy xuất thông tin về chất lượng tập dữ liệu

Điểm cuối

https://graph.facebook.com/v24.0/dataset_quality

Thông số

Trường

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

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 Meta. Chất lượng so khớp sự kiện cao có thể cải thiện hoạt động phân bổ và hiệu quả quảng cáo.

Cách tính

Chất lượng so khớp sự kiện được tính 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 bằng 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 dùng để đánh giá liệu bạn có đang gửi thông tin khách hàng phù hợp thông 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à bạn đã 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 cho 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 (ví dụ: 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: Giám sát điểm 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, xây dựng đường xu hướng EMQ hoặc trích xuất dữ liệu lịch sử, sau đó thiết lập cảnh báo/bộ phát hiện giảm điểm EMQ và số lượng khóa so khớp.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về chẩn đoán EMQ trên trang dành cho nhà phát triển này.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>&fields=web{event_match_quality,event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_match_quality,event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'agent_name=<AGENT_NAME>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "event_match_quality": {
        "composite_score": 6.2,
        "match_key_feedback": [
          {
            "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": "ip_address",
            "coverage": {
              "percentage": 99.9
            }
          },
        ]
      },
      "event_name": "CompleteRegistration"
    }
   ]
 }
  

Lượt chuyển đổi được báo cáo thêm (ACR) cho thông số Chất lượng so khớp sự kiện

Lượt chuyển đổi được báo cáo thêm (ACR) là số liệu để bạn ước tính số lượt chuyển đổi (ví dụ: lượt mua hoặc lượt click vào liên kết) được ghi nhận nhờ việc nhà quảng cáo thiết lập API Chuyển đổi.

Để tìm hiểu thêm về số liệu này, hãy xem bài viết Giới thiệu về ACR và phần Tìm hiểu thêm.

Trường hợp sử dụng: Đối với sự kiện đã liên kết với API Chuyển đổi và có điểm EMQ, hãy giám sát độ cải thiện về số lượt chuyển đổi thêm mà API Chuyển đổi có thể mang lại khi bạn gửi thêm khóa so khớp và/hoặc gửi khóa so khớp có chất lượng cao hơn.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về ACR cho thông số EMQ trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>&fields=web{event_match_quality{match_key_feedback{identifier,potential_aly_acr_increase{percentage,description}}},event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_match_quality{match_key_feedback{identifier,potential_aly_acr_increase{percentage,description}}},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'agent_name=<AGENT_NAME>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "event_match_quality":
        "match_key_feedback": [
          {
            "identifier": "email",
            "potential_aly_acr_increase": {
              "percentage": 58.96,
              "description": "Similar advertisers who sent valid Email for Purchase saw a 58.96% median increase in their existing additional conversions reported."
            }
          },
          {
            "identifier": "ip_address",
            "potential_aly_acr_increase": {
              "percentage": 20.65,
              "description": "Similar advertisers who sent valid Ip Address for Purchase saw a 20.65% median increase in their existing additional conversions reported."
            }
          },
        ]
      }
      "event_name": "Purchase"
    },
  ]
}
  

Chẩn đoán EMQ

Chẩn đoán chất lượng so khớp sự kiện là vấn đề chúng tôi xác định được trong quá trình tích hợp API Chuyển đổi của bạn. Hãy làm theo các đề xuất được cung cấp để gửi khóa so khớp có chất lượng cao hơn, tối ưu hóa hiệu quả quảng cáo và cải thiện điểm EMQ.

Trường hợp sử dụng: Trích xuất và lưu trữ chẩn đoán EMQ trong môi trường của bạn, thiết lập thông báo qua các kênh như email, messenger hoặc thông báo trong ứng dụng để chủ động xử lý vấn đề.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về chẩn đoán EMQ trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>&fields=web{event_match_quality{diagnostics},event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_match_quality{diagnostics},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'agent_name=<AGENT_NAME>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "event_match_quality": {
        "diagnostics": [
          {
            "name": "Update your IPv4 IP addresses to IPv6 IP addresses",
            "description": "Your server is sending IPV4 IP addresses through the Conversions API. We recommend updating to IPV6 IP addresses because this is the industry standard and offers better durability for this integration.",
            "solution": "You can update your web server and DNS provider configuration to support IPv6. In your server payload, send the client_ip_address retrieved from customer interactions. Use the payload helper to see how this value should be structured when it's sent to Meta. If this issue is not applicable or actionable, you can ignore it.",
            "percentage": 59.5,
            "affected_event_count": 18930,
            "total_event_count": 31830
          },
          {
            "name": "Server sending mismatched IP addresses",
            "description": "Your server is sending client IP addresses that do not match those from Meta Pixel. This may impact the attribution and optimization of your ad campaigns.",
            "solution": "In your server payload, send the client_ip_address retrieved from customer interactions. Use the payload helper to see how this value should be structured when it's sent to Meta.",
            "percentage": 61.5,
            "affected_event_count": 19567,
            "total_event_count": 31830
          }
        ]
      }
      "event_name": "Purchase"
    },
  ]
}
  

Tỷ lệ sự kiện phù hợp

Tỷ lệ sự kiện phù hợp là tỷ lệ phần trăm sự kiện Meta Pixel trung bình trong 7 ngày do API Chuyển đổi báo cáo và có chung khóa bỏ trùng lặp với sự kiện từ API Chuyển đổi.

Tìm hiểu thêm về cách tốt nhất để tăng tỷ lệ sự kiện phù hợp bằng cách đọc bài viết này trong Trung tâm trợ giúp doanh nghiệp.

Trường hợp sử dụng: Đánh giá sự kiện được máy chủ kết nối so với sự kiện không được máy chủ kết nối. Ví dụ: Nếu một nhà quảng cáo có 3 sự kiện (ViewContent, AddToCart và Purchase) nhưng chỉ sự kiện Purchase được máy chủ gửi đi thì tỷ lệ sự kiện phù hợp sẽ là 33%.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về tỷ lệ sự kiện phù hợp trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&access_token=<ACCESS_TOKEN>&fields=web{event_coverage{percentage,goal_percentage,description},event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_coverage{percentage,goal_percentage,description},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{  
  "web": [
    {
      "event_coverage": {
        "percentage": 34.1,
        "goal_percentage": 75,
        "description": "The percentage of events received from your Conversions API compared to unique browser events from the Meta Pixel."
      },
      "event_name": "B2B Purchase"
    },
  ]
}

  

Lượt chuyển đổi được báo cáo thêm (ACR) cho Tỷ lệ sự kiện phù hợp

Lượt chuyển đổi được báo cáo thêm (ACR) cho Tỷ lệ sự kiện phù hợp là số liệu để bạn đánh giá lợi ích mà doanh nghiệp có được nhờ sử dụng API Chuyển đổi song song với Meta Pixel. Đối với tỷ lệ sự kiện phù hợp, bạn có thể có được cơ hội cải thiện lượt chuyển đổi được báo cáo thêm nếu cả tỷ lệ sự kiện phù hợp và quá trình bỏ trùng lặp đều đáp ứng các cách làm tốt nhất.

Để tìm hiểu về lượt chuyển đổi được báo cáo thêm, hãy xem bài viết Giới thiệu về ACR và phần Tìm hiểu thêm.

Trường hợp sử dụng: Đối với sự kiện đã liên kết với API Chuyển đổi và có tỷ lệ sự kiện phù hợp thấp hơn ngưỡng 75%, hãy giám sát độ cải thiện về số lượt chuyển đổi thêm mà API Chuyển đổi có thể mang lại khi báo cáo nhiều sự kiện hơn (tức là tỷ lệ sự kiện phù hợp từ máy chủ cao hơn so với từ trình duyệt).

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về ACR cho Tỷ lệ sự kiện phù hợp trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&access_token=<ACCESS_TOKEN>&fields=web{event_coverage{potential_aly_acr_increase{percentage,description}},event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_coverage{potential_aly_acr_increase{percentage,description}},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "event_coverage": {
        "potential_aly_acr_increase": {
          "percentage": 35.8,
          "description": "Similar advertisers who send the same AddToCart pixel events with matching deduplication keys through Conversions API saw a median of 35.8% additional conversions reported versus those that only used Meta Pixel."
        }
      },
      "event_name": "AddToCart"
    },
  ]
}
  

Bỏ trùng lặp sự kiện

Với Meta Pixel và API Chuyển đổi, bạn có thể chia sẻ sự kiện tiêu chuẩn và sự kiện tùy chỉnh với Meta để đo lường và tối ưu hóa hiệu quả quảng cáo. Với Pixel, bạn có thể chia sẻ sự kiện trên web từ trình duyệt web, còn với API Chuyển đổi, bạn chia sẻ được sự kiện trên web ngay từ máy chủ của mình.

Nếu bạn kết nối hoạt động trên trang web bằng cả Pixel lẫn API Chuyển đổi, chúng tôi có thể nhận được các sự kiện giống nhau từ trình duyệt và máy chủ. Nếu phát hiện ra những sự kiện giống nhau và do đó dư thừa, chúng tôi có thể giữ một sự kiện và bỏ số còn lại. Quá trình này gọi là bỏ trùng lặp.

Phản hồi của khóa bỏ trùng lặp cho biết tỷ lệ sự kiện từ Pixel và API Chuyển đổi nhận được với từng khóa bỏ trùng lặp. Bạn nên chia sẻ khóa bỏ trùng lặp cho tất cả các sự kiện của mình với tỷ lệ phần trăm càng cao càng tốt.

Để tìm hiểu thêm về cách làm tốt nhất đối với khóa bỏ trùng lặp, hãy xem bài viết trong Trung tâm trợ giúp doanh nghiệp.

Trường hợp sử dụng: Giám sát tỷ lệ bỏ trùng lặp giữa sự kiện trên trình duyệt và sự kiện trên máy chủ để góp phần tăng tỷ lệ sự kiện phù hợp cho sự kiện đã kết nối với API Chuyển đổi.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về phản hồi từ khóa bỏ trùng lặp trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>&fields=web{dedupe_key_feedback{dedupe_key,browser_events_with_dedupe_key{percentage,description},server_events_with_dedupe_key{percentage,description},overall_browser_coverage_from_dedupe_key{percentage,description}},event_name}

cURL

curl -X GET -G \ -d 'fields=web{dedupe_key_feedback{dedupe_key,browser_events_with_dedupe_key{percentage,description},server_events_with_dedupe_key{percentage,description},overall_browser_coverage_from_dedupe_key{percentage,description}},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'agent_name=<AGENT_NAME>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{ 
  "web": [
    {
      "dedupe_key_feedback": [
        {
          "dedupe_key": "event_id",
          "browser_events_with_dedupe_key": {
            "percentage": 100,
            "description": "The percentage of browser events that contain this dedupe key."
          },
          "server_events_with_dedupe_key": {
            "percentage": 100,
            "description": "The percentage of server events that contain this dedupe key."
          },
          "overall_browser_coverage_from_dedupe_key": {
            "percentage": 14.8,
            "description": "The overall percentage of browser events that are deduped with Conversions API events using this key. This percentage is incremental for each dedupe key."
          }
        },
        {
          "dedupe_key": "external_id",
          "browser_events_with_dedupe_key": {
            "percentage": 100,
            "description": "The percentage of browser events that contain this dedupe key."
          },
          "server_events_with_dedupe_key": {
            "percentage": 100,
            "description": "The percentage of server events that contain this dedupe key."
          },
          "overall_browser_coverage_from_dedupe_key": {
            "percentage": 15.96,
            "description": "The overall percentage of browser events that are deduped with Conversions API events using this key. This percentage is incremental for each dedupe key."
          }
        },
        {
          "dedupe_key": "fbp",
          "browser_events_with_dedupe_key": {
            "percentage": 0,
            "description": "The percentage of browser events that contain this dedupe key."
          },
          "server_events_with_dedupe_key": {
            "percentage": 0,
            "description": "The percentage of server events that contain this dedupe key."
          },
          "overall_browser_coverage_from_dedupe_key": {
            "percentage": 0,
            "description": "The overall percentage of browser events that are deduped with Conversions API events using this key. This percentage is incremental for each dedupe key."
          }
        }
      ],
      "event_name": "AddToCart"
    },
  ]
}
  

Độ mới của dữ liệu

Độ mới của dữ liệu cho biết độ trễ giữa thời điểm xảy ra sự kiện và thời điểm chúng tôi nhận được sự kiện. Cách làm tốt nhất là chia sẻ sự kiện của bạn theo thời gian thực hoặc gần với thời gian thực nhất có thể

Meta Pixel mặc định gửi các sự kiện trên trình duyệt web theo thời gian thực. Để nhận được giá trị tối đa từ sự kiện, bạn nên gửi sự kiện theo thời gian thực hoặc gần với thời gian thực nhất có thể. Khi gửi sự kiện có độ trễ, bạn có thể làm ảnh hưởng đến hiệu quả phân phối quảng cáo đến đúng đối tượng.

Để tìm hiểu thêm về cách làm tốt nhất đối với độ mới của dữ liệu, hãy xem bài viết trong Trung tâm trợ giúp doanh nghiệp.

Trường hợp sử dụng: Đánh giá tốc độ nhận sự kiện từ máy chủ so với sự kiện từ trình duyệt. Cải thiện tần suất thành real_time bất cứ khi nào có thể để nhận được giá trị tối đa từ sự kiện.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về độ mới của dữ liệu trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>&fields=web{data_freshness{upload_frequency,description},event_name}

cURL

curl -X GET -G \ -d 'fields=web{data_freshness{upload_frequency,description},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'agent_name=<AGENT_NAME>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{  
  "web": [
    {
      "data_freshness": {
        "upload_frequency": "real_time",
        "description": "The average frequency with which instances of this event are received through the Conversions API."
      },
      "event_name": "ViewContent"
    },
    {
      "data_freshness": {
        "upload_frequency": "hourly",
        "description": "The average frequency with which instances of this event are received through the Conversions API."
      },
      "event_name": "Lead"
    },
  ]
}
  

Lượt chuyển đổi được báo cáo thêm (ACR) cho Sự kiện API Chuyển đổi

Lượt chuyển đổi được báo cáo thêm (ACR) cho Sự Kiện API Chuyển đổi là số liệu để bạn ước tính số lượt chuyển đổi (ví dụ: lượt mua hoặc lượt click vào liên kết) được ghi nhận nhờ việc nhà quảng cáo thiết lập API Chuyển đổi.

Để tìm hiểu về lượt chuyển đổi được báo cáo thêm, hãy xem bài viết Giới thiệu về ACR và phần Tìm hiểu thêm.

Trường hợp sử dụng: Đối với Meta Pixel chưa kết nối API Chuyển đổi, hãy trích xuất số liệu lượt chuyển đổi được báo cáo thêm để ước tính mức độ tác động có thể có của quá trình tích hợp API Chuyển đổi.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về ACR cho sự kiện API Chuyển Đổi trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&access_token=<ACCESS_TOKEN>&fields=web{event_potential_aly_acr_increase{description,percentage},event_name}

cURL

curl -X GET -G \ -d 'fields=web{event_potential_aly_acr_increase{description,percentage},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "event_potential_aly_acr_increase": {
        "description": "Similar advertisers who set up Conversions API for Search events saw a median of 32.9% additional conversions reported versus those that only used Meta Pixel.",
        "percentage": 32.9
      },
      "event_name": "Search"
    },
    {
      "event_potential_aly_acr_increase": {
        "description": "Similar advertisers who set up Conversions API for PageView events saw a median of 30.1% additional conversions reported versus those that only used Meta Pixel.",
        "percentage": 30.1
      },
      "event_name": "PageView"
    }
  ]
}
  

Lượt chuyển đổi được báo cáo thêm (ACR)

Lượt chuyển đổi được báo cáo thêm (ACR) là số liệu để bạn đánh giá lợi ích mà doanh nghiệp có được nhờ sử dụng API Chuyển đổi song song với Meta Pixel. Bạn cũng có thể căn cứ vào số liệu này để xác định có thể cải thiện cách thiết lập API Chuyển đổi nhằm đo lường thêm nhiều lượt chuyển đổi được báo cáo hơn không. Khi có thêm nhiều lượt chuyển đổi được báo cáo, bạn có thể giảm chi phí trên mỗi kết quả và hiển thị quảng cáo cho những người cảm thấy quảng cáo đó phù hợp.

Để tìm hiểu về lượt chuyển đổi được báo cáo thêm, hãy xem bài viết Giới thiệu về ACR và phần Tìm hiểu thêm.

Trường hợp sử dụng: Đối với sự kiện đã liên kết với API Chuyển đổi và có điểm EMQ, hãy giám sát độ cải thiện về số lượt chuyển đổi thêm mà API Chuyển đổi có thể mang lại.

Tài liệu: Bạn có thể tìm thấy tất cả các trường có sẵn về ACR trong tài liệu dành cho nhà phát triển tại đây.

Ví dụ

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

GET/v24.0/dataset_quality?dataset_id=<DATASET_ID>&access_token=<ACCESS_TOKEN>&fields=web{acr{description,percentage},event_name}

cURL

curl -X GET -G \ -d 'fields=web{acr{description,percentage},event_name}' \ -d 'dataset_id=<DATASET_ID>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/dataset_quality 

Phản hồi API

{
  "web": [
    {
      "acr": {
        "description": "In the last 7 days, you saw about 37.9% more conversions reported for Search events by using the Conversions API alongside the Meta Pixel.",
        "percentage": 37.9
      },
      "event_name": "Search"
    },
    {
      "acr": {
        "description": "In the last 7 days, you saw about 45.5% more conversions reported for Page View events by using the Conversions API alongside the Meta Pixel..",
        "percentage": 45.5
      },
      "event_name": "PageView"
    }
  ]
}
  

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

Tìm hiểu thêm

1. Cách làm tốt nhất đối với API Chuyển đổi.

2. Thúc đẩy hiệu quả với cách thiết lập API Chuyển đổi được tối ưu hóa.

3. Tối ưu hóa cách thiết lập để cải thiện hiệu quả marketing.

4. Cách tốt nhất để tích hợp API Chuyển đổi cho đối tác.

5. Hướng dẫn về chất lượng tập dữ liệu API Chuyển đổi trong Trung tâm trợ giúp doanh nghiệp:

• Cách làm tốt nhất đối với API Chuyển đổi để 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ó 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ủ (Chất lượng so khớp sự kiện, Độ 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.

1. Lượt chuyển đổi được báo cáo thêm:

• Giới thiệu về lượt chuyển đổi được báo cáo thêm.
• Khắc phục sự cố không hiển thị lượt chuyển đổi được báo cáo thêm.
• Cách diễn giải lượt chuyển đổi được báo cáo thêm