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 số 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 nhận 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 để ghi lại những 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à số 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 sử dụng các phần tử HTML hoặc lệnh gọi JavaScript:

Thẻ <a>
Thẻ <img>
Thẻ <script>
fetch cuộc gọi
XMLHttpRequest
window.open

Thao tác này 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ý một điều kiện kích hoạt để phân bổ lượt chuyển đổi

Việc đăng ký một điều kiện kích hoạt cũng tương tự như đăng ký 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à thông tin tóm tắt:

Bắt đầu quy trình đă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.
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 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à cung cấp một giá trị – 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 điều kiện kích hoạt mà bạn muốn cuối cùng 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 yêu cầu được đưa ra từ một trang web khớp với destination, thì 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]"
  }]
}
```

**Example for summary reports:**

```json
{
  ... // 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à miền con của nó, chẳng hạn như https://shop.advertiser.example, 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 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ý điều kiện 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 bắt buộc phải có những dữ liệu này.

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 để sử dụng 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. Việc này cũng hữu ích cho việc đ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 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ý điều kiện kích hoạt.
Thẻ `<script>`	`attributionsrc` là không bắt buộc. Tiêu đề là đủ để đăng ký điều kiện kích hoạt.
`fetch` cuộc gọi	Bắt buộc phải sử dụng tuỳ chọn `attributionReporting`.
`XMLHttpRequest`	Bắt buộc phải sử dụng tuỳ 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 quy trình đă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ó

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

Lưu ý quan trọng: * Nguồn gốc của src phải khớp với nguồn thực hiện quá trình đăng ký nguồn. * Chỉ có thể kích hoạt mô hình phân bổ trên trang có eTLD+1 khớp với trang web đã được cung cấp tại đích đến khi đăng ký nguồn.

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 với <img>. Các mã mẫu sau đây minh hoạ việc sử dụng fetch() và XMLHttpRequest() (XHR).

Mã này mô phỏng hiệu quả các hoạt động của một yêu cầu HTML có attributionsrc:

// With fetch
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 });

// With XMLHttpRequest:
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 giá trị cho attributionsrc, giá trị đó phải là một URL duy nhất.

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ả tiêu đề yêu cầu Attribution-Reporting-Eligible.

Việc này rất hữu ích nếu bạn muốn đăng ký nguồn 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ý nguồn cho các lượt nhấp vào một thành phần neo, bạn có thể không thực sự nắm quyền kiểm soát đích đến; trong trường hợp này, bạn cần có một cấu hình trong đó bạn gửi tiêu đề đăng ký nguồn dưới dạng phản hồi cho một yêu cầu tách biệt với thành phần điều hướng và bạn hoàn toàn có thể kiểm soát. Bằng việc 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.

Bước 2: Phản hồ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ổ.

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

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

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

Xử lý miền con

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

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

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

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

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

Bước 2: Phản hồi bằng tiêu đề

Các bước tiếp theo

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