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ẻ <a>
Thẻ <img>
Thẻ <script>
fetch cuộc gọi
XMLHttpRequest
window.open

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

Quá trình đăng ký một đ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 một 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 giá trị cho nó, thì 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 cuối cùng sẽ xuất hiện trong các 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, 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 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]"
  }]
}
```

**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
  }
}
```
```

Lưu ý: Khi trình duyệt nhận được phản hồi của đ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 attributionsrc chứa 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, thì các 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ì các 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 phải sử dụng attributionsrc hoặc attributionReporting. Hãy tham khảo bảng sau đây để biết thông tin chi tiết về các trường hợp 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. 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 đề đủ để đăng ký một điều kiện kích hoạt.
Thẻ `<script>`	`attributionsrc` là không bắt buộc. Tiêu đề đủ để đă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ể đă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 với <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:

// 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 thiết lập giá trị cho attributionsrc, giá trị đó phải là một URL đơn lẻ.

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.

Điều 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 phần tử neo, thì bạn có thể không thực sự kiểm soát đích đến; trong trường hợp này, bạn sẽ cần một cấu hình để 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 có thể kiểm soát hoàn toàn. Bằng việc chỉ định một giá trị rõ ràng cho attributionsrc, bạn sẽ 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: 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'})

Các bước tiếp theo

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