Protected Audience API (trước đây là FLEDGE)

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.

Chrome đang chạy một bản dùng thử theo nguyên gốc cho Protected Audience API. Authorized Buyers đủ điều kiện tham gia thử nghiệm Protected Audience API trên khoảng không quảng cáo của nhà xuất bản Ad Manager. Bên đặt giá thầu có thể đạt được những lợi ích sau bằng cách thử nghiệm Protected Audience API:

  • Lặp lại và tìm hiểu về hiệu quả của các quy trình Protected Audience API.
  • Tạo ý kiến phản hồi về các điểm cải tiến tiềm năng của API trên các diễn đàn công khai, ví dụ: GitHub.
  • Chuẩn bị cho việc hỗ trợ quảng cáo được cá nhân hoá thông qua API mà không cần dựa vào cookie của bên thứ ba.

Những Authorized Buyers muốn thử nghiệm nên xem phần Làm quen để biết thông tin chi tiết.

Tóm tắt quy trình phân phát

Dưới đây là thông tin tóm tắt về quy trình phân phát quảng cáo Protected Audience cho các đối tác Authorized Buyers:

Sơ đồ quy trình

  1. Người đặt giá thầu làm việc với nhà quảng cáo để duy trì nhóm mối quan tâm cho từng nhà quảng cáo nhà quảng cáo. Thông thường, nhà quảng cáo sẽ thêm thẻ của bên đặt giá thầu vào trang của nhà quảng cáo để thêm trình duyệt vào nhóm sở thích.
  2. Người dùng cuối truy cập vào trang của nhà quảng cáo. Trang này có thể chứa thông tin .
  3. Thẻ của bên đặt giá thầu gọi Protected Audience API joinAdInterestGroup(). Lệnh gọi này yêu cầu trình duyệt thêm người dùng vào một nhóm mối quan tâm.
  4. Người dùng cuối truy cập vào trang web của nhà xuất bản. Trình duyệt của người dùng yêu cầu thẻ quảng cáo của nhà xuất bản của Google.
  5. Thẻ quảng cáo dành cho nhà xuất bản của Google tạo yêu cầu quảng cáo theo ngữ cảnh đến máy chủ của Google.
  6. Google gửi yêu cầu giá thầu theo bối cảnh cho các bên đặt giá thầu tham gia. Hãy xem phần Thay đổi về yêu cầu giá thầu để biết thêm thông tin.
  7. Bên đặt giá thầu trả về một phản hồi giá thầu bao gồm thông báo InterestGroupBidding cần thiết để tham gia phiên đấu giá theo nhóm mối quan tâm. Trong OpenRTB, thông tin này được chỉ định bằng trường BidResponse.ext.igbid và trong giao thức RTB của Google không còn được dùng nữa, thông tin này được chỉ định bằng trường BidResponse.interest_group_bidding. Nếu bên đặt giá thầu không chỉ định thông tin này, Google sẽ không đưa nguồn gốc của bên đặt giá thầu vào interestGroupBuyers trong cấu hình phiên đấu giá. InterestGroupBidding cũng có thể chứa các tín hiệu không bắt buộc dành riêng cho người mua sẽ được chuyển đến chức năng đặt giá thầu của bên đặt giá thầu trong trình duyệt phiên đấu giá. Trong OpenRTB, thông tin này được chỉ định bằng trường BidResponse.ext.igbid.igbuyer.buyerdata và trong các trường không dùng nữa Giao thức RTB của Google. Giao thức này được chỉ định bằng BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals . Xem phần Các thay đổi về giá thầu phản hồi để thông tin khác.
  8. Google chạy phiên đấu giá phía máy chủ và trả về giá thầu phản hồi cho trình duyệt. Phiên đấu giá phía máy chủ xem xét giá thầu truyền thống phía máy chủ. Phản hồi giá thầu có thể chứa thông tin về giá thầu chiến thắng theo bối cảnh (nếu có).
  9. Phản hồi giá thầu chứa cấu hình phiên đấu giá cho phiên đấu giá trong trình duyệt. Dữ liệu này có thể bao gồm các tín hiệu bối cảnh từ từng người mua tham gia (được gửi qua buyerdata của OpenRTB hoặc RTB Google không dùng nữa per_buyer_signals của giao thức trước đó), thông tin về người chiến thắng theo bối cảnh và chế độ cài đặt để đủ điều kiện giá thầu.
  10. Thẻ nhà xuất bản của Google gọi Protected Audience API runAdAuction() để bắt đầu phiên đấu giá theo nhóm đối tượng có cùng mối quan tâm trên thiết bị. Google chỉ đưa vào những người mua được đưa vào dưới dạng InterestGroupBuyer trong InterestGroupBidding trong quá trình định cấu hình phiên đấu giá.
  11. Google chuyển các tín hiệu không bắt buộc dành riêng cho người mua của từng bên đặt giá thầu đủ điều kiện đến cấu hình phiên đấu giá Protected Audience.
  12. Nếu nhóm mối quan tâm của một bên đặt giá thầu nhất định chỉ định trustedBiddingSignalsUrl, thì trình duyệt sẽ gửi yêu cầu đến trustedBiddingSignalsUrl của từng nhóm để tìm nạp tín hiệu theo thời gian thực cho từng nhóm. Xem chi tiết trong Protected Audience API .
  13. Trình duyệt gọi generateBid() của bên đặt giá thầu cho từng nhóm mối quan tâm đã chọn tham gia và đủ điều kiện tham gia phiên đấu giá trong trình duyệt. Chiến dịch này bước tính toán giá thầu và chọn một mẫu quảng cáo. generateBid() có quyền truy cập vào các tín hiệu không bắt buộc của người mua do bên đặt giá thầu cung cấp và các tín hiệu đặt giá thầu đáng tin cậy cho nhóm mối quan tâm nhất định.
  14. Trình duyệt gọi scoreAd() của người bán (trong trường hợp này là của Google) của Google để chỉ định thứ hạng cho mỗi giá thầu trong phiên đấu giá quảng cáo cho nhóm đối tượng có cùng mối quan tâm. Giá thầu được xếp hạng và lọc dựa trên biện pháp bảo vệ của nhà xuất bản, chính sách quảng cáo và các quy tắc ràng buộc khác.
  15. Trình duyệt chạy một phiên đấu giá với giá thầu theo nhóm mối quan tâm đủ điều kiện. Chiến lược phát hành đĩa đơn giá thầu theo ngữ cảnh được xếp hạng hàng đầu tham gia vào phiên đấu giá trong trình duyệt.
  16. Sau phiên đấu giá, nếu có một nhóm đối tượng có cùng mối quan tâm giành chiến thắng, trình duyệt sẽ gọi reportResult() của người bán và reportWin() của bên đặt giá thầu để thông báo cho từng bên về người chiến thắng phiên đấu giá trong trình duyệt.
  17. Nếu quảng cáo theo nhóm mối quan tâm giành chiến thắng, thì thẻ nhà xuất bản của Google sẽ hiển thị quảng cáo đó trong một khung hiển thị nội tuyến.

Thông tin chi tiết về quy trình phân phát

Trước khi phân phát quảng cáo

Đánh giá mẫu quảng cáo

Google phải xem xét và phê duyệt mẫu quảng cáo trước khi mẫu quảng cáo đó có thể được phân phát từ các phiên đấu giá trong trình duyệt của Protected Audience. Bạn có thể gửi mẫu quảng cáo để xem xét thông qua API Đặt giá thầu theo thời gian thực hoặc thông qua tính năng quét mẫu quảng cáo tự động. Mẫu quảng cáo cho Phiên đấu giá quảng cáo cho nhóm đối tượng có cùng mối quan tâm sử dụng Protected Audience trong trình duyệt phải bao gồm renderUrls để xem xét.

Yêu cầu đối với renderUrls:

  • renderUrl được gửi thông qua API phải khớp với renderUrl được sử dụng trong phiên đấu giá quảng cáo cho nhóm đối tượng có cùng mối quan tâm.
  • Mỗi renderUrl chỉ có thể đại diện cho một nhà quảng cáo hoặc chiến dịch quảng cáo. Không thể sử dụng renderUrl nhất định để hiển thị quảng cáo thay mặt cho nhiều nhà quảng cáo. Mỗi renderUrl phải liên kết với một mẫu quảng cáo.
  • Hệ thống xem xét mẫu quảng cáo ngoại tuyến của Google cần truy cập và tìm nạp được renderUrl trong tối đa 7 ngày sau lần đặt giá thầu gần đây nhất cho quảng cáo.
Real-time Bidding API

Bên đặt giá thầu có thể sử dụng API Đặt giá thầu theo thời gian thực để tải mẫu quảng cáo lên nhằm đặt giá thầu theo nhóm mối quan tâm.

Tự động quét mẫu quảng cáo

Bên đặt giá thầu có thể thiết lập tính năng tự động quét mẫu quảng cáo cho các mẫu quảng cáo không tải lên thông qua API Đặt giá thầu theo thời gian thực.

Nếu bạn thiết lập tính năng tự động quét mẫu quảng cáo, Google sẽ tìm các mẫu quảng cáo trong trong trình duyệt và tự động quét chúng để chúng đủ điều kiện tham gia các phiên đấu giá trong tương lai.

Dưới đây là cách bật tính năng tự động quét mẫu quảng cáo:

  • Thêm tất cả nguồn gốc renderUrl của mẫu quảng cáo theo nhóm mối quan tâm vào tài khoản Authorized Buyers.

  • Thêm các tiêu đề HTTP tuỳ chỉnh sau vào phản hồi HTTP của mẫu quảng cáo:

    Authorized-Buyers-Creative-ID

    string

    Mã mẫu quảng cáo dành riêng cho người mua. Độ dài tối đa của mã mẫu quảng cáo là 128 byte.

    Authorized-Buyers-Click-Through-URLs

    string

    Tập hợp các URL đích đã khai báo cho mẫu quảng cáo được mã hoá theo vào RFC2396.

Ví dụ:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Thời hạn của mẫu quảng cáo

Mẫu quảng cáo được phê duyệt trong 15 ngày. Nếu bạn gửi quảng cáo theo thời gian thực Đặt giá thầu API, bạn cần gửi lại mẫu quảng cáo sau 15 ngày. Nếu bạn dựa vào tự động quét mẫu quảng cáo thì quá trình quét sẽ tự động quét lại các mẫu quảng cáo đó.

Mã báo cáo của người mua

Bạn có thể phân tích các chỉ số báo cáo (chẳng hạn như số lượt hiển thị) bằng cách sử dụng các phương diện do người mua cung cấp (ví dụ: mã chiến dịch hoặc mã nhận dạng nhà quảng cáo). Để thêm một phương diện cho mức chi tiêu theo mối quan tâm, hãy chỉ định buyerAndSellerReportingId cho quảng cáo của bạn khi bạn thêm thiết bị của người dùng vào mối quan tâm. Xem thêm thông tin chi tiết trong tài liệu về Protected Audience.

Sau đây là ví dụ về cách thêm buyerAndSellerReportingId vào cấu hình nhóm mối quan tâm:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

buyer_reporting_id sẽ xuất hiện dưới dạng một phương diện mới trong Công cụ báo cáo của Bên mua được uỷ quyền, dưới dạng Phương diện mã báo cáo của bên mua.

Phiên đấu giá phía máy chủ

Thay đổi về yêu cầu giá thầu

Sau đây là các phiên bản ban đầu của các giao thức được hỗ trợ để sử dụng trong thử nghiệm:

Cho biết tính năng hỗ trợ phiên đấu giá theo nhóm đối tượng có cùng mối quan tâm

Yêu cầu giá thầu có các trường mới để cho biết khả năng hỗ trợ cho phiên đấu giá theo nhóm mối quan tâm:

  • OpenRTB:
    • BidRequest.imp.ext.ae
    • BidRequest.imp.ext.igbid
  • Giao thức RTB của Google (không dùng nữa):
    • BidRequest.adslot.supported_auction_environment
    • BidRequest.adslot.interest_group_bidding_allowed

Bạn có thể sử dụng trường này để phân biệt giữa các cơ hội hiển thị hỗ trợ phiên đấu giá nhóm quan tâm trong trình duyệt của Protected Audience và các cơ hội hiển thị chỉ hỗ trợ phiên đấu giá trao đổi phía máy chủ truyền thống. Chiến lược phát hành đĩa đơn Enum AuctionEnvironment có thể có các giá trị sau:

  • SERVER_SIDE_AUCTION (JSON OpenRTB: 0): Phiên đấu giá xác định quảng cáo chiến thắng chạy trên máy chủ của nền tảng trao đổi.
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Yêu cầu có hỗ trợ Protected Audience, trong đó phiên đấu giá theo bối cảnh chạy trên máy chủ của nền tảng trao đổi, đặt giá thầu theo nhóm đối tượng có cùng mối quan tâm và phiên đấu giá cuối cùng chạy trong trình duyệt.
  • SERVER_SIDE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 3): Ngữ cảnh phiên đấu giá chạy trên máy chủ của sàn giao dịch và logic đặt giá thầu cho lợi ích giá thầu nhóm và logic tính điểm để xác định quảng cáo giành chiến thắng cuối cùng là chạy trong máy chủ Đặt giá thầu và Phiên đấu giá.
Chỉ định kích thước vùng quảng cáo Protected Audience

Yêu cầu giá thầu bao gồm các trường sau đây để cung cấp cho bạn tính năng Bảo vệ Kích thước vùng quảng cáo đối tượng:

  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height
  • Giao thức RTB của Google (không dùng nữa):
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height

Các trường này cho biết kích thước của vùng quảng cáo cho phiên đấu giá sử dụng Protected Audience API tính bằng pixel.

Kích thước này có thể khác với kích thước trong yêu cầu theo ngữ cảnh, chẳng hạn như kích thước đã thấy trong BidRequest.imp.banner.format.w của OpenRTB và Trường BidRequest.imp.banner.format.h hoặc giao thức RTB của Google không dùng nữa Trường BidRequest.adslot.widthBidRequest.adslot.height.

Yêu cầu theo bối cảnh có thể có nhiều kích thước. Chiến thắng trong phiên đấu giá trên thiết bị quảng cáo dự kiến chỉ lấp đầy một kích thước vùng cố định.

Cho biết khả năng hiển thị quảng cáo của Protected Audience

Quảng cáo Protected Audience có thể hiển thị hoặc không hiển thị tuỳ thuộc vào giai đoạn tích hợp hiện tại (xem thử nghiệm không hiển thị). render_interest_group_ads trên yêu cầu giá thầu cho biết liệu quảng cáo Protected Audience giành chiến thắng sẽ được hiển thị.

  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
  • Giao thức RTB của Google (không dùng nữa): BidRequest.adslot.interest_group_auction.render_interest_group_ads
Giảm thiểu việc dựa vào giá trị nhận dạng người dùng

Các yêu cầu giá thầu theo bối cảnh thuộc phạm vi thử nghiệm Protected Audience API có thể tiếp tục mang theo các giá trị nhận dạng truyền thống dựa trên cookie khi có sẵn từ trình duyệt, chẳng hạn như các trường BidRequest.user.idBidRequest.user.buyerid, hoặc BidRequest.google_user_idBidRequest.hosted_match_data inch giao thức RTB Google không dùng nữa. Việc có các giá trị nhận dạng đó trong yêu cầu giá thầu phải tuân theo các chính sách quyền riêng tư hiện hành. Bạn không nên dựa vào giá trị nhận dạng dựa trên cookie cho mục đích nhắm mục tiêu và đặt giá thầu trong quá trình thử nghiệm để chuẩn bị tốt hơn cho việc mua hiệu quả khi cookie của bên thứ ba không còn hoạt động nữa.

Google cũng có thể chạy các thử nghiệm quy mô nhỏ trong đó giá trị nhận dạng dựa trên cookie sẽ bị loại bỏ khỏi các yêu cầu giá thầu trong phạm vi thử nghiệm Protected Audience API. Việc này là để đánh giá tác động tiềm năng của việc ngừng sử dụng cookie của bên thứ ba.

Để chuẩn bị cho việc Chrome ngừng sử dụng cookie của bên thứ ba (3PCD) vào năm 2024, Chrome hiện cung cấp tính năng kiểm thử do Chrome hỗ trợ.

Các trang web và nhà cung cấp có thể sử dụng phương thức kiểm thử hỗ trợ Chrome để kiểm thử hệ thống của họ theo 3PCD (máy tính để bàn). Trong thử nghiệm, trình duyệt Chrome được chỉ định cho một nhóm thử nghiệm 3PCD, Chế độ A hoặc Chế độ B. Mỗi trình duyệt được gán một nhãn nhất quán tương ứng với một nhóm thử nghiệm 3PCD cụ thể mà bạn có thể truy cập thông qua API Chrome trong trình duyệt.

Google chuyển nhãn chưa sửa đổi từ API Chrome sang giá thầu RTB yêu cầu. Do một nhãn riêng lẻ có lượng lưu lượng truy cập nhỏ, nên Google không phải lúc nào cũng đưa nhãn đó vào các ngữ cảnh có giới hạn về quyền riêng tư.

Sau đây là các trường mà bạn có thể xem nhãn:

  • OpenRTB: BidRequest.device.ext.cdep
  • Giao thức RTB của Google (không dùng nữa): BidRequest.device.cookie_deprecation_label

Thay đổi về phản hồi giá thầu

Cho biết việc tham gia phiên đấu giá theo nhóm đối tượng có cùng mối quan tâm

Bạn có trách nhiệm cho biết rõ ý định tham gia phiên đấu giá trong trình duyệt bằng cách trả về đối tượng InterestGroupBidding trong phản hồi giá thầu theo bối cảnh:

  • OpenRTB: BidResponse.ext.igbid
  • Giao thức RTB của Google (không dùng nữa): BidResponse.interest_group_bidding

Bạn phải cung cấp phản hồi giá thầu theo bối cảnh. Phản hồi không bắt buộc phải bao gồm giá thầu theo bối cảnh. Đối tượng InterestGroupBidding phải chứa origin cho mỗi InterestGroupBuyer, khớp với một trong các nguồn gốc được định cấu hình bởi bên đặt giá thầu cho tài khoản của họ. origin được thêm vào interestGroupBuyers của cấu hình phiên đấu giá khi Thẻ nhà xuất bản của Google gọi runAdAuction().

Truyền tín hiệu theo bối cảnh của người mua

Bạn có thể đưa tín hiệu của người mua vào phản hồi giá thầu theo bối cảnh. Google sẽ truyền tín hiệu này dưới dạng đối tượng JSON đến hàm đặt giá thầu trên thiết bị của họ thông qua đối số perBuyerSignals. Thông tin này có thể được đưa vào giá thầu phản hồi với sau đây tuỳ thuộc vào giao thức:

  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
  • Google RTB (không dùng nữa): BidResponse.interest_group_bidding.per_buyer_signals
Truyền tín hiệu kết xuất theo bối cảnh của người mua

Mẫu quảng cáo theo nhóm mối quan tâm có thể sử dụng các tín hiệu theo bối cảnh có giới hạn trong quá trình hiển thị bằng cách gửi các tín hiệu đó thông qua phản hồi giá thầu theo bối cảnh và nhận các tín hiệu đó trên yêu cầu URL hiển thị bằng cách sử dụng tính năng mở rộng macro. Ví dụ: hiển thị tín hiệu có thể dùng để tuỳ chỉnh giao diện của mẫu quảng cáo nhằm cải thiện hiệu suất trong ngữ cảnh của một vùng quảng cáo hoặc trang nhà xuất bản nhất định.

Bạn có thể thêm các tín hiệu hiển thị của người mua được chuyển đổi tuần tự dưới dạng chuỗi an toàn với URL trong giá thầu phản hồi theo ngữ cảnh mà Google sẽ thay thế để mang lại lợi ích thắng thầu nhóm URL hiển thị bằng cách tạo Macro ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}.

Bạn có thể chỉ định tín hiệu hiển thị trong giá thầu phản hồi bằng các cách sau , tuỳ thuộc vào giao thức:

  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
  • Google RTB (không dùng nữa): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

Có thể bao gồm tối đa 3 bộ tín hiệu hiển thị với các hậu tố macro khác nhau trong giá thầu phản hồi để phân biệt các tín hiệu. Ví dụ: hậu tố có thể được dùng để so khớp một tập hợp tín hiệu cụ thể chỉ áp dụng cho các mẫu quảng cáo với macro tương ứng trong URL hiển thị của chúng, do đó làm giảm quá trình chuyển dữ liệu kích thước.

Người mua theo nhóm mối quan tâm sẽ bị từ chối tham gia phiên đấu giá Protected Audience nếu tín hiệu không an toàn cho URL, hậu tố macro không duy nhất hoặc bạn cung cấp nhiều hơn 3 nhóm tín hiệu.

Chỉ định giá thầu tối đa trong trình duyệt

Trong Protected Audience đề xuất, thì việc tính toán giá thầu và phiên đấu giá cuối cùng dự kiến sẽ chạy trên thiết bị. Việc này có thể tạo ra các vectơ lạm dụng tiềm ẩn có thể ảnh hưởng đến tính toàn vẹn của phiên đấu giá cuối cùng kết quả, chẳng hạn như giá thầu giành chiến thắng.

Để giảm thiểu rủi ro trong quá trình Google thử nghiệm Protected Audience API cho các đối tác RTB, bạn có thể chỉ định giá trị giá thầu tối đa dự kiến trong mỗi phản hồi giá thầu theo bối cảnh. Giá thầu tối đa dự kiến là giá thầu tối đa hàm đặt giá thầu dự kiến sẽ trả về. Nếu giá thầu thắng thầu được báo cáo từ phiên đấu giá trong trình duyệt vượt quá số tiền này, thì giá thầu thắng thầu sẽ không được tính là một sự kiện có thể tính phí. Phương pháp này có thể thay đổi.

Trong giá thầu phản hồi, bạn có thể chỉ định giá trị giá thầu tối đa dự kiến trong phần các trường sau:

  • OpenRTB: BidResponse.igbid.igbuyer.maxbid(được biểu thị bằng đơn vị tiền tệ CPM)
  • Giao thức RTB của Google (không dùng nữa): BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (được biểu thị bằng microCPM)
Phân bổ lượt hiển thị cho nhiều tài khoản

Bên đặt giá thầu phải chọn một mã thanh toán để phân bổ lợi ích của họ số lần hiển thị của giá thầu nhóm bằng cách sử dụng các trường sau:

  • OpenRTB: BidResponse.igbid.igbuyer.billing_id
  • Giao thức RTB của Google (không dùng nữa): BidResponse.interest_group_bidding.interest_group_buyers.billing_id

Mã thanh toán bạn chọn phải là mã thanh toán đủ điều kiện trong yêu cầu giá thầu:

  • OpenRTB: BidRequest.imp.ext.billing_id
  • Giao thức RTB của Google (không dùng nữa): BidRequest.adslot.matching_ad_data.billing_id

Nếu bạn không cung cấp mã thanh toán để phân bổ lượt hiển thị đặt giá thầu theo nhóm mối quan tâm, thì bên đặt giá thầu sẽ không tham gia phiên đấu giá Protected Audience.

Tài khoản con có thể có tối đa 2 mã thanh toán. Người mua có thể sử dụng mã thanh toán cho mức chi tiêu theo bối cảnh và mã còn lại cho mức chi tiêu theo nhóm mối quan tâm. Hãy liên hệ với người quản lý tài khoản của bạn nếu bạn muốn định cấu hình hai mã thanh toán cho một tài khoản con.

Bạn có thể đặt ngân sách hằng ngày cho từng mã thanh toán. Hãy liên hệ với người quản lý tài khoản của bạn để đặt ngân sách hằng ngày cho mã thanh toán của tài khoản con.

Mã thanh toán cho tất cả tài khoản con có ngân sách đủ điều kiện để đặt giá thầu trên lượt hiển thị sẽ xuất hiện trên yêu cầu giá thầu để lựa chọn mô hình phân bổ chi tiêu. Hãy liên hệ với người quản lý tài khoản của bạn để sửa đổi ngân sách cho mã thanh toán của nhóm mối quan tâm.

Trong phiên đấu giá trong trình duyệt

Tạo giá thầu trong trình duyệt

Sử dụng generateBid() để tạo giá thầu trong trình duyệt.

Google cung cấp các thông số sau:

  • auctionSignals: Trống
  • perBuyerSignals: Một đối tượng JavaScript của cùng một tín hiệu do bên đặt giá thầu cung cấp trong phản hồi theo bối cảnh

Các tham số sau đây sẽ được trả về:

  • ad: Google bỏ qua trường này.
  • bid: Giá thầu dạng số tham gia phiên đấu giá. Phải ở đơn vị CPM (không phải micrô).
  • render: URL được hiển thị để hiển thị mẫu quảng cáo nếu giá thầu thắng phiên đấu giá. Google phải xem xét và phê duyệt URL này, nếu không URL sẽ bị lọc khỏi phiên đấu giá.
  • allowComponentAuction: Phải là true. Google hiện hỗ trợ thử nghiệm phiên đấu giá nhiều người bán.

Ví dụ:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

Hãy xem phần Đặt giá thầu trên thiết bị trong thông số kỹ thuật của Protected Audience để biết nội dung giải thích về hàm generateBid().

Đơn vị tiền tệ của giá thầu

Giá thầu đấu giá trong trình duyệt được đặt theo đơn vị CPM của đơn vị tiền tệ giá thầu đã chọn.

Đơn vị tiền tệ của giá thầu phải được chỉ định trong cả phản hồi giá thầu theo ngữ cảnh và trong giá trị trả về của generateBid và phải là mã alpha hợp lệ theo ISO 4217, chẳng hạn như là "USD", "EUR" hoặc "JPY".

Trong OpenRTB, hãy sử dụng trường cur mới trong đối tượng InterestGroupBuyer trong tiện ích phản hồi giá thầu của Google.

Ví dụ:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

Trong giao thức RTB của Google, hãy sử dụng trường currency mới trong thông báo InterestGroupBuyer trong phản hồi giá thầu.

Ví dụ:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

Của bên đặt giá thầu Hàm generateBid phải trả về giá thầu bằng cùng một đơn vị tiền tệ với được biểu thị trong giá thầu phản hồi theo ngữ cảnh. Điền thuộc tính bidCurrency mới vào Giá trị trả về của generateBid:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

Nếu đơn vị tiền tệ trong giá thầu phản hồi theo ngữ cảnh khác với đơn vị tiền tệ được trả về bởi generateBid hoặc nếu một trong hai trả về tiền tệ không hợp lệ, giá thầu sẽ được lọc trước phiên đấu giá.

Kiểm tra chất lượng quảng cáo

Việc thực thi chính sách mẫu quảng cáo và biện pháp kiểm soát dành cho nhà xuất bản có thể hạn chế hơn đối với giá thầu cho nhóm đối tượng có cùng mối quan tâm trên trình duyệt trong quá trình thử nghiệm Protected Audience API cho RTB các đối tác.

Hỗ trợ theo Đạo luật Dịch vụ kỹ thuật số

Theo Điều 26 của Đạo luật Dịch vụ kỹ thuật số, nhà xuất bản có thể yêu cầu người mua hiển thị thông tin công bố về tính minh bạch trong quảng cáo. Khi thông báo "Yêu cầu người mua chỉ hiển thị quảng cáo với DSA thông tin minh bạch trên trang web hoặc ứng dụng của tôi ở Khu vực kinh tế Châu Âu (EEA)" sẽ được bật bằng một nhà xuất bản, người mua theo nhóm mối quan tâm có thể xác định cơ hội nào họ sẽ tham gia bắt buộc để thể hiện tính minh bạch của người mua bằng cách chú ý đến các giá trị của BidRequest.regs.dsa.requiredBidRequest.dsa.pubrender trong giá thầu yêu cầu (BidRequest.dsa.dsa_supportBidRequest.dsa.publisher_rendering_support lần lượt trong các phiên bản không được dùng nữa giao thức RTB của Google).

Khi bên đặt giá thầu muốn tham gia vào các phiên đấu giá Protected Audience API nhận được tín hiệu trong yêu cầu giá thầu yêu cầu phải thể hiện tính minh bạch theo DSA quảng cáo được phân phối qua Protected Audience API, nhà phát triển nên đánh giá xem chúng có thể hiển thị thích hợp thông tin được yêu cầu và chỉ định bằng cách cài đặt BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render inch giao thức RTB Google không dùng nữa). Nếu không, người mua sẽ không được bao gồm trong phiên đấu giá Protected Audience API.

Để biết thêm thông tin về tính minh bạch trong quảng cáo theo Đạo luật Dịch vụ kỹ thuật số, hãy xem Bài viết trên Trung tâm trợ giúp: Hỗ trợ Đạo luật Dịch vụ kỹ thuật số.

Lọc giá thầu

Google thực thi các chế độ kiểm soát của nhà xuất bảnchính sách quảng cáo trong phiên đấu giá trên thiết bị.

Sau phiên đấu giá trong trình duyệt

Báo cáo kết quả phiên đấu giá cho người mua: reportWin()

Google không điền các đối số sau:

  • auctionSignals
  • sellerSignals

Sử dụng reportWin() để báo cáo kết quả phiên đấu giá cho người mua.

Xem Báo cáo của người mua về tính năng Hiển thị và quảng cáo Sự kiện của phần giải thích về Protected Audience API để biết thêm thông tin.

Macro

renderUrl tham chiếu đến mẫu quảng cáo Protected Audience API có thể bao gồm một hoặc nhiều phần giữ chỗ, được gọi là macro. Sau phiên đấu giá theo nhóm đối tượng có cùng mối quan tâm nhưng trước khi hiển thị, macro được thay thế bằng giá trị. renderUrl dùng trong phiên đấu giá trên thiết bị có thể bao gồm các macro sau:

${GDPR} Mở rộng thành 0 nếu không áp dụng GDPR hoặc 1 nếu áp dụng GDPR. Xem tài liệu.
${GDPR_CONSENT_XXXX} Mở rộng tới Chuỗi về tính minh bạch và sự đồng ý (TC) liên kết với yêu cầu. Nếu Tính minh bạch và Chuỗi đồng ý (TC) trống hoặc không hợp lệ, macro này không mở rộng.

Sử dụng macro này để chuyển chuỗi TC tới một nhà cung cấp đã đăng ký trong Danh sách nhà cung cấp (GVL) của IAB trong URL. Thay thế XXXX bằng mã IAB GVL của nhà cung cấp đã đăng ký trong Danh sách nhà cung cấp toàn cầu (GVL) của IAB. Nếu chuỗi TC trống hoặc không hợp lệ, thì macro này sẽ không mở rộng.

Các quảng cáo có macro ${GDPR_CONSENT_XXXX} có thể trở thành bị chặn nếu nhà cung cấp đã đăng ký IAB GVL được liên kết với mã IAB GVL bạn không có sự đồng ý của người dùng.

Macro ${GDPR_CONSENT_XXXX} chỉ được xuất hiện một lần trong renderUrl.
${ADDL_CONSENT} Mở rộng thành phần Bổ sung Chuỗi đồng ý (AC) liên kết với yêu cầu.
${AD_WIDTH}, ${AD_HEIGHT) Các macro này chèn chiều rộng và chiều cao của vùng quảng cáo.
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

Macro chứa tín hiệu người mua tại thời điểm hiển thị được chỉ định cho giá thầu phản hồi.

Thay thế phần giữ chỗ buyer.origin.example bằng nguồn gốc của người mua nhóm mối quan tâm. Nguồn gốc này phải tương ứng với interest_group_buyers.origin trong phản hồi giá thầu. Bạn có thể bao gồm _OPTIONAL_SUFFIX để cung cấp tối đa ba tên khác nhau giá trị tín hiệu kết xuất.

Cách tính lượt hiển thị

Trong quá trình thử nghiệm Protected Audience API với các đối tác RTB, Google sẽ tính số lượt hiển thị khi trình duyệt gọi hàm reportResult() và sau đó tìm nạp URL báo cáo của Google trong lệnh gọi đến sendReportTo().

Vì sự kiện được Google sử dụng để tính số lượt hiển thị trong Protected Audience phiên đấu giá trong trình duyệt có thể khác với sự kiện được dùng để tính lượt hiển thị của đối tác người mua RTB, thì số lượt hiển thị có thể khác nhau.

Một trong những mục tiêu của Google khi thử nghiệm Protected Audience API là xác định và giảm thiểu những khác biệt này.

Phân bổ các lượt hiển thị có thể lập hoá đơn

Tất cả mức chi tiêu của bên đặt giá thầu từ các phiên đấu giá trong trình duyệt của Protected Audience đều được phân bổ cho một tài khoản bên đặt giá thầu dựa trên mối liên kết từ nguồn gốc của chủ sở hữu nhóm mối quan tâm được định cấu hình cho bên đặt giá thầu. Phân bổ chi tiêu cho các mức giá khác nhau tài khoản giấy phép con của bên đặt giá thầu không được hỗ trợ.

Hạn mức ngân sách hằng ngày

Trong quá trình thử nghiệm Protected Audience API, mỗi tài khoản sẽ có một cấp tài khoản Giới hạn ngân sách hằng ngày của mức chi tiêu Protected Audience. Giới hạn ngân sách hằng ngày giúp giới hạn rủi ro trong môi trường đấu giá trên trình duyệt. Khi đạt đến giới hạn ngân sách hàng ngày, tài khoản không còn nhận được yêu cầu giá thầu đủ điều kiện sử dụng Protected Audience.

Tài khoản đó có thể tiếp tục tham gia vào phiên đấu giá theo bối cảnh phía máy chủ sau đạt đến giới hạn của Protected Audience. Ví dụ: tài khoản bên đặt giá thầu đạt đến giới hạn của Protected Audience có thể nhận được một yêu cầu giá thầu bằng auction_environment = SERVER_SIDE_AUCTION (OpenRTB JSON: 0), ngay cả khi yêu cầu giá thầu đó đủ điều kiện cho một phiên đấu giá sử dụng Protected Audience API.

Phản hồi theo thời gian thực và giá thầu tối thiểu để thắng

Bên đặt giá thầu chọn nhận phản hồi theo thời gian thực sẽ nhận được ý kiến phản hồi đối với những người mua theo nhóm mối quan tâm được yêu cầu đưa vào phiên đấu giá sử dụng Protected Audience API trên thiết bị. Mỗi người mua thuộc nhóm mối quan tâm mà bên đặt giá thầu chỉ định về một giá thầu phản hồi sẽ nhận được một đối tượng phản hồi, bất kể nhiều người đặt giá thầu cho người mua theo nhóm mối quan tâm trong phiên đấu giá sử dụng Protected Audience API. Chiến lược phát hành đĩa đơn thông tin sau sẽ có sẵn trên phản hồi của người mua nhóm mối quan tâm đối tượng:

  • Loại phản hồi của đối tượng phản hồi sẽ là INTEREST_GROUP_BUYER_FEEDBACK.
  • Nguồn gốc của người mua trong nhóm đối tượng có cùng mối quan tâm.
  • Giá thầu tối thiểu để giành chiến thắng cho người mua theo nhóm mối quan tâm để giành được phiên đấu giá chung.
  • Giá thầu tối thiểu để chiến thắng của người mua nhóm đối tượng có cùng mối quan tâm nhằm đánh bại giá thầu có thứ hạng cao nhất từ thành phần phía máy chủ của phiên đấu giá tổng thể.
  • Mã trạng thái của người mua nhóm mối quan tâm. Các mã trạng thái có thể có được xác định trong tệp interest-group-buyer-status-codes.txt.

Hãy tham khảo tài liệu về giao thức cho RTB trong Authorized BuyersPhần mở rộng OpenRTB cho các tên trường cụ thể.

Thông báo phản hồi giá thầu

Chrome cung cấp tính năng gỡ lỗi tạm thời API đối với Protected Audience API. API này cho phép Ad Manager gửi theo thời gian thực thông báo gỡ lỗi từ máy chủ đến máy chủ chứa phản hồi về chế độ Bảo vệ Giá thầu đối tượng. Thông báo này sẽ bao gồm các lý do tại sao giá thầu có thể đã được lọc trong phiên đấu giá trong Protected Audience trong trình duyệt cùng với về giá thầu được mô tả bên dưới.

Bên đặt giá thầu có thể liên hệ với người quản lý tài khoản của họ để định cấu hình một URL tĩnh sẽ được dùng để phân phối thông báo phản hồi về giá thầu gỡ lỗi Protected Audience. Chiến dịch này URL tĩnh sẽ được tìm nạp từ máy chủ của Google với các macro đã chọn được thay thế sau khi phiên đấu giá sử dụng Protected Audience API hoàn tất. Các macro sau đây được hỗ trợ:

  • %%GOOGLE_QUERY_ID%%: Macro này được thay thế bằng mã truy vấn của Google được gửi trong yêu cầu giá thầu theo bối cảnh có bật Protected Audience. Ngang bằng giao thức OpenRTB, trong đó BidRequest.ext.google_query_id, trong khi Google RTB không còn được dùng nữa giao thức này sử dụng BidRequest.google_query_id.
  • %%INTEREST_GROUP_OWNER%%: Nguồn gốc của chủ sở hữu nhóm mối quan tâm.
  • %%BID_CPM%%: Giá thầu theo CPM do người mua chỉ định trong hàm generateBid().
  • %%RENDER_URL%%: URL hiển thị của mẫu quảng cáo.
  • %%STATUS%%: Mã trạng thái nếu giá thầu bị từ chối trong vòng scoreAd(). Giá trị là mã trạng thái mẫu quảng cáo.

Sau đây là URL tĩnh mẫu mà bên đặt giá thầu có thể cung cấp cho người quản lý tài khoản:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

Thông báo phản hồi giá thầu là một tính năng tạm thời phụ thuộc vào API ForDebuggingOnly tạm thời.

TURTLEDOVE cấp sản phẩm

Quảng cáo bao gồm nhiều phần hoặc Cấp sản phẩm TURTLEDOVE (PLTD) được hỗ trợ cho các đối tác RTB của Google trong Protected Audience API kiểm thử. Hãy thông báo cho người quản lý tài khoản của bạn trong quá trình tích hợp nếu bạn định thử nghiệm PLTD, vì bắt buộc phải có tài nguyên và cấu hình bổ sung.

Giới thiệu

Sau đây là cách bạn có thể kiểm thử Protected Audience API:

Các bước

  1. Điền vào biểu mẫu yêu cầu để tham gia thử nghiệm Protected Audience API.
  2. Sau khi bạn gửi biểu mẫu yêu cầu, hãy liên hệ với người quản lý tài khoản hoặc tệp của bạn phiếu yêu cầu hỗ trợ thông qua trang Trợ giúp Authorized Buyers .
  3. Sau khi thiết lập tài khoản, cả Google và đối tác đều có thể xác minh quá trình tích hợp thông qua các bước trong Giai đoạn kiểm thử.

Đánh giá mẫu quảng cáo

Để đặt giá thầu bằng quảng cáo cấp sản phẩm (quảng cáo bao gồm nhiều phần) trong phiên đấu giá Protected Audience API, hãy tuân thủ các yêu cầu sau:

  • Đưa tham số truy vấn &pltd=True vào renderUrl cho thuộc tính vùng chứa của quảng cáo thành phần (còn được gọi là renderUrl cấp cao nhất) để phân biệt renderUrls cấp cao nhất trong quá trình đánh giá mẫu quảng cáo.
  • Hiển thị mẫu quảng cáo đại diện khi vùng chứa của quảng cáo thành phần là được tìm nạp để Google xem xét mẫu quảng cáo. Để biết khi nào một Hiển thị quảng cáo đại diện sẽ được trả về, bạn có thể tham khảo Tham số truy vấn validation=True do hệ thống đánh giá mẫu quảng cáo của Google đặt.

Danh sách kiểm tra tích hợp

  • Thiết lập một điểm cuối yêu cầu giá thầu sẽ điền sẵn dữ liệu cho Protected Audience API các trường liên quan trên giá thầu phản hồi theo ngữ cảnh (ví dụ: interest_group_bidding.
  • Triển khai việc gắn thẻ trên các trang của nhà quảng cáo để kết nối trình duyệt của người dùng với nhóm mối quan tâm.
  • Triển khai generateBid()reportWin().
  • Chọn nguồn gốc của chủ sở hữu nhóm mối quan tâm rồi thêm các nguồn gốc đó vào tài khoản Authorized Buyers.
  • Thiết lập tính năng nhắm mục tiêu trước cho khoảng không quảng cáo liên quan đến Protected Audience API kiểm thử.
  • Gửi mẫu quảng cáo để xem xét và phê duyệt thông qua phần Mẫu quảng cáo .
  • (Không bắt buộc) Thiết lập điểm cuối của tín hiệu đặt giá thầu đáng tin cậy.
  • (Không bắt buộc) Thiết lập trang nhà quảng cáo thử nghiệm cho phép các kỹ sư của Google thêm trình duyệt của họ vào các nhóm mối quan tâm thuộc quyền sở hữu của nguồn gốc của người mua nhóm mối quan tâm. Điều này cho phép chúng tôi kích hoạt phiên đấu giá Protected Audience theo cách thủ công.
  • (Không bắt buộc) Bật tính năng phản hồi theo thời gian thực trên tài khoản của bạn để nhận phản hồi cho những người mua nhóm mối quan tâm được yêu cầu đưa vào phiên đấu giá Protected Audience.
  • (Không bắt buộc) Liên hệ với người quản lý tài khoản của bạn để thiết lập một URL tĩnh cho nhận được thông báo từ máy chủ đến máy chủ cung cấp giá thầu Protected Audience ý kiến phản hồi về trạng thái của giá thầu qua Protected Audience trên thiết bị phiên đấu giá để giúp gỡ lỗi các vấn đề không mong muốn. Hãy xem thông báo phản hồi về giá thầu để biết thông tin chi tiết.

Giai đoạn kiểm thử

Giai đoạn 1: Kiểm thử thủ công

Dưới đây là cách kích hoạt phiên đấu giá sử dụng Protected Audience API theo cách thủ công, đảm bảo quảng cáo có thể được hiển thị và ghi lại lần hiển thị:

  1. Sử dụng Chrome 101 trở lên.
  2. Bật API Hộp cát về quyền riêng tư và Khung bảo vệ bằng chrome://flags/#privacy-sandbox-ads-apischrome://flags/#enable-fenced-frames. Xem thêm tại phần Kiểm tra quyền riêng tư hộp cát.
  3. Gửi mẫu quảng cáo để phê duyệt bằng cách sử dụng tính năng Đặt giá thầu theo thời gian thực .
  4. Sử dụng trang nhà quảng cáo do bên đặt giá thầu cung cấp để thêm trình duyệt vào nhóm mối quan tâm thuộc sở hữu của bên đặt giá thầu.
  5. Sử dụng trang nhà xuất bản thử nghiệm do Google cung cấp sau đây để kích hoạt phiên đấu giá Protected Audience:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    Nhóm mối quan tâm trong trình duyệt phải đặt giá thầu đủ cao để giành chiến thắng trong phiên đấu giá, vì nhóm này có thể cạnh tranh với các giá thầu thông thường ở phía máy chủ. Google cũng cung cấp trang dành riêng cho nhà xuất bản thử nghiệm cho từng đối tác, trong đó chỉ đối tác đó có thể tham gia phiên đấu giá. Có thể dễ dàng giành chiến thắng một cách đáng tin cậy phiên đấu giá trong trình duyệt trên một trang cụ thể của đối tác.

  6. Xác minh những điều sau:

    1. Quảng cáo chiến thắng dự kiến sẽ hiển thị.
    2. Kết quả phiên đấu giá được gửi phía máy chủ, nghĩa là bên đặt giá thầu thắng thầu sẽ nhận được một ping từ reportWin().
    3. Bảng điều khiển trang của nhà xuất bản thử nghiệm ghi lại thông báo gỡ lỗi cho mỗi giá thầu với các thông tin sau:
      • renderUrl: URL hiển thị của giá thầu.
      • interestGroupOwner: Chủ sở hữu nhóm đối tượng có cùng mối quan tâm của giá thầu.
      • accepted: Trường này là true nếu giá thầu được chấp nhận và false nếu giá thầu bị scoreAd() từ chối.
      • externalBidStatus: Mã trạng thái nếu giá thầu bị từ chối trong vòng scoreAd(). Giá trị là trạng thái mẫu quảng cáo mã.

Giai đoạn 2: (Không bắt buộc) Thử nghiệm không kết xuất

Sau khi Google và đối tác đã xác minh theo cách thủ công rằng đối tác có thể tham gia phiên đấu giá sử dụng Protected Audience API, Google sẽ cho phép đối tác giai đoạn tiếp theo của thử nghiệm.

Google phân bổ một lượng nhỏ lưu lượng truy cập trực tiếp để chạy phiên đấu giá Protected Audience. Sau đó, Google và đối tác không cần kích hoạt phiên đấu giá Protected Audience theo cách thủ công nữa. Kết quả của phiên đấu giá sử dụng Protected Audience API không kết xuất. Việc này giúp chúng tôi thử nghiệm việc tích hợp trên quy mô lớn.

Hãy liên hệ với người quản lý tài khoản của bạn hoặc gửi phiếu yêu cầu hỗ trợ thông qua Trung tâm trợ giúp dành cho người mua được uỷ quyền khi bạn đã sẵn sàng. Google sẽ kích hoạt tài khoản trong giai đoạn này.

Giai đoạn 3: Thử nghiệm kết xuất

Sau khi Google và đối tác xác minh các phiên đấu giá Protected Audience trên quy mô lớn mà không hiển thị, Google có thể cho phép đối tác hiển thị quảng cáo chiến thắng Protected Audience. Google có một lượng nhỏ lưu lượng truy cập mà các phiên đấu giá Protected Audience đủ điều kiện để chạy và quảng cáo nhóm đối tượng có cùng mối quan tâm chiến thắng được hiển thị. Bên đặt giá thầu tham gia giá thầu trong trình duyệt cạnh tranh với giá thầu.

Liên hệ với người quản lý tài khoản của bạn hoặc gửi phiếu yêu cầu hỗ trợ thông qua Authorized Buyers khi bạn đã sẵn sàng. Google sẽ kích hoạt tài khoản trong giai đoạn này.

Các tính năng bổ sung

Các tính năng sau đây là phần mở rộng của giao thức cốt lõi.

Song song hoá

Tính năng song song là một tính năng tối ưu hoá giúp giảm độ trễ của phiên đấu giá toàn diện bằng cách khởi tạo yêu cầu quảng cáo theo bối cảnh song song với các yêu cầu đến máy chủ đáng tin cậy của người mua được chỉ định trong trustedBiddingSignalsUrl.

Tính năng song song giúp giảm độ trễ nhưng ảnh hưởng đến điều kiện của người mua thuộc nhóm mối quan tâm và khả năng hỗ trợ cho các thử nghiệm phối hợp. Tính năng song song áp dụng cho tất cả bên đặt giá thầu tham gia phiên đấu giá nhóm mối quan tâm trên thiết bị. Bên đặt giá thầu không cần làm gì để tham gia các phiên đấu giá song song nhưng nên tự làm quen với việc tải song song có thể ảnh hưởng như thế nào đến khả năng đáp ứng điều kiện trong các phiên đấu giá trên thiết bị. Mã nhóm thử nghiệm cho các thử nghiệm được điều phối chưa được hỗ trợ trong phiên đấu giá song song.

Tóm tắt quy trình phân phát

Dưới đây là thông tin tóm tắt về quy trình phiên đấu giá song song: Sơ đồ quy trình

Điều kiện tham gia đối với người mua theo nhóm đối tượng có cùng mối quan tâm trên thiết bị

Đối với các phiên đấu giá song song, lệnh gọi của navigator.runAdAuction sẽ diễn ra trước phản hồi quảng cáo theo ngữ cảnh được trả về. Để bắt đầu sự tin cậy của người mua lệnh gọi máy chủ, navigator.runAdAuction yêu cầu rằng Tham số interestGroupBuyers phải là được chuyển dưới dạng giá trị, trong khi các thông số đấu giá còn lại chấp nhận JavaScript Hứa hẹn có thể được giải quyết sau khi phản hồi quảng cáo theo ngữ cảnh. Từ interestGroupBuyers được truyền trước phản hồi quảng cáo theo ngữ cảnh, lượt phản hồi quảng cáo theo bối cảnh (bao gồm cả giá thầu phản hồi) không thể sử dụng để chọn người mua nào tham gia vào phiên đấu giá song song cho yêu cầu đã cho. Thay vào đó, bộ nhớ đệm thẻ nhà xuất bản của Google trong trình duyệt của người dùng, tham số interestGroupBuyers từ các lần thực thi navigator.runAdAuction trước đó trên cùng một miền.

Quá trình tải song song có một số điểm quan trọng cần cân nhắc:

  1. Bạn có thể tiếp tục chỉ định các tín hiệu đấu giá không cần thiết cho các yêu cầu máy chủ đáng tin cậy của người mua, chẳng hạn như perBuyerSignals, trong phản hồi giá thầu RTB giống như đối với các phiên đấu giá không song song. Sau khi các Lời hứa cho các tín hiệu này được giải quyết, các bước còn lại của phiên đấu giá trên thiết bị sẽ hoàn tất theo cách tương tự như quy trình đấu giá không song song.

  2. Vì việc song song hoá phụ thuộc vào việc lưu vào bộ nhớ đệm danh sách người mua nhóm mối quan tâm, Google không phải lúc nào cũng chạy một phiên đấu giá song song, do bộ nhớ đệm của quá trình song song hoá có thể trống hoặc đã hết hạn. Nếu bộ nhớ đệm trống hoặc đã hết hạn, Google sẽ chạy một phiên đấu giá Protected Audience API không song song tiêu chuẩn và sử dụng ý định của người mua để tham gia phiên đấu giá không song song nhằm tạo bộ nhớ đệm người mua theo nhóm mối quan tâm.

  3. Nếu có ít nhất một người mua cho bất kỳ bên đặt giá thầu nào được lưu vào bộ nhớ đệm đối với nhà xuất bản hiện tại thì Google sẽ chạy song song phiên đấu giá sẽ được chỉ định trong yêu cầu giá thầu:

    • Giao thức RTB của Google: BidRequest.adslot.interest_group_auction.parallelized
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized
  4. Mỗi nguồn gốc của người mua thuộc nhóm đối tượng có cùng mối quan tâm đã đăng ký cho một bên đặt giá thầu nhất định mà tham gia vào phiên đấu giá song song sẽ có chỉ số Mục nhập ParallelAuctionBuyer:

    • Giao thức RTB của Google: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer
  5. Nếu phiên đấu giá song song được chạy nhưng không có nguồn gốc của người mua cụ thể ở bộ nhớ đệm thì người mua cụ thể đó không thể được thêm vào thiết bị hiện tại phiên đấu giá. Điều này được thể hiện bằng một yêu cầu có parallelized=True thiếu Mục nhập ParallelAuctionBuyer cho một nguồn gốc người mua của nhóm mối quan tâm nhất định. Tuy nhiên, những bên đặt giá thầu cho biết mối quan tâm bằng cách đưa (các) InterestGroupBuyer hợp lệ và đủ điều kiện vào phản hồi giá thầu sẽ có các nguồn gốc của bên mua nhóm mối quan tâm tương ứng được thêm vào bộ nhớ đệm và các nguồn gốc đó sẽ đủ điều kiện cho các yêu cầu song song trong tương lai từ cùng một trình duyệt và miền. Có ý định tham gia phiên đấu giá theo nhóm mối quan tâm có thể được biểu thị trong các trường sau:

    • Giao thức RTB của Google: BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • OpenRTB: BidResponse.ext.igbid.igbuyer
  6. Nguồn gốc của người mua được lưu vào bộ nhớ đệm (có trong thông số interestGroupBuyers của phiên đấu giá song song) mà bên đặt giá thầu không cho biết ý định tham gia phản hồi giá thầu có thể nhận được lệnh gọi máy chủ đáng tin cậy của người mua nhưng sẽ không tham gia phiên đấu giá song song.