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

Trong khuôn khổ 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 đượ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 hoạt động theo dõi trên nhiều trang web.

Chrome đang chạy 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 mục tiêu sau bằng cách kiểm thử Protected Audience API:

• Lặp lại và tìm hiểu về hiệu quả của quy trình Protected Audience API.
• Tạo ý kiến phản hồi về những điểm cải tiến API tiềm năng trong 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.

Authorized Buyers muốn thử nghiệm nên xem phần Giới thiệu để biết thông tin chi tiết.

Thử nghiệm beta: Hành vi được mô tả ở đây có thể thay đổi trong tương lai khi chúng tôi tìm hiểu kết quả từ thử nghiệm và thu thập ý kiến phản hồi của nhà xuất bản cũng như Authorized Buyers.

Lưu ý: Chỉ Authorized Buyers mới có thể sử dụng thử nghiệm Protected Audience API. Chúng tôi chưa hỗ trợ sàn giao dịch và bên đặt giá thầu mạng tham gia Đặt giá thầu mở.

Lưu ý: Khi Protected Audience API (trước đây gọi là FLEDGE) được cung cấp rộng rãi trong Chrome, Ad Manager sẽ bắt đầu tăng dần mức lưu lượng truy cập đưa vào thử nghiệm. Chúng tôi sẽ theo dõi tác động đối với doanh thu của nhà xuất bản khi tăng dần tỷ lệ phần trăm lưu lượng truy cập và sẽ không tăng thêm nếu có tác động tiêu cực đáng chú ý. Chúng tôi dự kiến đến cuối năm 2023, sẽ có tối đa 10% lưu lượng truy cập Chrome được đưa vào kiểm thử Protected Audience API.

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 trong Protected Audience cho các đối tác Authorized Buyers:

1. Bên đặt giá thầu sẽ phối hợp với các nhà quảng cáo để duy trì nhóm mối quan tâm cho từng nhà quảng cáo. Thông thường, nhà quảng cáo sẽ thêm thẻ của người đặt giá thầu vào trang của họ để thêm trình duyệt vào nhóm mối quan tâm.
2. Người dùng cuối truy cập trang của nhà quảng cáo. Trang này có thể chứa thẻ của bên đặt giá thầu.
3. Thẻ của bên đặt giá thầu sẽ 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 của nhà xuất bản của Google tạo một 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ề BidResponse với trường interest_group_bidding. Nếu bên đặt giá thầu không chỉ định interest_group_bidding, thì 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á. Phản hồi giá thầu cũng có thể chứa interest_group_bidding.per_buyer_signals. per_buyer_signals sẽ được chuyển đến chức năng đặt giá thầu của bên đặt giá thầu trong phiên đấu giá trong trình duyệt. Hãy xem phần Thay đổi giá thầu phản hồi để biết thêm thông tin.
8. Google chạy phiên đấu giá phía máy chủ và trả về phản hồi giá thầu cho trình duyệt. Phiên đấu giá phía máy chủ xem xét các 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 giành chiến thắng theo ngữ 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 tín hiệu bối cảnh từ từng người mua tham gia (được gửi qua interest_group_bidding.per_buyer_signals), thông tin 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 mối quan tâm trên thiết bị. Google chỉ bao gồm những người mua trước đây đã trả về interest_group_bidding dưới dạng interestGroupBuyers trong cấu hình phiên đấu giá.
11. Google chuyển per_buyer_signals của từng bên đặt giá thầu đủ điều kiện sang 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 cụ thể đã chỉ định trustedBiddingSignalsUrl, thì trình duyệt sẽ yêu cầu 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 thông tin chi tiết trong thông số kỹ thuật của Protected Audience API.
13. Trình duyệt sẽ 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. Bước này sẽ 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 per_buyer_signals 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) để chỉ định thứ hạng cho từng giá thầu trong phiên đấu giá quảng cáo theo nhóm mối quan tâm. Giá thầu được xếp hạng và lọc dựa trên các biện pháp bảo vệ 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 phiên đấu giá với giá thầu theo nhóm mối quan tâm đủ điều kiện. Giá thầu theo bối cảnh được xếp hạng cao nhất sẽ tham gia vào phiên đấu giá trong trình duyệt.
16. Sau phiên đấu giá, nếu có một người chiến thắng theo nhóm mối quan tâm, 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 mỗi bên về người chiến thắng trong phiên đấu giá trong trình duyệt.
17. Nếu một 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 iframe.

Thông tin 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

Mẫu quảng cáo phải được Google xem xét và phê duyệt trước khi có thể 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 để được 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 theo nhóm mối quan tâm trong trình duyệt Protected Audience phải bao gồm renderUrls để được 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 dùng trong phiên đấu giá quảng cáo theo nhóm 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. Bạn 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 phải truy cập và tìm nạp được renderUrl trong tối đa 7 ngày kể từ lần gần nhất quảng cáo được đặt giá thầu.

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 để đặ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 quét mẫu quảng cáo tự động cho mẫu quảng cáo không được 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 quét mẫu quảng cáo tự động, thì Google sẽ tìm mẫu quảng cáo trong phiên đấu giá trong trình duyệt và tự động quét các mẫu quảng cáo đó để đủ điều kiện cho các phiên đấu giá sau này.

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 đây 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 URL đích đã khai báo cho mẫu quảng cáo được mã hoá theo 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 gửi mẫu quảng cáo bằng API Đặt giá thầu theo thời gian thực, bạn cần gửi lại mẫu quảng cáo sau 15 ngày. Nếu bạn sử dụng tính năng quét mẫu quảng cáo tự động, 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 nhóm mối quan tâm, hãy chỉ định buyerAndSellerReportingId cho quảng cáo khi bạn thêm thiết bị của người dùng vào nhóm 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 phương diện mới trong Công cụ báo cáo của Người mua được uỷ quyền, dưới dạng phương diện Mã báo cáo của người mua.

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

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

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

• Đường liên kết sớm giao thức RTB của Google
• đường liên kết sớm OpenRTB

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

Yêu cầu giá thầu có một trường mới là auction_environment.

• Giao thức RTB của Google: BidRequest.adslot.auction_environment
• OpenRTB: BidRequest.imp.ext.auction_environment

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á theo nhóm mối quan tâm trong trình duyệt của Protected Audience với những cơ hội chỉ hỗ trợ phiên đấu giá trao đổi phía máy chủ truyền thống. Enum auction_environment có thể có các giá trị sau:

• SERVER_SIDE_AUCTION (OpenRTB JSON: 0): Phiên đấu giá truyền thống phía máy chủ
• ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Các yêu cầu có hỗ trợ Protected Audience, trong đó phiên đấu giá theo ngữ cảnh sẽ chạy trên máy chủ của sàn giao dịch, cũng như hoạt động đặt giá thầu theo nhóm mối quan tâm và phiên đấu giá cuối cùng sẽ chạy trong trình duyệt

Cho biết kích thước vùng quảng cáo của Protected Audience

Yêu cầu giá thầu bao gồm các trường sau đây để cung cấp cho bạn kích thước vùng quảng cáo Protected Audience:

• Giao thức RTB của Google:
  • BidRequest.adslot.interest_group_auction.width
  • BidRequest.adslot.interest_group_auction.height
• OpenRTB:
  • BidRequest.imp.ext.interest_group_auction.width
  • BidRequest.imp.ext.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á trong Protected Audience tính bằng pixel.

Kích thước này có thể khác với kích thước của yêu cầu theo bối cảnh (Adslot.width và Adslot.height hoặc trong OpenRTB: BidRequest.imp.banner.format).

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

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ị). Trường 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 có hiển thị hay không.

• Giao thức RTB của Google: BidRequest.adslot.interest_group_auction.render_interest_group_ads
• OpenRTB: BidRequest.imp.ext.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 trong phạm vi thử nghiệm Protected Audience API có thể tiếp tục mang giá trị nhận dạng dựa trên cookie truyền thống nếu có từ trình duyệt, chẳng hạn như các trường google_user_id (BidRequest.user.id trong OpenRTB) và hosted_match_data (BidRequest.user.buyerid trong OpenRTB). Việc sử dụng giá trị nhận dạng đó trong yêu cầu giá thầu vẫn phải tuân thủ mọi chính sách quyền riêng tư hiện có. 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 kiểm thử để chuẩn bị tốt hơn cho việc mua một cách hiệu quả khi cookie của bên thứ ba không còn 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 của việc ngừng sử dụng cookie của bên thứ ba.

Kiểm thử việc ngừng sử dụng cookie của bên thứ ba do Chrome hỗ trợ

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

Các trang web và nhà cung cấp có thể sử dụng quy trình kiểm thử trên nền tảng Chrome để kiểm thử hệ thống của họ bằng công nghệ 3PCD. 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 đối với yêu cầu giá thầu RTB. Do các phần nhỏ về lưu lượng truy cập của một nhãn riêng lẻ, không phải lúc nào Google cũng đưa nhãn đó vào các ngữ cảnh giới hạn về quyền riêng tư.

Bạn có thể xem nhãn tại các trường sau đây:

• Giao thức RTB của Google: BidRequest.device.cookie_deprecation_label
• OpenRTB: BidRequest.device.ext.cdep

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

Cho biết việc tham gia phiên đấu giá theo nhóm 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 ngữ cảnh:

• Giao thức RTB của Google: BidResponse.interest_group_bidding
• OpenRTB: BidResponse.ext.igbid

Bạn phải cung cấp giá thầu phản hồi theo ngữ cảnh. Phản hồi không bắt buộc phải bao gồm giá thầu theo ngữ cảnh. Đối tượng InterestGroupBidding phải chứa origin của chủ sở hữu nhóm mối quan tâm. Đối tượng này phải khớp với một trong các nguồn gốc mà bên đặt giá thầu định cấu hình 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 các tín hiệu theo bối cảnh của người mua (per BuyerSignals)

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

• RTB của Google: BidResponse.interest_group_bidding.per_buyer_signals
• OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata

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

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

Để giảm thiểu hỗ trợ trong quá trình thử nghiệm Protected Audience API của Google cho các đối tác RTB của mình, 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 ngữ cảnh. Giá thầu tối đa dự kiến là giá thầu tối đa mà hàm đặt giá thầu của bạn dự kiến sẽ trả về. Nếu giá thầu chiến thắng đượ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 giành chiến thắng không được tính là 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 các trường sau:

• Giao thức RTB của Google: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (được thể hiện bằng microCPM)
• OpenRTB: BidResponse.igbid.igbuyer.maxbid(được biểu thị bằng đơn vị tiền tệ CPM)

Phân bổ số lượt hiển thị cho nhiều tài khoản

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

• Giao thức RTB của Google: BidResponse.interest_group_bidding.interest_group_buyers.billing_id
• OpenRTB: BidResponse.igbid.igbuyer.billing_id

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

• Giao thức RTB của Google: BidRequest.adslot.matching_ad_data.billing_id
• OpenRTB: BidRequest.imp.ext.billing_id

Nếu không cung cấp mã thanh toán để phân bổ số 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 vào phiên đấu giá trong 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ột mã thanh toán để chi tiêu theo bối cảnh và một mã còn lại để 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 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 mỗi 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 của tất cả tài khoản con có ngân sách đủ điều kiện để đặt giá thầu cho lượt hiển thị sẽ xuất hiện trong yêu cầu giá thầu để 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 để sửa đổi ngân sách cho mã thanh toán cho 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 tham số sau:

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

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

• ad: Google sẽ bỏ qua trường này.
• bid: Giá thầu bằng số tham gia phiên đấu giá. Phải bằng đơn vị CPM (không phải micro).
• 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: Giá trị phải là true. Google hiện hỗ trợ việc 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};
}

Vui lòng xem phần Đặt giá thầu trên thiết bị trong phần 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 trong phiên đấ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 biểu thị trong cả phản hồi giá thầu theo ngữ cảnh và trong giá trị trả về của generateBid, đồng thời phải là mã alpha hợp lệ theo ISO 4217, chẳng hạn như "USD", "EUR" hoặc "JPY".

Trong OpenRTB, hãy sử dụng trường cur mới trong đối tượng InterestGroupBuyer trong phần mở rộng về giá thầu phản hồi 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"
  }
}

Hàm generateBid của bên đặt giá thầu phải trả về giá thầu có cùng đơn vị tiền tệ như được chỉ ra trong phản hồi giá thầu 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ệ do generateBid trả về hoặc nếu một trong hai đơn vị tiền tệ đó trả về đơn vị tiền tệ không hợp lệ, thì 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à chế độ 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 theo nhóm mối quan tâm trong trình duyệt trong quá trình thử nghiệm Protected Audience API cho các đối tác RTB.

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 nhà xuất bản bật chế độ kiểm soát "Yêu cầu người mua chỉ hiển thị quảng cáo có thông tin về tính minh bạch của Quảng cáo tìm kiếm động (DSA) trên trang web hoặc ứng dụng của tôi ở Khu vực kinh tế Châu Âu (EEA), người mua theo nhóm mối quan tâm có thể xác định cơ hội cần thiết để hiển thị tính minh bạch của người mua bằng cách lưu ý các trường sau trên các yêu cầu giá thầu nhận được: BidRequest.dsa.dsa_support và BidRequest.dsa.publisher_rendering_support đối với giao thức Authorized Buyers của Google, BidRequest.regs.dsa.required và BidRequest.dsa.pubrender đối với giao thức OpenRTB.

Khi bên đặt giá thầu muốn tham gia phiên đấu giá Protected Audience API nhận được tín hiệu trong yêu cầu giá thầu cho biết tính minh bạch của DSA phải được hiển thị cho quảng cáo được phân phối qua Protected Audience API, họ nên đánh giá xem mình có thể hiển thị thông tin bắt buộc một cách phù hợp và chỉ định bằng cách đặt BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render cho giao thức Authorized Buyers của Google hay BidResponse.ext.igbid.igbuyer.dsaadrender cho giao thức OpenRTB. Nếu không, người mua sẽ không được đưa vào phiên đấu giá Protected Audience API.

Để biết thêm thông tin về Tính minh bạch của 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: Ủng hộ Đạo luật Dịch vụ kỹ thuật số.

Lọc giá thầu

Google thực thi quyền kiểm soát của nhà xuất bản và chí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.

Hãy xem mục Báo cáo của người mua về sự kiện hiển thị và sự kiện quảng cáo trong phần giải thích về Protected Audience API để biết thêm thông tin.

Macro

Lưu ý: Macro dành cho mục đích thử nghiệm Protected Audience API và có thể không được hỗ trợ trong tương lai.

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 khi phiên đấu giá theo nhóm mối quan tâm kết thúc, nhưng trước khi hiển thị, macro sẽ được thay thế bằng các giá trị tương ứng. renderUrl được dùng trong phiên đấu giá trên thiết bị có thể bao gồm các macro sau:

${GDPR}	Giá trị này sẽ 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 chuỗi về tính minh bạch và sự đồng ý (TC) trống hoặc không hợp lệ, thì macro này sẽ không mở rộng. Sử dụng macro này để chuyển chuỗi TC đến nhà cung cấp đã đăng ký GVL của IAB trong URL. Thay thế XXXX bằng mã IAB GVL của nhà cung cấp đã đăng ký IAB GVL. Nếu chuỗi TC trống hoặc không hợp lệ, thì macro này sẽ không mở rộng. Mẫu quảng cáo có macro ${GDPR_CONSENT_XXXX} có thể bị chặn nếu nhà cung cấp đã đăng ký GVL của IAB liên kết với mã GVL của IAB mà bạn đã chèn không có sự đồng ý của người dùng. Macro ${GDPR_CONSENT_XXXX} chỉ nên xuất hiện một lần trong renderUrl.
${ADDL_CONSENT}	Mở rộng tới Chuỗi sự đồng ý bổ sung (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.

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 một lệnh gọi đến sendReportTo().

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

Một trong những mục tiêu của Google khi kiểm thử 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

Toàn bộ số tiền chi tiêu của bên đặt giá thầu từ phiên đấu giá trong trình duyệt Protected Audience được phân bổ cho một tài khoản bên đặt giá thầu duy nhất 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 đã định cấu hình cho bên đặt giá thầu. Việc phân bổ mức chi tiêu cho nhiều tài khoản chỗ con của người đặ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 có một giới hạn ngân sách hằng ngày dành cho Protected Audience ở cấp tài khoản. Giới hạn ngân sách hằng ngày sẽ giới hạn rủi ro trong môi trường đấu giá trong trình duyệt. Sau khi đạt đến giới hạn ngân sách hằng ngày, tài khoản sẽ không còn nhận được các yêu cầu giá thầu đủ điều kiện cho Protected Audience nữa.

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

Phản hồi theo thời gian thực và giá thầu tối thiểu để giành chiến 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 phản hồi về 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á Protected Audience trên thiết bị. Mỗi người mua theo nhóm mối quan tâm mà người đặt giá thầu chỉ định cho giá thầu phản hồi sẽ nhận được một đối tượng phản hồi, bất kể giá thầu mà người mua theo nhóm mối quan tâm đặt trong phiên đấu giá trong Protected Audience là bao nhiêu. Thông tin sau sẽ có về đối tượng phản hồi của người mua theo nhóm mối quan tâm:

• 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 theo nhóm 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 chiến thắng trong phiên đấu giá tổng thể.
• 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, nhằm đánh bại giá thầu được xếp 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 theo 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 của Authorized Buyers và Phần mở rộng OpenRTB để biết các tên trường cụ thể.

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

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

Bên đặt giá thầu có thể liên hệ với người quản lý tài khoản để định cấu hình một URL tĩnh dùng để gửi thông báo phản hồi về giá thầu gỡ lỗi Protected Audience. URL tĩnh này sẽ được tìm nạp từ các máy chủ của Google và thay thế các macro đã chọn sau khi phiên đấu giá trong Protected Audience 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 (BidRequest.google_query_id trong giao thức Authorized Buyers và BidRequest.ext.google_query_id trong giao thức OpenRTB) được gửi trên yêu cầu giá thầu theo bối cảnh có bật Protected Audience.
• %%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 trong 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.

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

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 của Chrome.

Sự kiện nhấp chuột

Bên đặt giá thầu có thể báo cáo các sự kiện nhấp chuột trên quảng cáo Protected Audience cho Google bằng cách sử dụng Fenced Frame Reporting API. Bên đặt giá thầu cần sử dụng loại sự kiện click để thông báo cho Google về lượt nhấp. Ví dụ như sau:

window.fence.reportEvent({
    'eventType': 'click',
    // Google does not require bidders to send data to Google in 'eventData'.
    // However, 'eventData' must be a non-null value, such as an empty string.
    'eventData': '',
    'destinations': ['direct-seller']
});

TURTLEDOVE cấp sản phẩm

Quảng cáo gồm nhiều mảnh hoặc TURTLEDOVE (PLTD) cấp sản phẩm được hỗ trợ cho các đối tác RTB của Google trong quá trình kiểm thử Protected Audience API. 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 dự định kiểm thử PLTD, vì cần phải có thêm tài nguyên và cấu hình.

Giới thiệu

Dưới đâ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 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 Authorized Buyers.
3. Sau khi tài khoản được định cấu hình, 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 với quảng cáo cấp sản phẩm (quảng cáo bao gồm nhiều phần) trong các phiên đấu giá Protected Audience API, hãy tuân theo các yêu cầu sau:

• Đưa tham số truy vấn &pltd=True vào renderUrl cho vùng chứa của quảng cáo thành phần (còn gọi là renderUrl cấp cao nhất) để phân biệt renderUrls cấp cao nhất trong quá trình xem xét 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 được tìm nạp để Google xem xét mẫu quảng cáo. Để biết khi nào nên trả về một quá trình hiển thị quảng cáo đại diện, bạn có thể tham khảo tham số truy vấn validation=True do hệ thống xem xét 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 của yêu cầu giá thầu sẽ điền sẵn các trường liên quan đến Protected Audience API trên phản hồi giá thầu theo bối 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 để tham gia trình duyệt của người dùng vào nhóm mối quan tâm.
• Triển khai generateBid() và reportWin().
• Chọn nguồn gốc của chủ sở hữu nhóm mối quan tâm và thêm các nguồn gốc đó vào tài khoản Authorized Buyers.
  • Nguồn gốc của chủ sở hữu nhóm mối quan tâm phải khớp với nguồn gốc nơi lưu trữ các hàm generateBid().
  • Hãy liên hệ với người quản lý tài khoản hoặc gửi phiếu yêu cầu hỗ trợ thông qua Trung tâm trợ giúp người mua được uỷ quyền để hoàn tất bước này.
• 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 việc kiểm thử Protected Audience API.
• Gửi mẫu quảng cáo để được xem xét và phê duyệt thông qua API Tệp sáng tạo.
• (Không bắt buộc) Thiết lập các đ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 nhóm mối quan tâm do nguồn gốc của người mua theo nhóm mối quan tâm của bạn sở hữu. Đ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 về những người mua theo nhóm mối quan tâm đã yêu cầu đưa vào phiên đấu giá trong 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 để định cấu hình một URL tĩnh nhằm nhận thông báo từ máy chủ đến máy chủ nhằm cung cấp phản hồi giá thầu của Protected Audience về trạng thái của giá thầu từ phiên đấu giá Protected Audience trên thiết bị nhằm giúp gỡ lỗi các vấn đề không mong muốn. Xem thông báo phản hồi giá thầu để biết thông tin chi tiết.

Giai đoạn kiểm thử

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

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

1. Sử dụng Chrome 101 trở lên.
2. Bật Privacy Sandbox API (API Hộp cát về quyền riêng tư) và Khung bảo vệ bằng cách sử dụng chrome://flags/#privacy-sandbox-ads-apis và chrome://flags/#enable-fenced-frames. Hãy xem thêm tại phần Kiểm thử hộp cát về quyền riêng tư.
3. Gửi mẫu quảng cáo để xin phê duyệt bằng cách sử dụng API Đặt giá thầu theo thời gian thực.
4. Hãy 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 do bên đặt giá thầu sở hữ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 một trang nhà xuất bản thử nghiệm riêng cho từng đối tác, trong đó chỉ đối tác nhất định mới có thể tham gia vào phiên đấu giá. Bạn có thể dễ dàng thắng các phiên đấu giá trong trình duyệt trên trang cụ thể của đối tác một cách đáng tin cậy.

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ả đấu giá được gửi phía máy chủ, có nghĩa là bên đặt giá thầu giành chiến thắng sẽ nhận được ping lại từ reportWin().
   3. Bảng điều khiển trang dành cho nhà xuất bản thử nghiệm sẽ ghi lại thông báo gỡ lỗi cho từng 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 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 scoreAd(). Giá trị là mã trạng thái mẫu quảng cáo.

Giai đoạn 2: (Không bắt buộc) Thử nghiệm không hiển thị

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 vào phiên đấu giá Protected Audience, Google sẽ cho phép đối tác chuyển sang giai đoạn kiểm thử tiếp theo.

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á trong 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á Protected Audience không được hiển thị. Việc này cho phé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 Authorized Buyers khi bạn đã sẵn sàng. Google sẽ kích hoạt tài khoản cho 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á trong Protected Audience trên quy mô lớn mà không cần hiển thị, Google có thể cho phép đối tác hiển thị quảng cáo giành chiến thắng trong Protected Audience. Google có một lượng nhỏ lưu lượng truy cập mà phiên đấu giá Protected Audience đủ điều kiện để chạy và quảng cáo theo nhóm mối quan tâm giành chiến thắng được hiển thị. Giá thầu trong trình duyệt của bên đặt giá thầu tham gia cạnh tranh với các giá thầu truyền thống.

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 Authorized Buyers khi bạn đã sẵn sàng. Google sẽ kích hoạt tài khoản cho giai đoạn này.