Đăng ký trình kích hoạt phân bổ

Tìm hiểu cách đăng ký các điều kiện kích hoạt phân bổ để tính số lượt chuyển đổi.

Trình kích hoạt phân bổ là sự kiện cho biết trình duyệt sẽ ghi lại lượt chuyển đổi.

Bằng cách làm theo các bước trong tài liệu này, bạn có thể đăng ký các điều kiện kích hoạt để đăng ký lượt chuyển đổi mà sau đó trình duyệt sẽ phân bổ cho các sự kiện nguồn có liên quan, cụ thể là lượt hiển thị quảng cáo hoặc lượt nhấp vào quảng cáo.

Phương thức đăng ký

Để đăng ký điều kiện kích hoạt, hãy dùng các phần tử HTML hoặc lệnh gọi JavaScript:

  • Thẻ <img>
  • Thẻ <script>
  • fetch cuộc gọi
  • XMLHttpRequest

Thao tác này sẽ tạo ra các yêu cầu mạng mà sau đó bạn sẽ phản hồi bằng tiêu đề phản hồi HTTP đăng ký điều kiện kích hoạt.

Đăng ký điều kiện kích hoạt để phân bổ lượt chuyển đổi

Việc đăng ký điều kiện kích hoạt tương tự như đăng ký một sự kiện nguồn phân bổ. Các bước hoàn chỉnh sẽ được mô tả ở phần sau. Sau đây là nội dung tóm tắt:

  1. Bắt đầu đăng ký điều kiện kích hoạt. Sử dụng pixel hoặc lệnh gọi fetch() để đưa ra yêu cầu.

  2. Hoàn tất quy trình đăng ký điều kiện kích hoạt bằng cách phản hồi bằng tiêu đề đăng ký điều kiện kích hoạt.

    Khi nhận được yêu cầu pixel (được gửi đến điểm cuối được xác định trong thuộc tính src thông thường hoặc đến điểm cuối được xác định trong attributionsrc nếu bạn đã chọn sử dụng attributionsrc và đã chỉ định giá trị cho thuộc tính này), hãy phản hồi bằng tiêu đề Attribution-Reporting-Register-Trigger.

    Trong tiêu đề này, hãy chỉ định dữ liệu về điều kiện kích hoạt mà bạn muốn xuất hiện trong báo cáo. Mọi phản hồi đều có thể đặt tiêu đề này. Miễn là đó là phản hồi cho một yêu cầu được đưa ra từ một trang web khớp với destination, các nguồn sẽ được so khớp. Khi nhận được tiêu đề, trình duyệt sẽ tìm các nguồn phù hợp và lên lịch báo cáo.

    Ví dụ về báo cáo cấp sự kiện:

    {
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}

    Ví dụ về báo cáo tóm tắt:

    {
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}

Xử lý miền con

Nếu destination là https://advertiser.example, thì lượt chuyển đổi trên cả https://advertiser.example và các miền con của miền đó (chẳng hạn như https://shop.advertiser.example) đều có thể được phân bổ.

Nếu destination là https://shop.advertiser.example, thì lượt chuyển đổi trên cả https://advertiser.example và https://shop.advertiser.example đều có thể được phân bổ.

Thuộc tính bắt buộc và không bắt buộc

Khi sử dụng các phần tử HTML hoặc thực hiện lệnh gọi JavaScript để đăng ký trình kích hoạt, bạn có thể cần sử dụng attributionsrc hoặc attributionReporting. Hãy tham khảo bảng sau để biết thông tin chi tiết về thời điểm cần có những thông tin này.

Khi attributionsrc là không bắt buộc, việc sử dụng tham số này cho biết rằng yêu cầu đủ điều kiện nhận Báo cáo phân bổ. Nếu bạn sử dụng attributionsrc, trình duyệt sẽ gửi tiêu đề Attribution-Reporting-Eligible. Tham số này cũng hữu ích cho hoạt động đo lường từ ứng dụng đến web: nếu có attributionsrc, trình duyệt sẽ gửi tiêu đề Attribution-Reporting-Support.

Phương thức đăng ký Điều kiện kích hoạt
Thẻ <a> Không áp dụng: Các điểm neo không thể đăng ký một điều kiện kích hoạt.
Thẻ <img> attributionsrc là không bắt buộc. Tiêu đề này đủ để đăng ký một điều kiện kích hoạt.
Thẻ <script> attributionsrc là không bắt buộc. Tiêu đề này đủ để đăng ký một điều kiện kích hoạt.
fetch cuộc gọi Bạn phải cung cấp lựa chọn attributionReporting.
XMLHttpRequest Bạn phải cung cấp lựa chọn attributionReporting.
window.open() Không áp dụng: window.open không thể đăng ký điều kiện kích hoạt.

Bước 1: Bắt đầu đăng ký điều kiện kích hoạt

Bạn có thể đăng ký một điều kiện kích hoạt bằng cách sử dụng pixel (thẻ <img>) hoặc thẻ tập lệnh.

Sử dụng pixel chuyển đổi mới hoặc hiện có

Ví dụ sau đây kích hoạt mô hình phân bổ trên một hình ảnh hiện có bằng cách thêm thuộc tính attributionsrc.

Nguồn gốc của attributionsrc phải khớp với nguồn gốc đã thực hiện quy trình đăng ký nguồn.

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

Ví dụ tiếp theo sẽ kích hoạt hoạt động phân bổ bằng cách thêm một thuộc tính pixel chuyển đổi mới attributionsrc.

Nguồn gốc của src phải khớp với nguồn gốc đã thực hiện quy trình đăng ký nguồn.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Sử dụng thẻ tập lệnh

Bạn có thể thực hiện đăng ký điều kiện kích hoạt bằng thẻ tập lệnh; thẻ này hoạt động giống hệt như <img>. Các mẫu mã sau đây minh hoạ cách sử dụng fetch() và XMLHttpRequest() (XHR).

Đoạn mã này mô phỏng hiệu quả những gì mà một yêu cầu HTML có attributionsrc sẽ làm:

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to make sure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();

attributionsrc có hoặc không có giá trị

Bạn có thể thêm attributionsrc có hoặc không có giá trị.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

Nếu bạn đặt một giá trị cho attributionsrc, thì giá trị đó có thể là một hoặc nhiều URL được phân tách bằng dấu cách.

Việc sử dụng một URL sẽ khiến trình duyệt bắt đầu một yêu cầu tìm nạp riêng biệt keepalive – một yêu cầu cho mỗi URL – bao gồm cả tiêu đề yêu cầu Attribution-Reporting-Eligible.

Điều này sẽ hữu ích nếu bạn muốn thực hiện quy trình đăng ký điều kiện kích hoạt bằng cách phản hồi một yêu cầu tách biệt với yêu cầu chính của phần tử.

Ví dụ: nếu cần đăng ký các điều kiện kích hoạt trên một phần tử hình ảnh, thì bạn có thể không thực sự kiểm soát được phản hồi hình ảnh; trong trường hợp này, bạn sẽ muốn có một cấu hình mà theo đó bạn gửi tiêu đề đăng ký điều kiện kích hoạt dưới dạng phản hồi cho một yêu cầu tách biệt với hình ảnh và bạn có thể kiểm soát hoàn toàn. Bằng cách chỉ định một giá trị rõ ràng cho attributionsrc, bạn đang hướng dẫn trình duyệt thực hiện yêu cầu bổ sung đó và định cấu hình đích đến của yêu cầu.

Bước 2: Trả lời bằng tiêu đề

Khi nhận được yêu cầu của trình duyệt, hãy phản hồi và thêm tiêu đề Attribution-Reporting-Register-Trigger vào phản hồi của bạn:

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

Các bước tiếp theo

Tìm hiểu cách Đăng ký nguồn phân bổ.