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

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

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

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

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

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

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

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

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

ผู้เสนอราคาสามารถใช้การเสนอราคาแบบเรียลไทม์ 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 วัน หากคุณส่งโฆษณาพร้อมกับ เรียลไทม์ Bidding API คุณจะต้องส่งครีเอทีฟโฆษณาอีกครั้งหลังจากผ่านไป 15 วัน หากคุณพึ่งพา สแกนครีเอทีฟโฆษณาอัตโนมัติ ขั้นตอนการสแกนจะสแกนครีเอทีฟโฆษณาซ้ำโดยอัตโนมัติ

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

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

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

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

buyer_reporting_id จะปรากฏเป็นมิติข้อมูลใหม่ใน "ให้สิทธิ์" เครื่องมือการรายงานของผู้ซื้อเป็นมิติข้อมูลรหัสการรายงานของผู้ซื้อ

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

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

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

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

คำขอราคาเสนอมีช่องใหม่คือ auction_environment

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

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

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

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

  • โปรโตคอล RTB ของ 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

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

ขนาดนี้อาจแตกต่างจากขนาดสำหรับคำขอตามบริบท (Adslot.widthและAdslot.height หรือใน OpenRTB: BidRequest.imp.banner.format)

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

ระบุความสามารถในการแสดงผลของโฆษณา Protected Audience

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

  • โปรโตคอล RTB ของ Google: BidRequest.adslot.interest_group_auction.render_interest_group_ads
  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
ลดการใช้ตัวระบุผู้ใช้

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

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

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

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

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

ต่อไปนี้เป็นช่องสำหรับดูป้ายกำกับ

  • โปรโตคอล RTB ของ Google: BidRequest.device.cookie_deprecation_label
  • OpenRTB: BidRequest.device.ext.cdep

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

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

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

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

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

เผยแพร่สัญญาณบริบทของผู้ซื้อ (perBuyerSignals)

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

  • Google RTB: BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
เผยแพร่สัญญาณการแสดงผลตามบริบทของผู้ซื้อ

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

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

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

  • Google RTB: BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig

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

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

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

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

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

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

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

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

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

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

  • โปรโตคอล RTB ของ Google: BidRequest.adslot.matching_ad_data.billing_id
  • OpenRTB: BidRequest.imp.ext.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.dsa.dsa_support และ BidRequest.dsa.publisher_rendering_support สำหรับโปรโตคอล Authorized Buyers ของ Google และ BidRequest.regs.dsa.required และ BidRequest.dsa.pubrender สำหรับโปรโตคอล OpenRTB

เมื่อผู้เสนอราคาที่ต้องการเข้าร่วมการประมูล Protected Audience API ได้รับสัญญาณในคำขอราคาเสนอว่าต้องแสดงความโปร่งใสตาม DSA โฆษณาที่แสดงผ่าน Protected Audience API โฆษณาควรประเมินว่า จะแสดงข้อมูลที่จำเป็นได้อย่างเหมาะสม และระบุโดยการตั้งค่า BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render สำหรับโปรโตคอล Authorized Buyers ของ Google หรือ BidResponse.ext.igbid.igbuyer.dsaadrenderสำหรับโปรโตคอล OpenRTB หรือไม่เช่นนั้น ผู้ซื้อจะไม่รวมอยู่ในการประมูล 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} ขยายไปสู่ความโปร่งใส และ สตริงความยินยอม (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 เพื่อระบุ ค่าสัญญาณการแสดงผล

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขั้นตอน

  1. กรอกแบบฟอร์มคำขอ เพื่อเข้าร่วมการทดสอบ Protected Audience API
  2. หลังจากส่งแบบฟอร์มคำขอแล้ว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าหรือไฟล์ของคุณ ตั๋วโดยใช้ความช่วยเหลือของ Authorized Buyers Center
  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 การประมูล
  • (ไม่บังคับ) ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อกำหนดค่า 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 ดูรายละเอียดเพิ่มเติมได้ที่การทดสอบความเป็นส่วนตัว แซนด์บ็อกซ์
  3. ส่งครีเอทีฟโฆษณาเพื่อขออนุมัติโดยใช้การเสนอราคาแบบเรียลไทม์ API
  4. ใช้หน้าผู้ลงโฆษณาที่ระบุโดยผู้เสนอราคาเพื่อเพิ่มเบราว์เซอร์ไปยังผู้เสนอราคา กลุ่มความสนใจ

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

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

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

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

    1. ระบบจะแสดงผลโฆษณาที่คาดว่าจะชนะ
    2. มีการส่งผลการประมูลจากฝั่งเซิร์ฟเวอร์ ซึ่งหมายความว่าผู้เสนอราคาที่ชนะ ได้รับคําสั่ง ping กลับจาก 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 Buyer ศูนย์ช่วยเหลือเมื่อคุณพร้อม Google จะเปิดใช้บัญชีในขั้นตอนนี้

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

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

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

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

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

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

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

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

สรุปโฟลว์การแสดง

ขั้นตอนการประมูลแบบคู่ขนานโดยสรุปมีดังนี้ แผนผังโฟลว์

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

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

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

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

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

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

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