Protected Audience API (เดิมคือ FLEDGE)

Chrome ได้เสนอ Protected Audience API ซึ่งเป็น API ในเบราว์เซอร์ ที่ช่วยให้ผู้ลงโฆษณาและบริษัทเทคโนโลยีโฆษณาสามารถแสดงโฆษณาที่กำหนดเป้าหมายตามกลุ่มความสนใจ โดยไม่ต้องอาศัยคุกกี้ของบุคคลที่สาม ขณะเดียวกันก็ปกป้องผู้ใช้จากการติดตามข้ามเว็บไซต์ ซึ่งเป็นส่วนหนึ่งของ Privacy Sandbox

Chrome กำลังเรียกใช้ช่วงทดลองใช้จากต้นทาง สำหรับ Protected Audience API Authorized Buyers มีสิทธิ์เข้าร่วม การทดสอบ Protected Audience API ในพื้นที่โฆษณาของผู้เผยแพร่โฆษณา Ad Manager ผู้เสนอราคาสามารถทําสิ่งต่อไปนี้ได้โดยการทดสอบ Protected Audience API

• ทําซ้ำและเรียนรู้เกี่ยวกับประสิทธิภาพของโฟลว์ Protected Audience API
• สร้างความคิดเห็นเกี่ยวกับการปรับปรุง API ที่อาจเกิดขึ้นในฟอรัมสาธารณะ เช่น GitHub
• เตรียมพร้อมที่จะรองรับการโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ผ่าน API โดยไม่ต้อง อาศัยคุกกี้ของบุคคลที่สาม

Authorized Buyers ที่สนใจทดสอบควรดูรายละเอียดในส่วนการเริ่มต้นใช้งาน

เบต้า: ลักษณะการทำงานที่อธิบายไว้ที่นี่อาจเปลี่ยนแปลงไปในอนาคตเมื่อเราได้เรียนรู้จากการ ทดสอบและรวบรวมความคิดเห็นจากผู้เผยแพร่โฆษณาและ Authorized Buyers

หมายเหตุ: การทดสอบ Protected Audience API พร้อมให้บริการแก่ Authorized Buyers เท่านั้น ระบบยังไม่รองรับผู้เสนอราคา Exchange และเครือข่ายที่เข้าร่วมการเสนอราคาแบบเปิด

หมายเหตุ: เมื่อ Protected Audience API (ก่อนหน้านี้เรียกว่า FLEDGE) พร้อมให้บริการแก่ผู้ใช้ทั่วไปใน Chrome แล้ว Ad Manager จะเริ่มค่อยๆ เพิ่มปริมาณการเข้าชมที่รวมอยู่ในการทดสอบ เราจะติดตามผลกระทบที่มีต่อรายได้ของผู้เผยแพร่โฆษณา ในขณะที่ค่อยๆ เพิ่มเปอร์เซ็นต์การเข้าชม และจะไม่เพิ่มปริมาณขึ้นอีกหากพบผลเสียที่เห็นได้ชัด เราคาดว่าภายในสิ้นปี 2023 จะมีการใช้การเข้าชม Chrome สูงสุดถึง 10% ในการทดสอบ Protected Audience API

สรุปขั้นตอนการแสดงโฆษณา

สรุปขั้นตอนการแสดงโฆษณา Protected Audience สำหรับพาร์ทเนอร์ Authorized Buyers มีดังนี้

1. ผู้เสนอราคาทำงานร่วมกับผู้ลงโฆษณาเพื่อรักษากลุ่มความสนใจสำหรับผู้ลงโฆษณาแต่ละราย บ่อยครั้งที่ผู้ลงโฆษณาจะเพิ่มแท็กของผู้เสนอราคาลงในหน้าของผู้ลงโฆษณาเพื่อเพิ่มเบราว์เซอร์ลงในกลุ่มความสนใจ
2. ผู้ใช้ปลายทางเข้าชมหน้าเว็บของผู้ลงโฆษณา หน้าเว็บอาจมีแท็กของผู้เสนอราคา
3. แท็กของผู้เสนอราคาเรียกใช้ Protected Audience API joinAdInterestGroup() การเรียกนี้ขอให้เบราว์เซอร์เพิ่มผู้ใช้ลงในกลุ่มความสนใจ
4. ผู้ใช้ปลายทางเข้าชมหน้าเว็บของผู้เผยแพร่โฆษณา เบราว์เซอร์ของผู้ใช้ส่งคำขอ แท็กโฆษณาของผู้เผยแพร่โฆษณาของ Google
5. แท็กโฆษณาของผู้เผยแพร่โฆษณาของ Google จะส่งคำขอโฆษณาตามบริบทไปยังเซิร์ฟเวอร์ของ Google
6. Google จะส่งคำขอราคาเสนอตามบริบทไปยังผู้เสนอราคาที่เข้าร่วม ดูข้อมูลเพิ่มเติมได้ที่ ส่วนการเปลี่ยนแปลงคำขอเสนอราคา
7. ผู้เสนอราคาจะส่งการเสนอราคาตอบกลับซึ่งรวมถึงInterestGroupBidding ข้อความที่จำเป็นต่อการเข้าร่วมการประมูลกลุ่มความสนใจ ใน OpenRTB จะระบุด้วยฟิลด์ BidResponse.ext.igbid และในโปรโตคอล Google RTB ที่เลิกใช้งานแล้วจะระบุด้วยฟิลด์ BidResponse.interest_group_bidding หากผู้เสนอราคาไม่ได้ระบุข้อมูลนี้ Google จะไม่รวมต้นทางของผู้เสนอราคาใน interestGroupBuyers ในการกำหนดค่าการประมูล InterestGroupBidding ยังมีสัญญาณเฉพาะผู้ซื้อที่ไม่บังคับซึ่ง จะส่งไปยังฟังก์ชันการเสนอราคาของผู้เสนอราคาในระหว่างการประมูล ในเบราว์เซอร์ด้วย ใน OpenRTB จะระบุด้วยฟิลด์ BidResponse.ext.igbid.igbuyer.buyerdata และในโปรโตคอล Google RTB ที่เลิกใช้งานแล้วจะระบุด้วยฟิลด์ BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals ดูข้อมูลเพิ่มเติมได้ที่ส่วนการเปลี่ยนแปลงการตอบกลับคำขอเสนอราคา
8. Google เรียกใช้การประมูลฝั่งเซิร์ฟเวอร์และส่งคืนการเสนอราคาตอบกลับไปยังเบราว์เซอร์ การประมูลฝั่งเซิร์ฟเวอร์จะพิจารณาการเสนอราคาแบบเดิมฝั่งเซิร์ฟเวอร์ การเสนอราคาตอบอาจมีข้อมูลเกี่ยวกับราคาเสนอที่ชนะตามบริบท (หากมี)
9. การเสนอราคาตอบมีการกำหนดค่าการประมูลสำหรับการประมูลในเบราว์เซอร์ ซึ่งอาจรวมถึงสัญญาณตามบริบทจากผู้ซื้อแต่ละรายที่เข้าร่วม (ซึ่งส่งผ่าน buyerdata ของ OpenRTB หรือ per_buyer_signals ของโปรโตคอล Google RTB ที่เลิกใช้งานไปแล้วก่อนหน้านี้) ข้อมูลผู้ชนะตามบริบท และ การตั้งค่าสำหรับการมีสิทธิ์เสนอราคา
10. แท็กผู้เผยแพร่โฆษณาของ Google เรียกใช้ Protected Audience API runAdAuction() เพื่อเริ่มการประมูลกลุ่มความสนใจในอุปกรณ์ Google จะรวมเฉพาะผู้ซื้อที่รวมเป็นInterestGroupBuyerในInterestGroupBiddingระหว่างการกำหนดค่าการประมูล
11. Google จะส่งสัญญาณเฉพาะผู้ซื้อที่ไม่บังคับของผู้เสนอราคาที่มีสิทธิ์แต่ละรายไปยัง การกำหนดค่าการประมูลที่ใช้ Protected Audience API
12. หากกลุ่มความสนใจของผู้เสนอราคาที่ระบุมี trustedBiddingSignalsUrl เบราว์เซอร์จะส่งคำขอไปยัง trustedBiddingSignalsUrlของแต่ละกลุ่มเพื่อดึงสัญญาณแบบเรียลไทม์สำหรับแต่ละกลุ่ม ดูรายละเอียดได้ในข้อกําหนดของ Protected Audience API
13. เบราว์เซอร์จะเรียกใช้ generateBid() ของผู้เสนอราคาสำหรับกลุ่มความสนใจแต่ละกลุ่ม ที่เลือกใช้และมีสิทธิ์เข้าร่วมการประมูลในเบราว์เซอร์ ขั้นตอนนี้จะคำนวณราคาเสนอและเลือกครีเอทีฟโฆษณา generateBid() มีสิทธิ์เข้าถึง สัญญาณของผู้ซื้อที่ไม่บังคับซึ่งผู้เสนอราคาและสัญญาณการเสนอราคาที่เชื่อถือได้ สำหรับกลุ่มความสนใจที่ระบุ
14. เบราว์เซอร์เรียกใช้ scoreAd() ของผู้ขาย (ในกรณีนี้คือ Google) เพื่อ กำหนดอันดับให้กับราคาเสนอแต่ละรายการในการประมูลโฆษณากลุ่มความสนใจ ระบบจะจัดอันดับ และกรองราคาเสนอตามการป้องกันผู้เผยแพร่โฆษณา นโยบายโฆษณา และข้อจำกัดอื่นๆ
15. เบราว์เซอร์จะเรียกใช้การประมูลด้วยราคาเสนอตามกลุ่มความสนใจที่มีสิทธิ์ ราคาเสนอตามบริบทที่จัดอันดับสูงสุดจะเข้าร่วมการประมูลในเบราว์เซอร์
16. หลังจากการประมูล หากมีผู้ชนะที่เป็นกลุ่มความสนใจ เบราว์เซอร์จะเรียกใช้ reportResult() ของผู้ขายและ reportWin() ของผู้เสนอราคาเพื่อแจ้งให้แต่ละฝ่ายทราบเกี่ยวกับผู้ชนะในการประมูลในเบราว์เซอร์
17. หากโฆษณากลุ่มความสนใจชนะ แท็กผู้เผยแพร่โฆษณาของ Google จะแสดงโฆษณาใน iframe

รายละเอียดขั้นตอนการแสดง

ก่อนการแสดงโฆษณา

การตรวจสอบครีเอทีฟโฆษณา

ครีเอทีฟโฆษณาต้องได้รับการตรวจสอบและอนุมัติจาก Google ก่อนจึงจะแสดงจากการประมูลในเบราว์เซอร์ของ Protected Audience ได้ คุณสามารถส่งครีเอทีฟโฆษณาเพื่อรับการตรวจสอบ ผ่าน Real-time Bidding API หรือผ่าน การสแกนครีเอทีฟโฆษณาอัตโนมัติ ครีเอทีฟโฆษณาสำหรับ Protected Audience API ในการประมูลโฆษณาตามกลุ่มความสนใจในเบราว์เซอร์ต้องมี renderUrls เพื่อรับการตรวจสอบ

ข้อกำหนดสำหรับ renderUrls มีดังนี้

• renderUrl ที่ส่งผ่าน API ควรตรงกับ renderUrl ที่ใช้ในการประมูลโฆษณาตามกลุ่มความสนใจ
• renderUrlแต่ละรายการอาจแสดงผู้ลงโฆษณาหรือแคมเปญโฆษณาได้เพียงรายการเดียว renderUrl ที่ระบุไม่สามารถใช้ในการแสดงโฆษณาในนามของผู้ลงโฆษณาหลายรายได้ renderUrl แต่ละรายการต้องแมปกับครีเอทีฟโฆษณาเดียว
• Google ต้องเข้าถึงและดึงข้อมูล renderUrl ได้โดยใช้ระบบตรวจสอบครีเอทีฟโฆษณาแบบออฟไลน์ของ Google เป็นเวลาสูงสุด 7 วันหลังจากที่มีการเสนอราคาโฆษณาล่าสุด

Real-time Bidding API

ผู้เสนอราคาสามารถใช้ Real-time Bidding API เพื่ออัปโหลดครีเอทีฟโฆษณาสำหรับการ เสนอราคาตามกลุ่มความสนใจ

การสแกนครีเอทีฟโฆษณาอัตโนมัติ

ผู้เสนอราคาสามารถตั้งค่าการสแกนครีเอทีฟโฆษณาอัตโนมัติสำหรับครีเอทีฟโฆษณาที่ไม่ได้ อัปโหลดผ่าน Real-time Bidding API

หากตั้งค่าการสแกนครีเอทีฟโฆษณาอัตโนมัติ Google จะค้นหาครีเอทีฟโฆษณาในการประมูลในเบราว์เซอร์และสแกนโดยอัตโนมัติเพื่อให้มีสิทธิ์สำหรับการประมูลในอนาคต

วิธีเปิดการสแกนครีเอทีฟโฆษณาอัตโนมัติมีดังนี้

• เพิ่มrenderUrlต้นทางของครีเอทีฟโฆษณาตามกลุ่มความสนใจทั้งหมดลงในบัญชี Authorized Buyers

• เพิ่มส่วนหัว HTTP ที่กำหนดเองต่อไปนี้ในการตอบกลับ HTTP ของครีเอทีฟโฆษณา

  Authorized-Buyers-Creative-ID	สตริง รหัสครีเอทีฟโฆษณาเฉพาะผู้ซื้อ รหัสครีเอทีฟโฆษณามีความยาวสูงสุดได้ไม่เกิน 128 ไบต์
  Authorized-Buyers-Click-Through-URLs	สตริง ชุดของ URL ปลายทางที่ประกาศสำหรับครีเอทีฟโฆษณาที่เข้ารหัสตาม RFC2396

ตัวอย่าง

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>

การหมดอายุของครีเอทีฟโฆษณา

ครีเอทีฟโฆษณาจะได้รับอนุมัติเป็นเวลา 15 วัน หากส่งครีเอทีฟโฆษณาด้วย Real-time Bidding API คุณจะต้องส่งครีเอทีฟโฆษณาอีกครั้งหลังจากผ่านไป 15 วัน หากคุณใช้ การสแกนครีเอทีฟโฆษณาอัตโนมัติ กระบวนการสแกนจะสแกนครีเอทีฟโฆษณาเหล่านั้นอีกครั้งโดยอัตโนมัติ

รหัสการรายงานของผู้ซื้อ

คุณสามารถแบ่งเมตริกการรายงาน (เช่น การแสดงผล) โดยใช้มิติข้อมูล ที่ผู้ซื้อระบุ (เช่น รหัสแคมเปญหรือรหัสผู้ลงโฆษณา) หากต้องการเพิ่ม มิติข้อมูลสําหรับค่าใช้จ่ายของกลุ่มความสนใจ ให้ระบุ buyerAndSellerReportingId สําหรับ โฆษณาเมื่อเพิ่มอุปกรณ์ของผู้ใช้ลงในกลุ่มความสนใจ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Protected Audience

ตัวอย่างต่อไปนี้แสดงวิธีเพิ่ม buyerAndSellerReportingId ลงในการกำหนดค่ากลุ่มความสนใจ

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

buyer_reporting_idจะปรากฏเป็นมิติข้อมูลใหม่ในเครื่องมือการรายงานของผู้ซื้อที่ได้รับอนุญาต ในฐานะมิติข้อมูลรหัสการรายงานของผู้ซื้อ

การประมูลฝั่งเซิร์ฟเวอร์

การเปลี่ยนแปลงคำขอราคาเสนอ

ต่อไปนี้คือโปรโตคอลที่รองรับในเวอร์ชันแรกๆ สำหรับใช้ในการทดสอบ

• ลิงก์ก่อนเปิดตัว OpenRTB
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) ลิงก์ต้น

ระบุการรองรับการประมูลตามกลุ่มความสนใจ

คำขอเสนอราคามีฟิลด์ใหม่เพื่อระบุการรองรับการประมูลกลุ่มความสนใจ ดังนี้

• OpenRTB:
  • BidRequest.imp.ext.ae
  • BidRequest.imp.ext.igbid
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว)
  • BidRequest.adslot.supported_auction_environment
  • BidRequest.adslot.interest_group_bidding_allowed

คุณสามารถใช้ช่องนี้เพื่อแยกความแตกต่างระหว่างโอกาสในการแสดงผลที่ รองรับการประมูลกลุ่มความสนใจในเบราว์เซอร์ของ Protected Audience กับโอกาสในการแสดงผลที่ รองรับเฉพาะการประมูลแลกเปลี่ยนฝั่งเซิร์ฟเวอร์แบบเดิม AuctionEnvironment enum อาจมีค่าดังต่อไปนี้

• SERVER_SIDE_AUCTION (OpenRTB JSON: 0): การประมูลที่กำหนด โฆษณาที่ชนะจะทำงานบนเซิร์ฟเวอร์ของ Exchange
• ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): คำขอที่รองรับ Protected Audience ซึ่งการประมูลตามบริบทจะทำงานในเซิร์ฟเวอร์ของ Exchange และการเสนอราคาตามกลุ่มความสนใจและการประมูลสุดท้ายจะทำงานในเบราว์เซอร์
• SERVER_SIDE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 3): การประมูลตามบริบท ทํางานในเซิร์ฟเวอร์ของ Exchange และตรรกะการเสนอราคาสำหรับราคาเสนอของกลุ่ม ความสนใจและตรรกะการให้คะแนนสําหรับการกําหนดโฆษณาที่ชนะสุดท้ายจะ ทํางานในเซิร์ฟเวอร์การเสนอราคาและการประมูล

ระบุขนาดช่องโฆษณา Protected Audience

คำขอราคาเสนอมีช่องต่อไปนี้เพื่อให้คุณทราบขนาดช่องโฆษณา Protected Audience

• OpenRTB:
  • BidRequest.imp.ext.interest_group_auction.width
  • BidRequest.imp.ext.interest_group_auction.height
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว)
  • BidRequest.adslot.interest_group_auction.width
  • BidRequest.adslot.interest_group_auction.height

ฟิลด์เหล่านี้ระบุขนาดของช่องโฆษณาสำหรับการประมูล Protected Audience เป็นพิกเซล

ขนาดนี้อาจแตกต่างจากขนาดในคำขอตามบริบท เช่น ขนาดที่เห็นในฟิลด์ BidRequest.imp.banner.format.w และ BidRequest.imp.banner.format.h ของ OpenRTB หรือฟิลด์ BidRequest.adslot.width และ BidRequest.adslot.height ของโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว

คำขอตามบริบทอาจมีหลายขนาด โฆษณาที่ชนะการประมูลในอุปกรณ์ คาดว่าจะแสดงในช่องขนาดคงที่ช่องเดียวเท่านั้น

ระบุว่าโฆษณา Protected Audience แสดงผลได้หรือไม่

โฆษณา Protected Audience อาจแสดงหรือไม่แสดงก็ได้ ขึ้นอยู่กับขั้นตอนการผสานรวมปัจจุบัน (ดูการทดสอบที่ไม่แสดงผล) ฟิลด์ render_interest_group_ads ในคำขอราคาเสนอจะระบุว่าโฆษณา Protected Audience ที่ชนะ จะได้รับการแสดงผลหรือไม่

• OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) BidRequest.adslot.interest_group_auction.render_interest_group_ads

ลดการพึ่งพาตัวระบุผู้ใช้

คำขอราคาเสนอตามบริบทที่อยู่ในขอบเขตสำหรับการทดสอบ Protected Audience API สามารถใช้ตัวระบุแบบคุกกี้เดิมต่อไปได้เมื่อมีจากเบราว์เซอร์ เช่น ฟิลด์ BidRequest.user.id และ BidRequest.user.buyerid หรือ BidRequest.google_user_id และ BidRequest.hosted_match_data ในโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว การมีตัวระบุดังกล่าวในคำขอเสนอราคา จะเป็นไปตามนโยบายความเป็นส่วนตัวที่มีอยู่ เราขอแนะนําว่าคุณไม่ควรใช้ตัวระบุที่อิงตามคุกกี้เพื่อวัตถุประสงค์ในการกําหนดเป้าหมายและการเสนอราคาในระหว่างการทดสอบ เพื่อเตรียมพร้อมสำหรับการซื้อที่มีประสิทธิภาพได้ดียิ่งขึ้นเมื่อคุกกี้ของบุคคลที่สามไม่พร้อมใช้งานอีกต่อไป

นอกจากนี้ Google ยังอาจทำการทดสอบขนาดเล็กซึ่งจะมีการปกปิดตัวระบุที่อิงตามคุกกี้ จากคำขอราคาเสนอที่อยู่ในขอบเขตสำหรับการทดสอบ Protected Audience API เพื่อประเมินผลกระทบที่อาจเกิดขึ้นจากการเลิกใช้งานคุกกี้ของบุคคลที่สาม

การทดสอบการเลิกใช้งานคุกกี้ของบุคคลที่สามที่อำนวยความสะดวกโดย Chrome

Chrome มีการทดสอบที่ Chrome ช่วยอำนวยความสะดวกเพื่อเตรียมพร้อมสำหรับการเลิกใช้งานคุกกี้ของบุคคลที่สาม (3PCD) ในปี 2024

เว็บไซต์และผู้ให้บริการสามารถใช้การทดสอบที่ Chrome ช่วยอำนวยความสะดวกเพื่อทดสอบระบบภายใต้ 3PCD ในการทดสอบ ระบบจะกำหนดเบราว์เซอร์ Chrome ให้กับกลุ่มการทดสอบ 3PCD ไม่ว่าจะเป็นโหมด A หรือโหมด B แต่ละเบราว์เซอร์จะได้รับการกำหนดป้ายกำกับที่สอดคล้องกัน ซึ่งสอดคล้องกับกลุ่มการทดสอบ 3PCD ที่เฉพาะเจาะจงซึ่งคุณเข้าถึงได้ผ่าน Chrome API ในเบราว์เซอร์

Google จะส่งป้ายกำกับที่ไม่มีการแก้ไขจาก Chrome API ในคำขอเสนอราคา RTB เนื่องจากปริมาณการเข้าชมของป้ายกำกับแต่ละรายการมีน้อย Google จึงไม่ ได้รวมป้ายกำกับไว้ในบริบทที่มีการจำกัดความเป็นส่วนตัวเสมอไป

ฟิลด์ที่คุณดูป้ายกำกับได้มีดังนี้

• OpenRTB: BidRequest.device.ext.cdep
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) BidRequest.device.cookie_deprecation_label

การเปลี่ยนแปลงการเสนอราคาตอบ

ระบุการเข้าร่วมการประมูลตามกลุ่มความสนใจ

คุณมีหน้าที่ระบุความตั้งใจที่จะเข้าร่วมการประมูลในเบราว์เซอร์อย่างชัดเจนโดยการส่งออบเจ็กต์ InterestGroupBidding ในการเสนอราคาตอบตามบริบท

• OpenRTB: BidResponse.ext.igbid
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว): BidResponse.interest_group_bidding

คุณต้องระบุการเสนอราคาตอบตามบริบท การตอบกลับไม่จำเป็นต้อง รวมการเสนอราคาตามบริบท ออบเจ็กต์ InterestGroupBidding ควรมี origin สำหรับแต่ละ InterestGroupBuyer ซึ่งควรตรงกับต้นทางอย่างใดอย่างหนึ่งที่ผู้เสนอราคา กำหนดค่าไว้สำหรับบัญชีของตน ระบบจะเพิ่ม origin ลงใน interestGroupBuyers ของการกําหนดค่าการประมูลเมื่อแท็กผู้เผยแพร่โฆษณาผ่าน Google เรียกใช้ runAdAuction()

ส่งต่อสัญญาณบริบทของผู้ซื้อ

คุณสามารถรวมสัญญาณของผู้ซื้อในการเสนอราคาตอบตามบริบท ซึ่ง Google จะส่งต่อเป็นออบเจ็กต์ JSON ไปยังฟังก์ชันการเสนอราคาในอุปกรณ์ของผู้ซื้อผ่านอาร์กิวเมนต์ perBuyerSignals ซึ่งสามารถรวมไว้ในการเสนอราคาตอบพร้อมฟิลด์ต่อไปนี้ได้ ทั้งนี้ขึ้นอยู่กับโปรโตคอล

• OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
• RTB ของ Google (เลิกใช้งานแล้ว): BidResponse.interest_group_bidding.per_buyer_signals

เผยแพร่สัญญาณการแสดงผลตามบริบทของผู้ซื้อ

ครีเอทีฟโฆษณาของกลุ่มความสนใจอาจใช้สัญญาณตามบริบทแบบจำกัดในระหว่างการแสดงผลโดย การส่งสัญญาณเหล่านั้นผ่านการตอบกลับราคาเสนอตามบริบทและการรับสัญญาณเหล่านั้น ในคำขอ URL การแสดงผลโดยใช้การขยายมาโคร ตัวอย่างเช่น สามารถใช้สัญญาณการแสดงผล เพื่อปรับแต่งรูปลักษณ์และความรู้สึกของครีเอทีฟโฆษณาเพื่อปรับปรุง ประสิทธิภาพในบริบทของช่องโฆษณาหรือหน้าผู้เผยแพร่โฆษณาที่กำหนด

คำเตือน: ฟีเจอร์นี้ขึ้นอยู่กับdeprecatedRenderURLReplacementsการรองรับของเบราว์เซอร์

คุณสามารถรวมสัญญาณการแสดงผลของผู้ซื้อที่แปลงเป็นสตริงที่ปลอดภัยสำหรับ URL ไว้ใน การเสนอราคาตอบตามบริบท ซึ่ง Google จะแทนที่ใน URL การแสดงผลกลุ่มความสนใจที่ชนะ โดยการสร้างมาโคร ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

คุณระบุสัญญาณการแสดงผลในการเสนอราคาตอบได้โดยใช้ฟิลด์ต่อไปนี้ โดยขึ้นอยู่กับโปรโตคอล

• OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
• RTB ของ Google (เลิกใช้งานแล้ว): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

คุณอาจรวมชุดสัญญาณการแสดงผลได้สูงสุด 3 ชุดที่มีคำต่อท้ายมาโครต่างกัน ในการเสนอราคาตอบเพื่อแยกความแตกต่างของสัญญาณต่างๆ เช่น คุณอาจใช้คำต่อท้าย เพื่อจับคู่ชุดสัญญาณที่เฉพาะเจาะจงซึ่งใช้ได้กับครีเอทีฟโฆษณาเท่านั้น โดยมีมาโครที่สอดคล้องกันใน URL การแสดงผล ซึ่งจะช่วยลดขนาดการโอนข้อมูล

ระบบจะปฏิเสธไม่ให้ผู้ซื้อกลุ่มความสนใจเข้าร่วมการประมูล Protected Audience หากสัญญาณไม่ปลอดภัยสำหรับ URL, คำต่อท้ายมาโครไม่ซ้ำกัน หรือมีการระบุชุดสัญญาณมากกว่า 3 ชุด

ระบุราคาเสนอสูงสุดในเบราว์เซอร์

ในข้อเสนอ Protected Audience คาดว่าการคำนวณราคาเสนอ และการประมูลสุดท้ายจะทำงานในอุปกรณ์แบบเฉพาะเครื่อง ซึ่งอาจทำให้เกิด เวกเตอร์การละเมิดที่อาจเกิดขึ้นซึ่งส่งผลต่อความสมบูรณ์ของผลลัพธ์การประมูลขั้นสุดท้าย เช่น ราคาเสนอที่ชนะ

ในฐานะการลดความเสี่ยงที่ Google รองรับระหว่างการทดสอบ Protected Audience API สำหรับพาร์ทเนอร์ RTB คุณสามารถระบุมูลค่าการเสนอราคาสูงสุดที่คาดไว้ในการเสนอราคาตอบตามบริบทแต่ละรายการได้ ราคาเสนอสูงสุดที่คาดไว้คือราคาเสนอสูงสุดที่คาดว่าฟังก์ชันการเสนอราคาจะแสดง หากราคาเสนอที่ชนะซึ่งรายงานจากการประมูลในเบราว์เซอร์สูงกว่าจำนวนนี้ ระบบจะไม่นับราคาเสนอที่ชนะเป็นเหตุการณ์ที่เรียกเก็บเงินได้ โดยแนวทางนี้อาจมีการเปลี่ยนแปลง

ในการเสนอราคาตอบ คุณสามารถระบุมูลค่าราคาเสนอสูงสุดที่คาดไว้ในฟิลด์ต่อไปนี้

• OpenRTB: BidResponse.igbid.igbuyer.maxbid(แสดงในหน่วยสกุลเงิน CPM)
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (แสดงในหน่วย CPM ขนาดเล็ก)

ระบุแหล่งที่มาของการแสดงผลไปยังหลายบัญชี

ผู้เสนอราคาต้องเลือกรหัสการเรียกเก็บเงินเพื่อระบุแหล่งที่มาของ การแสดงผลของราคาเสนอสำหรับกลุ่มความสนใจโดยใช้ช่องต่อไปนี้

• OpenRTB: BidResponse.igbid.igbuyer.billing_id
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) BidResponse.interest_group_bidding.interest_group_buyers.billing_id

รหัสการเรียกเก็บเงินที่เลือกต้องเป็นรหัสการเรียกเก็บเงินที่มีสิทธิ์จากคำขอราคาเสนอ

• OpenRTB: BidRequest.imp.ext.billing_id
• โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว) BidRequest.adslot.matching_ad_data.billing_id

หากไม่ได้ระบุรหัสการเรียกเก็บเงินเพื่อระบุแหล่งที่มาของการแสดงผลการเสนอราคาของกลุ่มความสนใจ ผู้เสนอราคาจะไม่เข้าร่วมการประมูล Protected Audience

บัญชีย่อยมีรหัสการเรียกเก็บเงินได้สูงสุด 2 รหัส ผู้ซื้ออาจใช้รหัสการเรียกเก็บเงินหนึ่งสำหรับค่าใช้จ่ายตามบริบท และอีกรหัสหนึ่งสำหรับค่าใช้จ่ายของกลุ่มตามความสนใจ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหากต้องการกำหนดค่ารหัสการเรียกเก็บเงิน 2 รายการ สำหรับบัญชีย่อย

คุณสามารถกำหนดงบประมาณรายวันสำหรับรหัสการเรียกเก็บเงินแต่ละรายการได้ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อกำหนดงบประมาณรายวันสำหรับรหัสการเรียกเก็บเงินของบัญชีย่อย

รหัสการเรียกเก็บเงินสำหรับบัญชีย่อยทั้งหมดที่มีงบประมาณที่ใช้ได้ซึ่งมีสิทธิ์เสนอราคาสำหรับ การแสดงผลจะปรากฏในคำขอราคาเสนอสำหรับการเลือกการระบุแหล่งที่มาของการใช้จ่าย ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อแก้ไขงบประมาณสำหรับรหัสการเรียกเก็บเงินของกลุ่มความสนใจ

ระหว่างการประมูลในเบราว์เซอร์

สร้างราคาเสนอในเบราว์เซอร์

ใช้ generateBid() เพื่อสร้างราคาเสนอในเบราว์เซอร์

Google มีพารามิเตอร์ต่อไปนี้

• auctionSignals: ว่างเปล่า
• perBuyerSignals: ออบเจ็กต์ JavaScript ของสัญญาณเดียวกันที่ผู้เสนอราคาให้ไว้ใน การตอบกลับตามบริบท

ระบบจะแสดงพารามิเตอร์ต่อไปนี้

• ad: Google จะไม่สนใจฟิลด์นี้
• bid: ราคาเสนอที่เป็นตัวเลขซึ่งเข้าร่วมการประมูล ต้องอยู่ในหน่วย CPM (ไม่ใช่หน่วยไมโคร)
• render: URL ที่แสดงเพื่อแสดงครีเอทีฟโฆษณาหากเสนอราคาชนะการประมูล Google ต้องตรวจสอบและอนุมัติ URL นี้ มิฉะนั้นระบบจะกรอง URL ออกจากการประมูล
• allowComponentAuction: ต้องเป็น true ปัจจุบัน Google รองรับการทดสอบ การประมูลแบบผู้ขายหลายราย

เช่น

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

ดูคำอธิบายฟังก์ชัน generateBid() ได้ในส่วนการเสนอราคา ในอุปกรณ์ ของข้อกำหนด Protected Audience

สกุลเงินของราคาเสนอ

ราคาเสนอในการประมูลในเบราว์เซอร์จะอยู่ในหน่วย CPM ของสกุลเงินราคาเสนอที่เลือก

ต้องระบุสกุลเงินราคาเสนอทั้งในการตอบกลับราคาเสนอตามบริบทและใน ค่าที่ส่งคืนของ generateBid และต้องเป็นรหัสตัวอักษร ISO 4217 ที่ถูกต้อง เช่น "USD", "EUR" หรือ "JPY"

ใน OpenRTB ให้ใช้ช่อง cur ใหม่ในออบเจ็กต์ InterestGroupBuyer ใน ส่วนขยายการตอบกลับการเสนอราคาของ Google

เช่น

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

ในโปรโตคอล RTB ของ Google ให้ใช้ฟิลด์ currency ใหม่ในข้อความ InterestGroupBuyer ในการตอบกลับคำขอเสนอราคา

เช่น

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

ฟังก์ชัน generateBid ของผู้เสนอราคาต้องแสดงราคาเสนอในสกุลเงินเดียวกับที่ระบุในคำตอบการเสนอราคาตามบริบท กรอกข้อมูลพร็อพเพอร์ตี้ bidCurrency ใหม่ใน ค่าที่ส่งคืนของ generateBid

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

หากสกุลเงินจากการเสนอราคาตอบตามบริบทแตกต่างจากสกุลเงินที่ generateBid แสดงผล หรือหากสกุลเงินใดสกุลเงินหนึ่งไม่ถูกต้อง ระบบจะกรองราคาเสนอออกก่อนการประมูล

การตรวจสอบคุณภาพโฆษณา

การบังคับใช้นโยบายครีเอทีฟโฆษณาและการควบคุมของผู้เผยแพร่โฆษณาอาจเข้มงวดมากขึ้นสำหรับ ราคาเสนอตามกลุ่มความสนใจในเบราว์เซอร์ระหว่างการทดสอบ Protected Audience API สำหรับพาร์ทเนอร์ RTB

การสนับสนุนกฎหมายบริการดิจิทัล

เนื่องจากมาตราที่ 26 ของกฎหมายบริการดิจิทัล ผู้เผยแพร่โฆษณาอาจกำหนดให้ผู้ซื้อแสดงการเปิดเผยความโปร่งใสในโฆษณา เมื่อผู้เผยแพร่โฆษณาเปิดใช้การควบคุม "ขอให้ผู้ซื้อแสดงเฉพาะโฆษณาที่มีข้อมูลความโปร่งใสตาม DSA ในเว็บไซต์หรือแอปของฉันใน EEA" ผู้ซื้อกลุ่มความสนใจจะระบุได้ว่าโอกาสใดที่ตนจะต้องแสดงความโปร่งใสของผู้ซื้อโดยสังเกตค่าของ BidRequest.regs.dsa.required และ BidRequest.dsa.pubrender ในคำขอราคาเสนอ (BidRequest.dsa.dsa_support และ BidRequest.dsa.publisher_rendering_support ตามลำดับในโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว)

เมื่อผู้เสนอราคาที่ต้องการเข้าร่วมการประมูล Protected Audience API ได้รับสัญญาณในคำขอราคาเสนอว่าต้องแสดงความโปร่งใสตาม DSA สำหรับ โฆษณาที่แสดงผ่าน Protected Audience API ผู้เสนอราคาควรประเมินว่า สามารถแสดงข้อมูลที่จำเป็นได้อย่างเหมาะสมหรือไม่ และระบุโดยการตั้งค่า BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render ใน โปรโตคอล Google RTB ที่เลิกใช้งานแล้ว) ไม่เช่นนั้นผู้ซื้อจะไม่รวมอยู่ ในการประมูลที่ใช้ Protected Audience API

ดูข้อมูลเพิ่มเติมเกี่ยวกับความโปร่งใสของโฆษณาตามกฎหมายว่าด้วยบริการดิจิทัลได้ที่ บทความในศูนย์ช่วยเหลือ: การสนับสนุนกฎหมายว่าด้วยบริการดิจิทัล

การกรองราคาเสนอ

Google บังคับใช้การควบคุมของผู้เผยแพร่โฆษณาและนโยบายโฆษณา ระหว่างการประมูลในอุปกรณ์

หลังการประมูลในเบราว์เซอร์

รายงานผลการประมูลต่อผู้ซื้อ: reportWin()

Google จะไม่ป้อนอาร์กิวเมนต์ต่อไปนี้

• auctionSignals
• sellerSignals

ใช้ reportWin() เพื่อรายงานผลการประมูลต่อผู้ซื้อ

ดูข้อมูลเพิ่มเติมได้ที่ส่วนการรายงานของผู้ซื้อเกี่ยวกับการแสดงผลและเหตุการณ์โฆษณา ของคำอธิบาย Protected Audience API

มาโคร

หมายเหตุ: มาโครมีไว้เพื่อใช้ในการทดสอบ Protected Audience API และ อาจไม่รองรับในอนาคต

renderUrl ที่อ้างอิงถึงครีเอทีฟโฆษณา Protected Audience API อาจมีตัวยึดตำแหน่งอย่างน้อย 1 รายการที่เรียกว่ามาโคร หลังจากที่การประมูลกลุ่มความสนใจ สิ้นสุดลง แต่ก่อนที่จะแสดงผล ระบบจะแทนที่มาโครด้วยค่าที่เกี่ยวข้อง renderUrl ที่ใช้ในการประมูลในอุปกรณ์อาจมีมาโครต่อไปนี้

${GDPR}	ขยายเป็น 0 หาก GDPR ไม่มีผล หรือ 1 หาก GDPR มีผล ดูเอกสารประกอบ
${GDPR_CONSENT_XXXX}	ขยายเป็นสตริงความโปร่งใส และความยินยอม (TC) ที่เชื่อมโยงกับคําขอ หากสตริงความโปร่งใสและความยินยอม (TC) เว้นว่างไว้หรือไม่ถูกต้อง มาโครนี้จะไม่ขยาย ใช้มาโครนี้เพื่อส่งสตริง TC ไปยังผู้ให้บริการที่ลงทะเบียน GVL ของ IAB ใน URL แทนที่ XXXX ด้วยรหัส IAB GVL ของผู้ให้บริการที่ลงทะเบียน IAB GVL หากสตริง TC เว้นว่างไว้หรือไม่ถูกต้อง มาโครนี้จะไม่ขยาย ชิ้นงานโฆษณาที่ใช้มาโคร ${GDPR_CONSENT_XXXX} อาจถูกบล็อกหากผู้ให้บริการที่ลงทะเบียนใน GVL ของ IAB ซึ่งเชื่อมโยงกับรหัส GVL ของ IAB ที่คุณป้อนไม่ได้รับความยินยอมจากผู้ใช้ มาโคร ${GDPR_CONSENT_XXXX} ควรปรากฏใน renderUrl เพียงครั้งเดียว
${ADDL_CONSENT}	ขยายเป็นสตริงความยินยอมเพิ่มเติม (AC) ที่เชื่อมโยงกับคําขอ
${AD_WIDTH}, ${AD_HEIGHT)	มาโครเหล่านี้จะแทรกความกว้างและความสูงของช่องโฆษณา
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}	มาโครที่มีสัญญาณของผู้ซื้อในเวลาแสดงผล ที่ระบุในการเสนอราคาตอบ แทนที่ตัวยึดตำแหน่ง buyer.origin.example ด้วยต้นทาง ของผู้ซื้อกลุ่มความสนใจ ซึ่งควรสอดคล้องกับ interest_group_buyers.origin ในการเสนอราคาตอบ คุณอาจ ใส่ _OPTIONAL_SUFFIX เพื่อระบุค่าสัญญาณการแสดงผลที่แตกต่างกันได้สูงสุด 3 ค่า

การนับการแสดงผล

ในระหว่างการทดสอบ Protected Audience API กับพาร์ทเนอร์ RTB ทาง Google จะนับ การแสดงผลเมื่อเบราว์เซอร์เรียกใช้ฟังก์ชัน reportResult() และ ต่อมาจะดึงข้อมูล URL การรายงานของ Google ในการเรียกใช้ sendReportTo()

เนื่องจากเหตุการณ์ที่ Google ใช้เพื่อนับการแสดงผลในการประมูล Protected Audience ในเบราว์เซอร์อาจแตกต่างจากเหตุการณ์ที่พาร์ทเนอร์ผู้ซื้อ RTB ใช้เพื่อนับการแสดงผล จํานวนการแสดงผลจึงอาจแตกต่างกัน

เป้าหมายอย่างหนึ่งของ Google ในการทดสอบ Protected Audience API คือการระบุและ ลดความคลาดเคลื่อนเหล่านี้

การระบุแหล่งที่มาของการแสดงผลที่เรียกเก็บเงินได้

ระบบจะให้เครดิตการใช้จ่ายทั้งหมดของผู้เสนอราคาจากการประมูลในเบราว์เซอร์ของ Protected Audience แก่บัญชีผู้เสนอราคารายเดียวตามการแมปจากต้นทางของเจ้าของกลุ่ม ตามความสนใจที่กำหนดค่าไว้สำหรับผู้เสนอราคา ระบบไม่รองรับการระบุแหล่งที่มาของการใช้จ่ายไปยังบัญชีย่อยต่างๆ ของผู้เสนอราคา

งบประมาณสูงสุดรายวัน

ในระหว่างการทดสอบ Protected Audience API แต่ละบัญชีจะมีงบประมาณรายวันสูงสุดสำหรับการใช้จ่าย Protected Audience ระดับบัญชี งบประมาณรายวันสูงสุดจะจำกัดความเสี่ยง ในสภาพแวดล้อมการประมูลในเบราว์เซอร์ เมื่อถึงขีดจํากัดงบประมาณรายวันแล้ว บัญชีจะไม่ได้รับคําขอราคาเสนอที่มีสิทธิ์สำหรับ Protected Audience อีกต่อไป

บัญชีจะเข้าร่วมการประมูลตามบริบทฝั่งเซิร์ฟเวอร์ต่อไปได้หลังจาก ถึงขีดจํากัดของ Protected Audience เช่น บัญชีผู้เสนอราคาที่ถึง ขีดจํากัดของ Protected Audience อาจได้รับคําขอเสนอราคาที่มี auction_environment = SERVER_SIDE_AUCTION (OpenRTB JSON: 0) แม้ว่าคําขอเสนอราคาจะมีสิทธิ์ สําหรับการประมูล Protected Audience ก็ตาม

ความคิดเห็นแบบเรียลไทม์และราคาเสนอขั้นต่ำที่จะชนะ

ผู้เสนอราคาที่เลือกรับ ความคิดเห็นแบบเรียลไทม์ จะได้รับความคิดเห็นสำหรับผู้ซื้อกลุ่มความสนใจที่ขอรวมไว้ในการประมูล Protected Audience API บนอุปกรณ์ ผู้ซื้อกลุ่มความสนใจแต่ละรายที่ผู้เสนอราคา ระบุในการเสนอราคาตอบจะได้รับออบเจ็กต์ความคิดเห็น 1 รายการ ไม่ว่าผู้ซื้อกลุ่มความสนใจจะเสนอราคาในการประมูล Protected Audience กี่ครั้งก็ตาม ข้อมูลต่อไปนี้จะพร้อมใช้งานในออบเจ็กต์ความคิดเห็นของผู้ซื้อกลุ่มความสนใจ

• ประเภทความคิดเห็นของออบเจ็กต์ความคิดเห็นจะเป็น INTEREST_GROUP_BUYER_FEEDBACK
• ต้นทางของผู้ซื้อกลุ่มความสนใจ
• ราคาเสนอขั้นต่ำที่จะชนะสำหรับผู้ซื้อกลุ่มความสนใจเพื่อให้ชนะการประมูลโดยรวม
• ราคาเสนอขั้นต่ำที่จะชนะสำหรับผู้ซื้อกลุ่มความสนใจเพื่อเอาชนะ ราคาเสนอที่มีอันดับสูงสุดจากคอมโพเนนต์ฝั่งเซิร์ฟเวอร์ของการประมูลโดยรวม
• รหัสสถานะของผู้ซื้อกลุ่มความสนใจ รหัสสถานะที่เป็นไปได้จะกําหนดไว้ใน interest-group-buyer-status-codes.txt

ดูชื่อฟิลด์ที่เฉพาะเจาะจงได้ในเอกสารประกอบโปรโตคอลสำหรับ RTB ของ Authorized Buyers และส่วนขยาย OpenRTB

การแจ้งเตือนความคิดเห็นเกี่ยวกับราคาเสนอ

Chrome มี API การแก้ไขข้อบกพร่องชั่วคราว สำหรับ Protected Audience API ซึ่งช่วยให้ Ad Manager ส่งการแจ้งเตือนการแก้ไขข้อบกพร่องแบบเรียลไทม์ แบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ที่มีความคิดเห็นเกี่ยวกับการเสนอราคาของ Protected Audience ได้ การแจ้งเตือนนี้จะมีเหตุผลที่อาจทำให้มีการกรองราคาเสนอใน การประมูลในเบราว์เซอร์ที่ใช้ Protected Audience API นอกเหนือจาก ข้อมูลอื่นๆ เกี่ยวกับราคาเสนอตามที่อธิบายไว้ด้านล่าง

ผู้เสนอราคาสามารถติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อกำหนดค่า URL แบบคงที่ที่จะใช้ในการแสดงการแจ้งเตือนความคิดเห็นเกี่ยวกับการเสนอราคาสำหรับการแก้ไขข้อบกพร่องของ Protected Audience ระบบจะดึงข้อมูล URL แบบคงที่นี้จากเซิร์ฟเวอร์ของ Google โดยจะแทนที่มาโครที่เลือก หลังจากที่การประมูลที่ใช้ Protected Audience API เสร็จสมบูรณ์ ระบบรองรับมาโครต่อไปนี้

• %%GOOGLE_QUERY_ID%%: มาโครนี้จะถูกแทนที่ด้วยรหัสคำค้นหาของ Google ที่ส่งในคำขอราคาเสนอตามบริบทที่เปิดใช้ Protected Audience ในโปรโตคอล OpenRTB จะมีการระบุด้วย BidRequest.ext.google_query_id ส่วนโปรโตคอล RTB ของ Google ที่เลิกใช้งานแล้วจะใช้ BidRequest.google_query_id
• %%INTEREST_GROUP_OWNER%%: ต้นทางของเจ้าของกลุ่มเป้าหมายตามความสนใจ
• %%BID_CPM%%: ราคาเสนอใน CPM ที่ผู้ซื้อระบุในฟังก์ชัน generateBid()
• %%RENDER_URL%%: URL การแสดงผลของครีเอทีฟโฆษณา
• %%STATUS%%: รหัสสถานะหากมีการปฏิเสธราคาเสนอภายใน scoreAd() ค่าคือรหัสสถานะครีเอทีฟโฆษณา

ต่อไปนี้คือตัวอย่าง URL แบบคงที่ที่ผู้เสนอราคาอาจให้แก่ผู้จัดการฝ่ายดูแลลูกค้า

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

การแจ้งเตือนความคิดเห็นเกี่ยวกับราคาเสนอเป็นฟีเจอร์ชั่วคราวที่ขึ้นอยู่กับ ForDebuggingOnlyAPI ชั่วคราวของ Chrome

TURTLEDOVE ระดับผลิตภัณฑ์

โฆษณาที่ประกอบด้วยหลายชิ้น หรือ TURTLEDOVE ระดับผลิตภัณฑ์ (PLTD) ได้รับการรองรับสำหรับพาร์ทเนอร์ RTB ของ Google ในระหว่างการทดสอบ Protected Audience API โปรดแจ้งผู้จัดการฝ่ายดูแลลูกค้าในระหว่างการผสานรวมหากคุณวางแผนที่จะทดสอบ PLTD เนื่องจากต้องใช้ทรัพยากรและการกำหนดค่าเพิ่มเติม

การเริ่มต้นใช้งาน

วิธีทดสอบ Protected Audience API มีดังนี้

ขั้นตอน

1. กรอกแบบฟอร์มคำขอ เพื่อเข้าร่วมการทดสอบ Protected Audience API
2. หลังจากส่งแบบฟอร์มคำขอแล้ว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหรือส่ง คำขอโดยใช้ศูนย์ช่วยเหลือ Authorized Buyer
3. เมื่อกำหนดค่าบัญชีแล้ว ทั้ง Google และพาร์ทเนอร์จะยืนยันการผสานรวมได้โดยทำตามขั้นตอนในขั้นตอนการทดสอบ

การตรวจสอบครีเอทีฟโฆษณา

หากต้องการเสนอราคาด้วยโฆษณาระดับผลิตภัณฑ์ (โฆษณาที่ประกอบด้วยหลายชิ้น) ในการประมูล Protected Audience API ให้ทำตามข้อกำหนดต่อไปนี้

• ใส่พารามิเตอร์การค้นหา &pltd=True ใน renderUrl สำหรับ คอนเทนเนอร์ของโฆษณาคอมโพเนนต์ (เรียกอีกอย่างว่า renderUrl ระดับบนสุด) เพื่อ แยกความแตกต่างของ renderUrls ระดับบนสุดในระหว่างการตรวจสอบครีเอทีฟโฆษณา
• แสดงครีเอทีฟโฆษณาที่เป็นตัวแทนเมื่อระบบดึงข้อมูลคอนเทนเนอร์ของโฆษณาที่เป็นคอมโพเนนต์ เพื่อการตรวจสอบครีเอทีฟโฆษณาโดย Google หากต้องการทราบว่าเมื่อใดที่ควรแสดงโฆษณาที่เป็นตัวแทน คุณสามารถดูพารามิเตอร์การค้นหา validation=True ที่ตั้งค่าโดยระบบตรวจสอบครีเอทีฟโฆษณาของ Google

รายการตรวจสอบการผสานรวม

• ตั้งค่าปลายทางคำขอราคาเสนอที่จะป้อนข้อมูลฟิลด์ที่เกี่ยวข้องกับ Protected Audience API ในการตอบกลับราคาเสนอตามบริบท เช่น interest_group_bidding
• ติดตั้งใช้งานการติดแท็กในหน้าของผู้ลงโฆษณาเพื่อเข้าร่วมเบราว์เซอร์ของผู้ใช้กับ กลุ่มความสนใจ
• ใช้ generateBid() และ reportWin()
• เลือกแหล่งที่มาของเจ้าของกลุ่มความสนใจ แล้วเพิ่มลงในบัญชี Authorized Buyers
  • ต้นทางของเจ้าของกลุ่มความสนใจควรตรงกับต้นทางที่โฮสต์ฟังก์ชัน generateBid()
  • โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหรือส่งคำขอโดยใช้ศูนย์ช่วยเหลือสำหรับผู้ซื้อที่ได้รับอนุญาตเพื่อทำขั้นตอนนี้ให้เสร็จสมบูรณ์
• ตั้งค่าการกำหนดเป้าหมายล่วงหน้าสำหรับพื้นที่โฆษณาที่เกี่ยวข้องกับ การทดสอบ Protected Audience API
• ส่งครีเอทีฟโฆษณาเพื่อรับการตรวจสอบและอนุมัติผ่าน API ของครีเอทีฟโฆษณา
• (ไม่บังคับ) ตั้งค่าปลายทางของสัญญาณการเสนอราคาที่เชื่อถือได้
• (ไม่บังคับ) สร้างหน้าผู้ลงโฆษณาทดสอบที่ช่วยให้วิศวกรของ Google เพิ่ม เบราว์เซอร์ของตนลงในกลุ่มความสนใจที่ผู้ซื้อกลุ่มความสนใจของคุณเป็นเจ้าของ ต้นทาง ซึ่งช่วยให้เราเรียกใช้การประมูลที่ใช้ Protected Audience API ได้ด้วยตนเอง
• (ไม่บังคับ) เปิดใช้ความคิดเห็นแบบเรียลไทม์ในบัญชีเพื่อรับความคิดเห็นสำหรับ ผู้ซื้อกลุ่มความสนใจที่ขอให้รวมไว้ในการประมูล Protected Audience API
• (ไม่บังคับ) ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อกำหนดค่า URL แบบคงที่เพื่อรับการแจ้งเตือนแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ซึ่งให้ความคิดเห็นเกี่ยวกับราคาเสนอของ Protected Audience สำหรับสถานะของราคาเสนอจากการประมูล Protected Audience บนอุปกรณ์เพื่อช่วยในการแก้ไขข้อบกพร่องของปัญหาที่ไม่คาดคิด ดูรายละเอียดได้ที่การแจ้งเตือนความคิดเห็นเกี่ยวกับราคาเสนอ

ขั้นตอนการทดสอบ

ขั้นตอนที่ 1: การทดสอบด้วยตนเอง

วิธีเรียกใช้การประมูลที่ใช้ Protected Audience API ด้วยตนเอง ตรวจสอบว่าโฆษณาสามารถ แสดงผลได้ และบันทึกการแสดงผลมีดังนี้

1. ใช้ Chrome 101 ขึ้นไป
2. เปิดใช้ Privacy Sandbox API และ Fenced Frame โดยใช้ chrome://flags/#privacy-sandbox-ads-apis และ chrome://flags/#enable-fenced-frames ดูข้อมูลเพิ่มเติมได้ที่ทดสอบ Privacy Sandbox
3. ส่งครีเอทีฟโฆษณาเพื่อขออนุมัติโดยใช้ Real-time Bidding API
4. ใช้หน้าผู้ลงโฆษณาที่ผู้เสนอราคาให้เพื่อเพิ่มเบราว์เซอร์ลงในกลุ่มความสนใจที่ผู้เสนอราคาเป็นเจ้าของ

5. ใช้หน้าผู้เผยแพร่โฆษณาทดสอบที่ Google จัดเตรียมให้ต่อไปนี้เพื่อทริกเกอร์การประมูลที่ใช้ Protected Audience API

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

   กลุ่มความสนใจในเบราว์เซอร์ต้องเสนอราคาให้สูงพอที่จะชนะการประมูล เนื่องจากอาจต้องแข่งขันกับราคาเสนอฝั่งเซิร์ฟเวอร์แบบเดิม นอกจากนี้ Google ยังมี หน้าผู้เผยแพร่โฆษณาทดสอบเฉพาะสำหรับพาร์ทเนอร์แต่ละราย ซึ่งมีเพียงพาร์ทเนอร์รายนั้นๆ เท่านั้นที่เข้าร่วมการประมูลได้ การชนะการประมูลในเบราว์เซอร์ในหน้าของพาร์ทเนอร์อาจง่ายกว่าและเชื่อถือได้มากกว่า

6. โปรดตรวจสอบสิ่งต่อไปนี้

   1. ระบบจะแสดงผลโฆษณาที่คาดว่าจะชนะ
   2. ระบบจะส่งผลการประมูลฝั่งเซิร์ฟเวอร์ ซึ่งหมายความว่าผู้เสนอราคาที่ชนะ จะได้รับการแจ้งกลับจาก reportWin()
   3. คอนโซลหน้าผู้เผยแพร่โฆษณาทดสอบจะบันทึกข้อความแก้ไขข้อบกพร่องสําหรับการเสนอราคาแต่ละรายการพร้อมข้อมูลต่อไปนี้
      • renderUrl: URL การแสดงผลของราคาเสนอ
      • interestGroupOwner: เจ้าของกลุ่มความสนใจของราคาเสนอ
      • accepted: ฟิลด์นี้จะเป็น true หากได้รับการยอมรับการเสนอราคา และ false หาก scoreAd() ปฏิเสธการเสนอราคา
      • externalBidStatus: รหัสสถานะหากระบบปฏิเสธราคาเสนอภายใน scoreAd() ค่าคือรหัสสถานะครีเอทีฟโฆษณา

ระยะที่ 2: (ไม่บังคับ) การทดสอบที่ไม่แสดงผล

หลังจาก Google และพาร์ทเนอร์ได้ยืนยันด้วยตนเองว่าพาร์ทเนอร์สามารถ เข้าร่วมการประมูล Protected Audience API ได้แล้ว Google จะเปิดใช้พาร์ทเนอร์สำหรับ การทดสอบในระยะถัดไป

Google จัดสรรการเข้าชมแบบเรียลไทม์จำนวนเล็กน้อยเพื่อเรียกใช้การประมูล Protected Audience จากนั้น Google และพาร์ทเนอร์ก็ไม่จำเป็นต้องทริกเกอร์การประมูล Protected Audience ด้วยตนเองอีกต่อไป ระบบจะไม่แสดงผลลัพธ์ของการประมูลที่ใช้ Protected Audience API ซึ่งจะช่วยให้เราทดสอบการผสานรวมได้ในวงกว้าง

โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหรือส่งคำขอผ่านศูนย์ช่วยเหลือของ Authorized Buyers เมื่อคุณพร้อม Google จะเปิดใช้บัญชีสำหรับขั้นตอนนี้

ขั้นตอนที่ 3: การทดสอบการแสดงผล

เมื่อ Google และพาร์ทเนอร์ยืนยันการประมูล Protected Audience ที่ปรับขนาดได้ โดยไม่ต้องแสดงผลแล้ว Google จะอนุญาตให้พาร์ทเนอร์แสดงผลโฆษณาที่ชนะของ Protected Audience Google มีการเข้าชมจำนวนเล็กน้อยที่การประมูล Protected Audience มีสิทธิ์ทํางาน และโฆษณากลุ่มความสนใจที่ชนะจะได้รับการ แสดง ราคาเสนอในเบราว์เซอร์ของผู้เสนอราคาที่เข้าร่วมจะแข่งขันกับราคาเสนอแบบเดิม

โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหรือส่งคำขอผ่านศูนย์ช่วยเหลือของ Authorized Buyers เมื่อคุณพร้อม Google จะเปิดใช้บัญชีสำหรับขั้นตอนนี้

ฟีเจอร์เพิ่มเติม

ฟีเจอร์ต่อไปนี้เป็นส่วนขยายของโปรโตคอลหลัก

การโหลดพร้อมกัน

การประมวลผลแบบขนานเป็นการเพิ่มประสิทธิภาพที่ช่วยลดเวลาในการตอบสนองของการประมูลตั้งแต่ต้นจนจบโดยการ เริ่มคำขอโฆษณาตามบริบทพร้อมกับคำขอไปยังเซิร์ฟเวอร์ที่เชื่อถือได้ของผู้ซื้อ ที่ระบุไว้ใน trustedBiddingSignalsUrl

การประมวลผลแบบคู่ขนานช่วยลดเวลาในการตอบสนอง แต่จะส่งผลต่อการมีสิทธิ์ของผู้ซื้อกลุ่มความสนใจและรองรับการทดสอบที่ประสานกัน การประมวลผลแบบขนานมีผลกับผู้เสนอราคาทุกรายที่เข้าร่วม การประมูลกลุ่มความสนใจในอุปกรณ์ ผู้เสนอราคาไม่จำเป็นต้องดำเนินการใดๆ เพื่อ เข้าร่วมการประมูลแบบคู่ขนาน แต่ควรทำความคุ้นเคยกับ วิธีที่การประมวลผลแบบคู่ขนานอาจส่งผลต่อการมีสิทธิ์ในการประมูลบนอุปกรณ์ ระบบยังไม่รองรับรหัสกลุ่มการทดสอบสำหรับการทดสอบที่ประสานงานกัน ในการประมูลแบบคู่ขนาน

สรุปขั้นตอนการแสดงโฆษณา

สรุปขั้นตอนการประมูลแบบคู่มีดังนี้

การมีสิทธิ์ของผู้ซื้อกลุ่มความสนใจในอุปกรณ์

สําหรับการประมูลแบบคู่ การเรียกของ navigator.runAdAuction จะเกิดขึ้นก่อน ที่จะมีการส่งคืนการตอบกลับโฆษณาตามบริบท หากต้องการเริ่มการเรียกเซิร์ฟเวอร์ที่เชื่อถือได้ของผู้ซื้อ navigator.runAdAuction กำหนดให้ต้องส่งพารามิเตอร์ interestGroupBuyers เป็นค่า ส่วนพารามิเตอร์การประมูลที่เหลือจะยอมรับ Javascript Promises ที่สามารถแก้ไขได้หลังจากได้รับการตอบกลับโฆษณาตามบริบท เนื่องจาก interestGroupBuyers จะส่งก่อนการตอบกลับโฆษณาตามบริบท จึงไม่สามารถใช้การตอบกลับโฆษณาตามบริบท (รวมถึงการเสนอราคาตอบ) เพื่อเลือกผู้ซื้อที่จะเข้าร่วมการประมูลแบบคู่ขนาน สำหรับคำขอที่ระบุ แต่แท็กผู้เผยแพร่โฆษณาของ Google จะแคชพารามิเตอร์ interestGroupBuyers จากการดำเนินการก่อนหน้าnavigator.runAdAuctionในโดเมนเดียวกันไว้ในเบราว์เซอร์ของผู้ใช้

การประมวลผลแบบขนานมีข้อควรพิจารณาที่สำคัญหลายประการดังนี้

1. สัญญาณการประมูลที่ไม่จำเป็นสำหรับคำขอเซิร์ฟเวอร์ที่เชื่อถือได้ของผู้ซื้อ เช่น perBuyerSignals จะยังคงระบุในการเสนอราคา RTB ตอบกลับได้ ในลักษณะเดียวกับการประมูลที่ไม่ใช่แบบคู่ขนาน เมื่อ Promise สำหรับสัญญาณเหล่านี้ได้รับการแก้ไขแล้ว ขั้นตอนที่เหลือของการประมูลบนอุปกรณ์จะเสร็จสมบูรณ์ในลักษณะเดียวกับขั้นตอนการประมูลแบบไม่ขนาน

2. เนื่องจากการประมวลผลแบบขนานอาศัยการแคชรายชื่อผู้ซื้อกลุ่มความสนใจ Google จึงไม่ได้เรียกใช้การประมูลแบบขนานเสมอไป เนื่องจากแคชการประมวลผลแบบขนาน อาจว่างเปล่าหรือหมดอายุ หากแคชว่างเปล่าหรือหมดอายุ Google จะเรียกใช้การประมูล Protected Audience API แบบมาตรฐานที่ไม่ขนานกัน และใช้ความตั้งใจของผู้ซื้อเพื่อ เข้าร่วมการประมูลที่ไม่ขนานกันเพื่อสร้างแคชผู้ซื้อกลุ่มความสนใจ

3. หากมีการแคชผู้ซื้ออย่างน้อย 1 รายสำหรับผู้เสนอราคาใดก็ตามสำหรับโดเมนผู้เผยแพร่โฆษณาปัจจุบัน Google จะเรียกใช้การประมูลแบบคู่ขนาน ซึ่งจะระบุไว้ในคำขอเสนอราคา

   • โปรโตคอล RTB ของ Google: BidRequest.adslot.interest_group_auction.parallelized
   • OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized

4. ต้นทางผู้ซื้อกลุ่มความสนใจที่ลงทะเบียนแต่ละรายการสำหรับผู้เสนอราคาที่ระบุซึ่งรวมอยู่ในการประมูลแบบคู่ขนานจะมีรายการParallelAuctionBuyerที่สอดคล้องกัน

   • โปรโตคอล RTB ของ Google: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
   • OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer

5. หากมีการประมูลแบบคู่ขนาน แต่ไม่มีแหล่งที่มาของผู้ซื้อที่เฉพาะเจาะจงใน แคช ระบบจะเพิ่มผู้ซื้อรายนั้นในการประมูลบนอุปกรณ์ปัจจุบันไม่ได้ ซึ่งระบุได้จากคำขอที่มี parallelized=True ซึ่งไม่มีรายการ ParallelAuctionBuyer สำหรับต้นทางของผู้ซื้อกลุ่มความสนใจที่ระบุ อย่างไรก็ตาม ผู้เสนอราคาที่ระบุความสนใจโดยการใส่ InterestGroupBuyer(s) ที่ถูกต้องและมีสิทธิ์ในการเสนอราคาตอบ จะมีการเพิ่มต้นทางของผู้ซื้อกลุ่มความสนใจที่เกี่ยวข้องลงในแคช และต้นทางเหล่านั้นจะมีสิทธิ์สำหรับ คำขอแบบขนานในอนาคตจากเบราว์เซอร์และโดเมนเดียวกัน ความตั้งใจที่จะเข้าร่วมการประมูลกลุ่มตามความสนใจ สามารถระบุได้ในช่องต่อไปนี้

   • โปรโตคอล RTB ของ Google: BidResponse.adslot.interest_group_bidding.interest_group_buyers
   • OpenRTB: BidResponse.ext.igbid.igbuyer

6. ต้นทางของผู้ซื้อที่แคชไว้ (ซึ่งรวมอยู่ในพารามิเตอร์ interestGroupBuyers ของการประมูลแบบคู่ขนาน) ซึ่งผู้เสนอราคาไม่ได้ระบุความตั้งใจที่จะเข้าร่วมในการเสนอราคาตอบอาจได้รับการเรียกเซิร์ฟเวอร์ที่เชื่อถือได้ของผู้ซื้อ แต่จะไม่เข้าร่วมในการประมูลแบบคู่ขนาน