Trang này được dịch bởi Cloud Translation API.

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

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

Trình kích hoạt phân bổ là sự kiện yêu cầu trình duyệt ghi lại các 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ý điều kiện kích hoạt để đăng ký lượt chuyển đổi mà sau đó trình duyệt 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ý trình kích hoạt, hãy sử 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 phản hồi bằng một tiêu đề phản hồi HTTP đăng ký điều kiện kích hoạt.

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

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

Bắt đầu đăng ký điều kiện kích hoạt. Sử dụng pixel hoặc lệnh gọi fetch() để thực hiện yêu cầu.
Hoàn tất quá trình đăng ký điều kiện kích hoạt bằng cách phản hồi bằng điều kiện kích hoạt tiêu đề đăng ký.

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 điểm cuối được xác định trong attributionsrc nếu bạn đã chọn sử dụng attributionsrc và cung cấp một giá trị — phản hồi bằng tiêu đề Attribution-Reporting-Register-Trigger.

Trong tiêu đề này, hãy chỉ định dữ liệu điều kiện kích hoạt bạn muốn xuất hiện trong đó báo cáo cuối cùng. Mọi phản hồi đều có thể đặt tiêu đề này. Miễn 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, nguồn dữ liệu 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 cho một 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
  }
}
```

Lưu ý: Khi trình duyệt nhận được phản hồi điều kiện kích hoạt phân bổ từ một URL attributionsrc trên một trang nhất định, hệ thống sẽ tra cứu bộ nhớ cục bộ để tìm một nguồn khớp với cả trang web gốc và đích đến attributionsrc thuộc về trang đó. Nếu tìm thấy nhiều nguồn, trình duyệt sẽ chọn nguồn được lưu trữ gần đây nhất, trừ phi có mức độ ưu tiên khác, trong đó trình duyệt sẽ chọn nguồn có mức độ ưu tiên cao nhất.

Xử lý miền con

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

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

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 đây để biết chi tiết về những trường hợp cần thay đổi là bắt buộc.

Khi attributionsrc là không bắt buộc, việc sử dụng thuộc tính này cho biết rằng yêu cầu đủ điều kiện cho 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. Mô hình này cũng rất hữu ích cho mô hình từ ứng dụng đến web đo lường: 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: Neo không thể đăng ký điều kiện kích hoạt.
Thẻ `<img>`	`attributionsrc` là không bắt buộc. Tiêu đề là đủ để đăng ký một điều kiện kích hoạt.
Thẻ `<script>`	`attributionsrc` là không bắt buộc. Tiêu đề là đủ để đăng ký một điều kiện kích hoạt.
`fetch` cuộc gọi	Tuỳ chọn `attributionReporting` là bắt buộc.
`XMLHttpRequest`	Tuỳ chọn `attributionReporting` là bắt buộc.
`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ý điều kiện kích hoạt bằng thẻ 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 hoạt động phân bổ cho 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 đã thực hiện đă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 thuộc tính pixel chuyển đổi attributionsrc mới.

Nguồn gốc của src phải khớp với nguồn đã thực hiện đă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; hoạt động giống hệt như <img>. Các mã mẫu sau đây minh hoạ cách sử dụng fetch() và XMLHttpRequest() (XHR).

Mã này mô phỏng một cách hiệu quả những việc mà một yêu cầu HTML có attributionsrc sẽ làm:

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

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

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

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

`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 giá trị cho attributionsrc thì đó 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 URL sẽ khiến trình duyệt bắt đầu một yêu cầu tìm nạp duy trì hoạt động riêng biệt—một yêu cầu cho mỗi URL (bao gồm cả yêu cầu Attribution-Reporting-Eligible) .

Điều này rất hữu ích nếu bạn muốn đăng ký điều kiện kích hoạt bằng cách phản hồi yêu cầu này tách biệt với yêu cầu chính của phần tử.

Ví dụ: nếu bạn cần đăng ký trình kích hoạt trên một phần tử hình ảnh, 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ấu hình 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 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. Theo chỉ định một giá trị rõ ràng cho attributionsrc, bạn sẽ hướng dẫn phương thức trình duyệt để thực hiện yêu cầu bổ sung đó và định cấu hình đích đến.

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à đưa tiêu đề Attribution-Reporting-Register-Trigger vào phản hồi:

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

Thận trọng: Giá trị trường event_trigger_data phải được lồng trong dấu ngoặc vuông, vì trình duyệt yêu cầu mảng JSON. Thông tin này rất hữu ích cho các bộ lọc.

Các bước tiếp theo

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