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

Hướng dẫn tích hợp Protected Audience (trước đây là FLEDGE) dành cho Nhà cung cấp dịch vụ đo lường

Là một phần của Hộp cát về quyền riêng tư, Chrome đã đề xuất Protected Audience API – một API trong trình duyệt cho phép các nhà quảng cáo và công ty công nghệ quảng cáo hiển thị quảng cáo nhắm mục tiêu theo nhóm mối quan tâm mà không cần dựa vào cookie của bên thứ ba, đồng thời bảo vệ người dùng khỏi việc theo dõi trên nhiều trang web.

Trong Protected Audience API, khi một quảng cáo tái tiếp thị giành chiến thắng trong phiên đấu giá, URL hiển thị của quảng cáo đó sẽ được gửi đến một Khung bảo vệ để hiển thị. Khung bảo vệ là một phần tử HTML được đề xuất cho nội dung nhúng, tương tự như iframe. Không giống như iframe, khung bảo vệ hạn chế hoạt động giao tiếp với ngữ cảnh nhúng để cho phép khung truy cập vào dữ liệu trên nhiều trang web mà không cần chia sẻ dữ liệu đó với ngữ cảnh nhúng. Để biết thêm thông tin chi tiết, hãy tham khảo Giải thích về các trường hợp sử dụng Khung bảo vệ.

Display & Video 360 hỗ trợ danh sách macro cho nhà cung cấp dịch vụ đo lường nhằm sử dụng cho việc theo dõi lượt hiển thị và lượt nhấp. Chỉ một số ít các macro này có thể được thay thế trong quá trình hiển thị mẫu quảng cáo, do thiếu tín hiệu về bối cảnh và phiên đấu giá. Ví dụ: ${PUBLISHER_ID} sẽ bị lỗi mà không có thay đổi nào đối với thẻ nhà cung cấp dịch vụ đo lường.

Hướng dẫn này dành cho những đối tác đo lường quảng cáo theo dõi sự kiện đối với những nhà quảng cáo sử dụng Display & Video 360.

Đăng ký

Kể từ tháng 8 năm 2023, các nhà cung cấp dịch vụ đo lường có thể cần làm theo các bước dưới đây để tự đăng ký sử dụng API Báo cáo khung bảo vệ trong Protected Audience API.

Thông tin chi tiết về cách thức và đối tượng cần đăng ký

Tích hợp

Thẻ hiển thị của nhà cung cấp dịch vụ đo lường

Hướng dẫn thiết lập:

Thẻ tập lệnh	Ví dụ <script src='https://tracking.com/a.js'>xxx</script> Trách nhiệm: Nhà cung cấp dịch vụ đo lường cần cập nhật các thẻ tập lệnh để sử dụng API `reportEvent` cho việc theo dõi lượt hiển thị (xem hướng dẫn bên dưới).
Thẻ Img	Ví dụ <img src='https://tracking.com/'> Trách nhiệm: Display & Video 360 cập nhật thẻ img src để sử dụng API `reportEvent` cho việc theo dõi lượt hiển thị.

API reportEvent

API này được đề xuất sử dụng chỉ để theo dõi sau khi kết xuất. API này gồm hai phần: registerAdMacro và reportEvent.

Display & Video 360 sở hữu hàm registerAdMacro trong reportWin. Hàm sẽ đăng ký các cặp khoá-giá trị macro trong trình duyệt trước lệnh gọi hiển thị.
Tuỳ thuộc vào loại thẻ, Display & Video 360 hoặc các nhà cung cấp dịch vụ đo lường sẽ sở hữu các thay đổi đối với thẻ 3PAT để sử dụng API reportEvent.

reportEvent chỉ nhận 1 đầu vào "destinationURL" trỏ đến máy chủ của nhà cung cấp dịch vụ đo lường. Loại macro này có thể chứa bất kỳ macro nào có trong Trung tâm trợ giúp Display & Video 360. Ví dụ:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Khi Chrome kích hoạt lệnh ping URL trong hàm, Chrome sẽ tra cứu các macro đã đăng ký và thay thế chúng bằng các giá trị trước khi gửi yêu cầu HTTP GET đến https://adtech.example.

Các bước để cập nhật thẻ tập lệnh

Không có gì thay đổi đối với các thẻ mẫu quảng cáo hiện có. Display & Video 360 vẫn hiển thị các thẻ nhà cung cấp dịch vụ đo lường mà không cần sửa đổi trong tải trọng mẫu quảng cáo. Khi nhận được ping lượt hiển thị từ ngữ cảnh Protected Audience API, các nhà cung cấp dịch vụ đo lường cần làm theo các bước bên dưới để theo dõi lượt hiển thị:

Chuẩn bị URL hiển thị của nhà cung cấp dịch vụ đo lường để chấp nhận các ping lượt hiển thị. Ví dụ:
```
https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123
```

Thêm JS reportEvent khi phản hồi một tập lệnh từ Protected Audience API. Ví dụ:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Ghi lại các lượt hiển thị khi nhận được ping từ URL lượt hiển thị được định cấu hình ở bước 1.

Thẻ nhấp của nhà cung cấp dịch vụ đo lường

Thẻ lượt nhấp của nhà cung cấp dịch vụ đo lường hiện có sẽ tiếp tục hoạt động cho các lượt hiển thị trong Protected Audience. Display & Video 360 sẽ sử dụng báo hiệu reserved.top_navigation của API Báo cáo quảng cáo khung bảo vệ để đăng ký lượt nhấp, đồng thời liên kết tất cả trình theo dõi lượt nhấp của nhà cung cấp dịch vụ đo lường dưới dạng lệnh chuyển hướng. Để biết thêm thông tin chi tiết, hãy tham khảo Tài liệu của Chrome về API Báo cáo quảng cáo trên khung bảo vệ.