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 ที่สนใจการทดสอบควรดูรายละเอียดในส่วนการเริ่มต้นใช้งาน

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

นี่คือสรุปขั้นตอนการแสดงโฆษณาของ 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 และอยู่ในช่องที่เลิกใช้งานแล้ว โปรโตคอล RTB ของ Google ซึ่งระบุด้วย 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 จะส่งสัญญาณเฉพาะผู้ซื้อที่ไม่บังคับของผู้เสนอราคาที่มีสิทธิ์แต่ละรายไปยังการกำหนดค่าการประมูลกลุ่มเป้าหมายที่ได้รับการคุ้มครอง
  12. หากกลุ่มความสนใจของผู้เสนอราคาที่ระบุ trustedBiddingSignalsUrl เบราว์เซอร์จะส่งคำขอไปยัง trustedBiddingSignalsUrlเพื่อดึงข้อมูลสัญญาณแบบเรียลไทม์ของแต่ละกลุ่ม ดูรายละเอียดในข้อกําหนดของ Protected Audience API
  13. เบราว์เซอร์จะเรียกใช้ generateBid() ของผู้เสนอราคาสําหรับกลุ่มความสนใจแต่ละกลุ่มที่เลือกใช้และมีสิทธิ์เข้าร่วมการประมูลในเบราว์เซอร์ ขั้นตอนนี้จะคํานวณราคาเสนอและเลือกครีเอทีฟโฆษณา generateBid() มีสิทธิ์เข้าถึงสัญญาณผู้ซื้อที่ไม่บังคับซึ่งผู้เสนอราคาระบุไว้และสัญญาณการเสนอราคาที่เชื่อถือได้สําหรับกลุ่มความสนใจที่ระบุ
  14. เบราว์เซอร์จะเรียก scoreAd() ของผู้ขาย (ในกรณีนี้คือ Google) กำหนดอันดับให้กับราคาเสนอแต่ละรายการในการประมูลเพื่อแสดงโฆษณาตามกลุ่มความสนใจ ระบบจะจัดอันดับราคาเสนอ และกรองตามการป้องกันผู้เผยแพร่โฆษณา นโยบายโฆษณา และอื่นๆ ข้อจำกัด
  15. เบราว์เซอร์ทำการประมูลโดยใช้การเสนอราคาตามกลุ่มความสนใจที่มีสิทธิ์ ราคาเสนอตามบริบทที่อยู่ในลำดับต้นๆ จะเข้าร่วมในการประมูลในเบราว์เซอร์
  16. หลังการประมูล หากมีผู้ชนะกลุ่มความสนใจ เบราว์เซอร์จะเรียก reportResult() ของผู้ขายและ reportWin() ของผู้เสนอราคาเพื่อแจ้ง บุคคลที่เกี่ยวกับผู้ชนะการประมูลในเบราว์เซอร์
  17. หากโฆษณากลุ่มความสนใจชนะ แท็กผู้เผยแพร่โฆษณาของ Google จะแสดงผลโฆษณาใน iframe

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

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

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

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

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

  • renderUrl ที่ส่งผ่าน API ควรตรงกับ renderUrl ที่ใช้ ในการประมูลเพื่อแสดงโฆษณาตามกลุ่มความสนใจ
  • renderUrl แต่ละรายการแสดงถึงผู้ลงโฆษณาหรือแคมเปญการโฆษณาได้เพียงรายการเดียวเท่านั้น renderUrl หนึ่งๆ ใช้เพื่อแสดงโฆษณาในนามของผู้ลงโฆษณาหลายรายไม่ได้ renderUrl แต่ละรายการต้องแมปกับครีเอทีฟโฆษณารายการเดียว
  • 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:
    • BidRequest.imp.ext.ae
    • BidRequest.imp.ext.igbid
  • โปรโตคอล RTB ของ Google (เลิกใช้งานแล้ว):
    • BidRequest.adslot.supported_auction_environment
    • BidRequest.adslot.interest_group_bidding_allowed

คุณสามารถใช้ฟิลด์นี้เพื่อแยกความแตกต่างระหว่างโอกาสในการแสดงผลที่ รองรับการประมูลตามกลุ่มความสนใจในเบราว์เซอร์ Protected Audience และโฆษณา รองรับเฉพาะการประมูล Exchange ฝั่งเซิร์ฟเวอร์แบบเดิมเท่านั้น 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

คำขอราคาเสนอมีช่องต่อไปนี้เพื่อให้คุณมี ขนาดช่องโฆษณาของกลุ่มเป้าหมาย:

  • 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

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

ขนาดนี้อาจแตกต่างจากขนาดในคําขอตามบริบท เช่น ขนาดที่เห็นในช่อง 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 การดำเนินการนี้มีไว้เพื่อประเมินผลกระทบที่อาจเกิดขึ้นจากการเลิกใช้งานคุกกี้ของบุคคลที่สาม

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

เว็บไซต์และผู้ให้บริการสามารถใช้การทดสอบที่อำนวยความสะดวกโดย 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
  • Google RTB (เลิกใช้งานแล้ว): BidResponse.interest_group_bidding.per_buyer_signals
เผยแพร่สัญญาณการแสดงผลตามบริบทของผู้ซื้อ

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

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

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

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

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

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

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

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

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

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

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

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

  • 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 API

บัญชีย่อยมีรหัสการเรียกเก็บเงินได้สูงสุด 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};
}

โปรดดูข้อมูลจำเพาะของ Protected Audience ในอุปกรณ์ การเสนอราคา สำหรับคำอธิบายของฟังก์ชัน generateBid()

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

ราคาเสนอในการประมูลในเบราว์เซอร์จะอยู่ในหน่วย 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 Google Partners

การรองรับกฎหมายบริการดิจิทัล

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

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

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

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

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

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

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

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

  • auctionSignals
  • sellerSignals

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

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

มาโคร

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

${GDPR} ขยายเป็น 0 หาก GDPR ไม่มีผล หรือ 1 หาก GDPR มีผล โปรดดูเอกสารประกอบ
${GDPR_CONSENT_XXXX} ขยายไปสู่ความโปร่งใส &amp; สตริงความยินยอม (TC) ที่เชื่อมโยงกับคําขอ หากความโปร่งใสและ สตริงความยินยอม (TC) ว่างเปล่าหรือไม่ถูกต้อง มาโครนี้จะไม่ขยาย

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

ชิ้นงานโฆษณาที่ใช้มาโคร ${GDPR_CONSENT_XXXX} อาจถูกบล็อกหากผู้ให้บริการที่จดทะเบียนกับ IAB GVL ซึ่งเชื่อมโยงกับรหัส IAB GVL ที่คุณป้อนไม่ได้รับความยินยอมจากผู้ใช้

มาโคร ${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 ใช้นับการแสดงผลในการประมูลในเบราว์เซอร์ของกลุ่มเป้าหมายที่ได้รับการคุ้มครองอาจแตกต่างจากเหตุการณ์ที่ใช้ในการนับการแสดงผลโดยพาร์ทเนอร์ผู้ซื้อ 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 API

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

ผู้เสนอราคาที่เลือกรับ ความคิดเห็นแบบเรียลไทม์ จะได้รับความคิดเห็นสำหรับผู้ซื้อของกลุ่มความสนใจที่ได้รับการร้องขอให้รวมไว้ใน การประมูลที่ใช้ 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 นอกเหนือจากข้อมูลอื่นๆ เกี่ยวกับราคาเสนอที่อธิบายไว้ด้านล่าง

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

  • %%GOOGLE_QUERY_ID%%: มาโครนี้ถูกแทนที่ด้วยรหัสคำค้นหาของ Google ที่ส่งในคำขอราคาเสนอตามบริบทที่เปิดใช้ Protected Audience ใน โปรโตคอล OpenRTB ที่ระบุด้วย BidRequest.ext.google_query_id, ขณะที่ Google RTB ที่เลิกใช้ โปรโตคอลใช้ 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%%

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

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

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

การต้อนรับผู้เข้าร่วมโปรแกรม

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

ขั้นตอน

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

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

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

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

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

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

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

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

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

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

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

    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 และพาร์ทเนอร์ยืนยันด้วยตนเองว่าพาร์ทเนอร์สามารถเข้าร่วมการประมูลกลุ่มเป้าหมายที่ได้รับการคุ้มครองได้แล้ว Google จะเปิดใช้พาร์ทเนอร์สำหรับการทดสอบระยะถัดไป

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

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

ระยะที่ 3: การทดสอบการแสดงผล

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

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

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

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

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

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

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

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

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

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

สำหรับการประมูลพร้อมกัน การเรียกของ navigator.runAdAuction จะเกิดขึ้นก่อน การตอบกลับโฆษณาตามบริบทจะปรากฏ เพื่อเริ่มต้น "ผู้ซื้อได้รับการเชื่อถือ" เนื่องจาก navigator.runAdAuction กำหนดให้เซิร์ฟเวอร์ พารามิเตอร์ interestGroupBuyers ต้องเป็น ที่ถูกส่งผ่านเป็นค่า ในขณะที่พารามิเตอร์การประมูลที่เหลือจะยอมรับ JavaScript สัญญาที่แก้ไขได้หลังจากโฆษณาตามบริบทตอบกลับ ตั้งแต่ปี มีการส่ง 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 รายการในการเสนอราคาตอบ จะมีผู้ซื้อของกลุ่มความสนใจที่ตรงกัน ต้นทางที่เพิ่มลงในแคช และต้นทางเหล่านั้นจะมีสิทธิ์ คำขอที่โหลดพร้อมกันไว้ในอนาคตจากเบราว์เซอร์และโดเมนเดียวกัน คุณสามารถระบุความตั้งใจที่จะเข้าร่วมการประมูลของกลุ่มความสนใจในช่องต่อไปนี้

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

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