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

Trong Hộp cát về quyền riêng tư, Chrome đã đề xuất Protected Audience (Đối tượng được bảo vệ) API – một API trong trình duyệt giú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 được 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 theo dõi.

Trong Protected Audience API, khi một quảng cáo tái tiếp thị thắng phiên đấu giá, quảng cáo sẽ hiển thị URL của quảng cáo sẽ được gửi đến chức năng Được bảo vệ Khung dành cho kết xuất hình ảnh. Khung bảo vệ là một phần tử HTML được đề xuất cho nội dung được 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 khi chia sẻ dữ liệu đó với ngữ cảnh nhúng. Để biết thêm thông tin, hãy tham khảo Trường hợp sử dụng tính năng Khung bảo vệ video giải thích.

Hiển thị và Video 360 hỗ trợ danh sách macro để đo lường để theo dõi lượt hiển thị và lượt nhấp. Chỉ một nhóm nhỏ có thể được thay thế như một phần của hiển thị quảng cáo, do thiếu ngữ cảnh và tín hiệu đấu giá. Ví dụ: ${PUBLISHER_ID} sẽ bị lỗi mà không thay đổi vào 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 muốn theo dõi sự kiện cho những nhà quảng cáo sử dụng chiến dịch Hiển thị và 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 bên dưới để tự đăng ký sử dụng API Báo cáo khung bảo vệ trong Protected API Đối tượng.

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

Tích hợp

Thẻ lượt 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ập nhật các thẻ tập lệnh để sử dụng API reportEvent để 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: Hiển thị và Video 360 để cập nhật thẻ img src để sử dụng API reportEvent để theo dõi lượt hiển thị.

API reportEvent

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

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

reportEvent chỉ lấy 1 giá trị nhập "destinationURL". URL này trỏ đến đến máy chủ của nhà cung cấp dịch vụ đo lường. Tệp này có thể chứa bất kỳ macro nào được liệt kê trong Hiển thị và Trợ giúp 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 ping URL trong hàm này, URL này sẽ tra cứu những URL đã đăng ký và thay thế chúng bằng các giá trị trước khi gửi yêu cầu HTTP GET tới https://adtech.example.

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

Sẽ không có thay đổi nào đối với các thẻ mẫu quảng cáo hiện có. Hiển thị và Ảnh tĩnh trong video 360 hiển thị thẻ nhà cung cấp dịch vụ đo lường mà không cần sửa đổi mẫu quảng cáo tải trọng. Khi nhà cung cấp dịch vụ đo lường nhận được ping lượt hiển thị từ Protected Ngữ cảnh API Đối tượng, họ cần làm theo các bước dưới đây để có lượt hiển thị theo dõi:

  1. 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

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

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

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

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

Thẻ nhấp chuột 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ị sử dụng Protected Audience API. Hiển thị và Video 360 sẽ sử dụng API Báo cáo quảng cáo Khung bảo vệ reserved.top_navigation beacon để đăng ký lượt nhấp và sẽ tạo chuỗi 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, hãy tham khảo Tài liệu của Chrome về tính năng Báo cáo quảng cáo sử dụng khung bảo vệ .