Báo cáo về kết quả đấu giá Protected Audience API

Hướng dẫn dành cho người bán và người mua để tạo báo cáo đấu giá Protected Audience API.

Bài viết này là tài liệu tham khảo kỹ thuật để tạo báo cáo cho các chiến thắng trong phiên đấu giá Protected Audience API, như được sử dụng trong phiên bản hiện tại của Protected Audience API thử nghiệm.

Đọc hướng dẫn cho nhà phát triển để biết toàn bộ vòng đời của Protected Audience API và tham khảo tài liệu giải thích về Protected Audience API để nắm được nội dung thảo luận chuyên sâu về báo cáo ở cấp sự kiện (tạm thời).

Bạn không phải nhà phát triển? Tham khảo tổng quan về Protected Audience API.

Protected Audience API báo cáo nội dung gì?

Hiện có hai báo cáo Protected Audience API:

  • Báo cáo của người bán: Thông báo cho người bán về người chiến thắng trong phiên đấu giá quảng cáo.
  • Báo cáo người mua: Chỉ dành cho những người mua giành chiến thắng, để biết rằng họ đã thắng phiên đấu giá.

Kế hoạch dài hạn là cho phép trình duyệt báo cáo kết quả phiên đấu giá cho người bán và người mua bằng API Tổng hợp riêng tư. Là một cơ chế báo cáo tạm thời ở cấp sự kiện, mã triển khai reportResult() cho người bán và reportWin() cho bên đặt giá thầu thắng cuộc, có thể gọi hàm sendReportTo(). Phương thức này sẽ lấy một đối số duy nhất: một chuỗi đại diện cho một URL được tìm nạp sau khi phiên đấu giá hoàn tất, giúp mã hoá thông tin ở cấp sự kiện cần báo cáo.

Các hàm API

Người bán: reportResult()

JavaScript của người bán được cung cấp trong decisionLogicUrl (cũng cung cấp scoreAd()) có thể bao gồm hàm reportResult() để báo cáo kết quả của phiên đấu giá.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

Các đối số được truyền đến hàm này là:

auctionConfig

Đối tượng cấu hình phiên đấu giá được truyền đến navigator.runAdAuction().

browserSignals

Đối tượng được tạo bởi trình duyệt cung cấp thông tin về phiên đấu giá. Ví dụ:

  {
    'topWindowHostname': 'publisher.example',
    'interestGroupOwner': 'https://dsp.example',
    'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
    'bid': <bidValue>,
    'desirability': <winningAdScore>
  }

Giá trị trả về của hàm này được dùng làm đối số sellerSignals cho hàm reportWin() của bên đặt giá thầu giành chiến thắng.

Người mua: reportWin()

JavaScript của bên đặt giá thầu giành chiến thắng (cũng cung cấp generateBid()) có thể bao gồm hàm reportWin() để báo cáo kết quả phiên đấu giá.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}

Các đối số được truyền đến hàm này là:

auctionSignals và perBuyerSignals

Các giá trị tương tự đã được chuyển đến generateBid() cho bên đặt giá thầu chiến thắng.

sellerSignals

Giá trị trả về của reportResult(), giúp người bán có cơ hội truyền thông tin đến người mua.

browserSignals

Đối tượng được tạo bởi trình duyệt cung cấp thông tin về phiên đấu giá. Ví dụ:

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid': <bidValue>
}

Triển khai báo cáo tạm thời

Có hai phương thức tạm thời có sẵn trong Chrome để báo cáo phiên đấu giá:

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

Mỗi phương thức này sẽ lấy một đối số duy nhất: một URL để tìm nạp sau khi phiên đấu giá hoàn tất. Các URL này có thể được gọi nhiều lần, trong cả scoreAd() và generateBid(), với các đối số URL khác nhau.

Chrome chỉ gửi báo cáo gỡ lỗi/thắng/thua khi phiên đấu giá kết thúc. Nếu phiên đấu giá bị huỷ (ví dụ: do một thao tác mới), thì sẽ không có báo cáo nào được tạo.

Những phương thức này có sẵn trong Chrome theo mặc định khi bạn bật tất cả các API Quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy. Nếu đang chạy Chrome có cờ dòng lệnh để bật Protected Audience API, bạn cần phải bật các phương thức một cách rõ ràng bằng cách thêm cờ BiddingAndScoringDebugReportingAPI. Nếu cờ này không được bật, các phương thức sẽ vẫn có sẵn nhưng không làm gì cả.

Tất cả tệp tham chiếu đến Protected Audience API

Hướng dẫn tham khảo API có sẵn:

Thông tin giải thích về Protected Audience API cũng cung cấp thông tin chi tiết về các quy tắc hỗ trợ và các quy tắc ràng buộc của tính năng.

Tiếp theo là gì?

Chúng tôi muốn thảo luận với bạn để đảm bảo việc xây dựng một API phù hợp với tất cả mọi người.

Thảo luận về API

Giống như các API Hộp cát về quyền riêng tư khác, API này được ghi lại và thảo luận công khai.

Thử nghiệm với API

Bạn có thể thử nghiệm và tham gia cuộc trò chuyện về Protected Audience API.