ประมวลผลคำขอ

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

แยกวิเคราะห์คำขอ

Google จะส่งคำขอราคาเสนอที่เรียงอันดับเป็นรูปแบบ OpenRTB JSON หรือ Protobuf โดยแนบเป็นเพย์โหลดของคำขอ POST ของ HTTP รูปแบบที่ได้รับจะขึ้นอยู่กับการกำหนดค่าปลายทาง ดูตัวอย่างได้ที่ตัวอย่างคำขอราคาเสนอ

คุณต้องแยกวิเคราะห์คำขอนี้เพื่อรับ BidRequest ที่เรียงลำดับแล้ว หากใช้รูปแบบ Protobuf คุณต้องดาวน์โหลด openrtb.proto และ openrtb-adx.proto จากหน้าข้อมูลอ้างอิง แล้วใช้เพื่อสร้างไลบรารีที่สามารถใช้แยกวิเคราะห์ข้อความ BidRequest ได้ ตัวอย่างเช่น โค้ด C++ ต่อไปนี้จะแยกวิเคราะห์คำขอที่ได้รับเพย์โหลด POST ในสตริง

string post_payload = /* the payload from the POST request */;
BidRequest bid_request;
if (bid_request.ParseFromString(post_payload)) {
  // Process the request.
}

เมื่อมี BidRequest แล้ว คุณจะใช้เป็นออบเจ็กต์ได้ โดยแยกและตีความฟิลด์ที่ต้องการ ตัวอย่างเช่น ใน C++ การทำซ้ำผ่านดีลใน `BidRequest` ของ OpenRTB อาจมีลักษณะดังนี้

for (const BidRequest::Imp::Pmp::Deal& deal : pmp.deals()) {
  DoSomething(deal.id(), deal.wseat());
}

รหัสการเรียกเก็บเงิน

คุณจะได้รับคำขอราคาเสนอเมื่อพื้นที่โฆษณาของผู้เผยแพร่โฆษณาได้รับการกำหนดเป้าหมายโดยการกำหนดค่าการกำหนดเป้าหมายล่วงหน้าอย่างน้อย 1 รายการ BidRequest.imp.ext.billing_id จะป้อนรหัสการเรียกเก็บเงินของผู้ซื้อที่มีสิทธิ์และการกำหนดค่าการกำหนดเป้าหมายล่วงหน้าที่เกี่ยวข้อง นอกจากนี้ สำหรับพื้นที่โฆษณาดีล คุณสามารถค้นหารหัสการเรียกเก็บเงินที่เชื่อมโยงกับผู้ซื้อที่เกี่ยวข้องได้โดยใช้ BidRequest.imp.pmp.deal.ext.billing_id คุณจะระบุได้เฉพาะรหัสการเรียกเก็บเงินของผู้ซื้อที่รวมอยู่ในคำขอราคาเสนอเมื่อเสนอราคา

หากมีรหัสการเรียกเก็บเงินหลายรหัสรวมอยู่ในคำขอราคาเสนอ คุณต้องระบุรหัสการเรียกเก็บเงินของผู้ซื้อที่คุณต้องการระบุแหล่งที่มาของราคาเสนอด้วยช่อง BidResponse.seatbid.bid.ext.billing_id

imp {
  ext {
    // The billing IDs of all of your matching pretargeting configs and eligible child seats are
    // stored in a flat list here.
    billing_id: 123
    billing_id: 456
    billing_id: 789
  }
  pmp {
    // All eligible deals are stored in a single flat list.
    deal {
      id: 1000
      ext {
        // The specific billing IDs eligible to bid on this deal are indicated here.
        billing_id: 789
      }
      ...
    }
    deal {
      id: 2000
      ext {
        billing_id: 123
        billing_id: 456
      }
      ...
    }
  }
  ...
}
...

ระบุหมวดหมู่ที่ถูกบล็อก

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

คุณดูหมวดหมู่ที่ถูกบล็อกสำหรับการแสดงผลได้โดยตรวจสอบช่อง BidRequest.bcat ซึ่งมีหมวดหมู่ในการจัดหมวดหมู่ที่กำหนดค่าไว้สำหรับบัญชีของคุณ

ตัวอย่างต่อไปนี้แสดงหมวดหมู่ที่ถูกบล็อกตามการจัดหมวดหมู่โฆษณาที่กำหนดค่าไว้

การจัดหมวดหมู่เนื้อหาของ IAB 1.0

// Bid request
{
  // Indicates the blocked categories using IAB Content 1.0 Taxonomy.
  "bcat": [
    "IAB9-9",  // Cigars
    "IAB8-18"  // Wine
  ]
  "imp": {
    ...
  }
}
      
// Bid request
{
  // Indicates the blocked categories using Google Ad Category Taxonomy.
  "bcat": [
    "10138",  // Cigar and tobacco collecting
    "10080",  // Tobacco
    "11649",  // Wine
    "10674",  // Wine collecting
    "13008"   // Wine clubs
  ]
  "imp": {
    ...
  }
}
      

ระบุหมวดหมู่ตามบริบท

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

หมวดหมู่ตามบริบทที่ Google ตรวจพบ

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

ช่อง คำอธิบาย
BidRequest.site.cat อาร์เรย์ของรหัสหมวดหมู่เนื้อหาที่อธิบายเว็บไซต์
BidRequest.site.pagecat อาร์เรย์ของรหัสหมวดหมู่เนื้อหาที่อธิบายหน้าหรือมุมมองปัจจุบันของเว็บไซต์
BidRequest.app.cat อาร์เรย์ของรหัสหมวดหมู่เนื้อหาที่อธิบายแอป
BidRequest.app.pagecat อาร์เรย์ของรหัสหมวดหมู่เนื้อหาที่อธิบายหน้าหรือมุมมองปัจจุบันของแอป

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

สัญญาณที่ผู้เผยแพร่โฆษณามีให้

นอกจากหมวดหมู่ตามบริบทที่ Google ตรวจพบแล้ว คำขอราคาเสนอยังอาจมีสัญญาณที่ได้จากผู้เผยแพร่โฆษณา ซึ่งอธิบายบริบทของการแสดงผลด้วย สัญญาณเหล่านี้จะสร้างขึ้นเมื่อผู้เผยแพร่โฆษณาระบุเท่านั้น ซึ่งต่างจากหมวดหมู่ตามบริบทที่ Google ตรวจพบ ระบบจะส่งสัญญาณเหล่านี้ในออบเจ็กต์ BidRequest.site.content และ BidRequest.app.content เช่น content.data.segment และ content.genre ระบบจะรายงานการจัดหมวดหมู่ที่ใช้สำหรับรายการ content.data.segment ใน content.data.ext.segtax ดูข้อมูลเพิ่มเติมได้ที่สัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) สำหรับการเสนอราคาแบบเรียลไทม์ (RTB)

ไฟล์พจนานุกรม

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

มาโคร URL ของผู้เสนอราคา

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

มาโครคำอธิบาย
%%GOOGLE_USER_ID%%

แทนที่ด้วยรหัสผู้ใช้ Google ที่พบใน BidRequest.user.id เช่น URL ของผู้เสนอราคา http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% จะถูกแทนที่ด้วย URL อย่างเช่น http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl ในเวลาที่ส่งคำขอ

หากไม่ทราบรหัสผู้ใช้ Google ระบบจะแทนที่ด้วยสตริงว่าง โดยมีผลลัพธ์คล้ายกับ

http://google.bidder.com/path?gid=
%%HAS_MOBILE%%

แทนที่ด้วย 1 เพื่อระบุว่าคำขอราคาเสนอมาจากอุปกรณ์เคลื่อนที่ หรือ 0 ในกรณีอื่นๆ ซึ่งอิงตามค่าของ BidRequest.device.devicetype โดยอุปกรณ์เคลื่อนที่จะระบุด้วย HIGHEND_PHONE (4) หรือ Tablet (5)

%%HAS_VIDEO%%

แทนที่ด้วย 1 เพื่อระบุว่าคำขอราคาเสนอมีพื้นที่โฆษณาวิดีโอ หรือ 0 ในกรณีอื่นๆ ซึ่งจะอิงตามว่ามีการป้อนข้อมูล BidRequest.imp.video ในคำขอราคาเสนอหรือไม่

%%IS_CTV%%

แทนที่ด้วย 1 เพื่อระบุว่าคำขอราคาเสนอมาจากอุปกรณ์ CTV หรือ 0 ในกรณีอื่นๆ ซึ่งอิงตามค่าของ BidRequest.device.devicetype สำหรับ Protobuf อุปกรณ์ CTV คือ CONNECTED_TV, CONNECTED_DEVICE หรือ SET_TOP_BOX ซึ่งสอดคล้องกับค่าจำนวนเต็ม 3, 6 หรือ 7 สำหรับ JSON

%%HOSTED_MATCH_DATA%%

แทนที่ด้วยค่าที่อิงตาม BidRequest.user.buyeruid

%%MOBILE_IS_APP%%

แทนที่ด้วย 1 เพื่อระบุว่าคำขอราคาเสนอมีไว้สำหรับพื้นที่โฆษณาในแอปบนมือถือ หรือ 0 ในกรณีอื่นๆ ซึ่งขึ้นอยู่กับว่ามีการป้อนข้อมูลใน BidRequest.app หรือไม่

ค้นหารหัสแอปบนอุปกรณ์เคลื่อนที่จาก URL ของธุรกรรม

ธุรกรรมของแอปพลิเคชันบนมือถือจะรายงาน URL ที่มีลักษณะดังนี้

mbappgewtimrzgyytanjyg4888888.com

ใช้เครื่องมือถอดรหัส base-32 เพื่อถอดรหัสส่วนของสตริงที่เป็นตัวหนา (gewtimrzgyytanjyg4888888)

คุณสามารถใช้เครื่องมือถอดรหัสออนไลน์ได้ แต่จะต้องเปลี่ยนตัวอักษรเป็นตัวพิมพ์ใหญ่และแทนที่ 8 ต่อท้ายด้วยค่า =

ดังนั้นการถอดรหัสค่านี้จึงเป็นดังนี้

GEWTIMRZGYYTANJYG4======
จะให้ผลลัพธ์ดังนี้
1-429610587
สตริง 429610587 คือรหัสแอปสำหรับแอป iOS iFunny

ลองมาดูอีกตัวอย่างหนึ่งกัน URL ที่รายงานคือ

mbappgewtgmjug4ytmmrtgm888888.com
การถอดรหัสค่านี้
GEWTGMJUG4YTMMRTGM======
จะให้ผลลัพธ์ดังนี้
1-314716233
ผลลัพธ์ 314716233 คือรหัสแอปสำหรับแอป iOS TextNow

ค้นหาชื่อแอปบนอุปกรณ์เคลื่อนที่จาก URL ของธุรกรรม

ตัวอย่างการรับชื่อแอปมีดังนี้ URL ที่รายงานมีดังนี้

mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888.com
การถอดรหัสค่านี้
MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q===
จะให้ผลลัพธ์ดังนี้
air.com.hypah.io.slither
ผลลัพธ์ที่ได้คือแอป Android slither.io

ช่องการเสนอราคาแบบเปิด

คำขอราคาเสนอที่ส่งไปยังผู้เสนอราคาของ Exchange และเครือข่ายที่เข้าร่วมการเสนอราคาแบบเปิดจะคล้ายกับคำขอราคาเสนอของ Authorized Buyers ที่เข้าร่วมการเสนอราคาแบบเรียลไทม์มาตรฐาน ลูกค้าที่ใช้การเสนอราคาแบบเปิดจะได้รับช่องเพิ่มเติมจำนวนเล็กน้อย และช่องที่มีอยู่บางช่องอาจมีการใช้งานทางเลือก ซึ่งรวมถึงแอปต่อไปนี้ด้วย

OpenRTB รายละเอียด
BidRequest.imp.ext.dfp_ad_unit_code

มีรหัสเครือข่าย Ad Manager ของผู้เผยแพร่โฆษณาตามด้วยลำดับชั้นของหน่วยโฆษณา โดยคั่นด้วยเครื่องหมายทับ

ตัวอย่างเช่น ข้อมูลนี้จะปรากฏโดยมีการจัดรูปแบบคล้ายกับ /1234/cruises/mars

BidRequest.user.data.segment

คู่คีย์-ค่าที่ซ้ำกันซึ่งส่งจากผู้เผยแพร่โฆษณาไปยังผู้เสนอราคา Exchange

คุณสามารถระบุได้ว่าค่าเป็นคู่คีย์-ค่าที่ผู้เผยแพร่โฆษณาส่งมาเมื่อตั้งค่า BidRequest.user.data.name เป็น “Publisher Passed”

ประกาศผู้ให้บริการที่อนุญาต

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

หากต้องการทำความเข้าใจBidRequestและสร้างBidResponse คุณต้องทราบถึงความเป็นไปได้ 2 แบบในการประกาศผู้ให้บริการเทคโนโลยี ดังนี้

  1. ผู้ให้บริการบางรายไม่จำเป็นต้องประกาศ โดยผู้ให้บริการเหล่านี้จะแสดงอยู่ในผู้ให้บริการภายนอกที่ผ่านการรับรองจาก Ad Manager
  2. ผู้ให้บริการรายอื่นๆ จะเข้าร่วมได้ก็ต่อเมื่อมีการประกาศใน BidRequest เท่านั้น
    • ใน BidRequest ช่อง BidRequest.imp.ext.allowed_vendor_type จะระบุผู้ให้บริการที่ผู้ขายอนุญาต ผู้ให้บริการที่จะส่งใน allowed_vendor_type จะแสดงอยู่ในไฟล์พจนานุกรม vendors.txt

ตัวอย่างคำขอราคาเสนอ

ตัวอย่างต่อไปนี้แสดงตัวอย่างคำขอ Protobuf และ JSON ที่มนุษย์อ่านได้

OpenRTB Protobuf

OpenRTB JSON

หากต้องการแปลงคำขอราคาเสนอเป็นรูปแบบไบนารี เช่น รูปแบบที่คุณจะได้รับจากเพย์โหลด POST ในคำขอจริง ให้ทำดังนี้ (ใน C++) อย่างไรก็ตาม โปรดทราบว่าวิธีนี้ไม่เกี่ยวข้องกับ OpenRTB JSON

string text_format_example = /* example from above */;
BidRequest bid_request;
if (TextFormat::ParseFromString(text_format_example, &bid_request)) {
  string post_payload;
  if (bid_request.SerializeToString(&post_payload)) {
    // post_payload is a binary serialization of the protocol buffer
  }
}

ความคิดเห็นแบบเรียลไทม์

ความคิดเห็นแบบเรียลไทม์พร้อมให้บริการแก่ Authorized Buyers รวมถึง Exchange และเครือข่ายที่ใช้การเสนอราคาแบบเปิด

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

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

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

message BidFeedback {
  // The unique id from BidRequest.id.
  optional string request_id = 1;

  // The status code for the ad. See creative-status-codes.txt in the
  // technical documentation for a list of ids.
  optional int32 creative_status_code = 2;

  // Deprecated. This field is not populated and will be removed after March,
  // 2025. If the bid won the auction, this is the price paid in your account
  // currency. If the bid participated in the auction but was out-bid, this
  // is the CPM that should have been exceeded in order to win. This is not
  // set if the bid was filtered prior to the auction, if the publisher or
  // winning bidder has opted out of price feedback or if your account has
  // opted out of sharing winning prices with other bidders. For first-price
  // auctions, minimum_bid_to_win is populated instead of this field.
  optional double price = 3 [deprecated = true];

  // The minimum bid value necessary to have won the auction, in your account
  // currency. If your bid won the auction, this is the second highest bid
  // that was not filtered (including the floor price). If your bid didn't win
  // the auction, this is the winning candidate's bid. This field will only be
  // populated if your bid participated in a first-price auction, and will not
  // be populated if your bid was filtered prior to the auction.
  optional double minimum_bid_to_win = 6;

  // Billable event rate multiplier that was applied to this bid during
  // ranking. The adjustment reflects the likelihood that your bid would
  // generate a billable event (namely, the ad renders successfully) if it won
  // the auction, relative to the probability that other bids generate a
  // billable event if they won the auction. This adjustment can be larger or
  // smaller than 1. This affects the final ranking in the auction only; in
  // particular, this multiplier does not affect the payment or whether the
  // bid clears any floor price.
  optional float billable_event_rate_bid_adjustment = 13 [default = 1];

  // When a publisher uses an RTB auction and waterfall-based SDK mediation on
  // the same query, the winner of the real-time auction must also compete in
  // a mediation waterfall (which is ordered by price) to win the impression.
  // If the bid participated in the auction and there was no waterfall, the
  // value of this field is 0. If the bid participated in the auction and
  // there was a waterfall, the value of this field is a price representing a
  // sample bid from the eligible mediation networks that were higher than the
  // auction winner, weighted by expected fill rate. This field can be used
  // in conjunction with minimum_bid_to_win to train bidding models. The CPM
  // is in your account currency.
  optional double sampled_mediation_cpm_ahead_of_auction_winner = 8;

  message EventNotificationToken {
    // The contents of the token.
    optional string payload = 1;
  }

  // The token included in the corresponding bid.
  optional EventNotificationToken event_notification_token = 4;

  // The creative ID included in the corresponding bid.
  optional string buyer_creative_id = 5;
}

จากข้อความนี้ ช่องแรกที่คุณควรตรวจสอบคือ bid_feedback.creative_status_code คุณสามารถดูความหมายของรหัสได้ใน creative-status-codes.txt โปรดทราบว่าหากชนะราคาเสนอ คุณสามารถเลือกไม่ใช้ความคิดเห็นเกี่ยวกับราคาได้ ดูข้อมูลเพิ่มเติมได้ที่วิธีเลือกไม่ใช้

ความคิดเห็นแบบเรียลไทม์ประกอบด้วยรหัสคำขอราคาเสนอและข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

ผลการประมูล ความคิดเห็นแบบเรียลไทม์
ผู้ซื้อไม่ได้ส่งราคาเสนอ ไม่มี
ผู้ซื้อส่งราคาเสนอที่ถูกกรองออกก่อนที่จะเข้าสู่การประมูล รหัสสถานะครีเอทีฟโฆษณา (creative-status-codes.txt)
ผู้ซื้อส่งราคาเสนอแต่แพ้การประมูล รหัสสถานะครีเอทีฟโฆษณา 79 (แพ้การประมูล)
ผู้ซื้อส่งราคาเสนอที่ชนะการประมูล ราคาปิดและรหัสสถานะครีเอทีฟโฆษณา 1

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

ตัวอย่าง

ต่อไปนี้เป็นตัวอย่างความคิดเห็นแบบเรียลไทม์ที่เห็นในโปรโตคอลที่รองรับ

OpenRTB Protobuf

OpenRTB JSON

สร้างรูปแบบการเสนอราคาสำหรับการประมูลแบบใช้ราคาอันดับ 1

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

  • minimum_bid_to_win: ราคาเสนอขั้นต่ำที่อาจตั้งไว้เพื่อชนะการประมูลแบบเรียลไทม์ หากคุณชนะการประมูล นี่จะเป็นราคาเสนอต่ำสุดที่คุณสามารถเสนอได้ในขณะที่ยังชนะอยู่ หากคุณแพ้การประมูล ราคาเสนอที่ชนะจะเป็นราคาเสนอที่ชนะ
  • sampled_mediation_cpm_ahead_of_auction_winner: หากมีเครือข่ายอื่นๆ ในเชนสื่อกลาง (Mediation Chain) ค่าของช่องนี้คือราคาที่แสดงราคาเสนอตัวอย่างจากเครือข่ายสื่อกลางที่มีสิทธิ์ซึ่งสูงกว่าผู้ชนะการประมูล โดยถ่วงน้ำหนักตามอัตราการส่งโฆษณาที่คาดไว้ ระบบจะตั้งค่านี้เป็น 0 หากคาดว่าไม่มีเครือข่ายใดในเชนสื่อกลาง (Mediation Chain) ที่จะแสดงโฆษณา หรือหากผู้เผยแพร่โฆษณาไม่ได้ใช้สื่อกลาง SDK

วิธีการทำงาน

ในการอธิบายการคำนวณที่ใช้เพื่อระบุค่าที่เป็นไปได้สำหรับ minimum_bid_to_win และ sampled_mediation_cpm_ahead_of_auction_winner ก่อนอื่นเราต้องกำหนดสิ่งต่อไปนี้

  • ข้อมูลต่อไปนี้แสดง CPM ในเชนสื่อกลาง (Mediation Chain) โดยเรียงลำดับจากมากไปน้อย
    \[C_1, C_2, …, C_n\]
  • ข้อมูลต่อไปนี้แสดงอัตราการส่งโฆษณาที่สอดคล้องกับ CPM ในเชนสื่อกลาง (Mediation Chain)
    \[f_1, f_2, …, f_n\]
  • ต่อไปนี้เป็นฟังก์ชันที่ใช้ในการกำหนด CPM ที่คาดหวังและความน่าจะเป็นจากองค์ประกอบเชนสื่อกลาง (Mediation Chain) \(i\)โดยอิงตามอัตราการส่งโฆษณาที่ระบุ
    \(X_i = \{C_i\) ด้วยความน่าจะเป็น \(f_i\); \(0\) ด้วยความน่าจะเป็น \(1 - f_i\}\)
  • เชนสื่อกลาง (Mediation Chain) ที่ชนะขั้นสุดท้ายจะเป็นดังนี้
    \[\{C_1, C_2, …, C_K, W\}\]
    โดยที่ \(W\) คือราคาเสนอที่ชนะ และ \(C_K > W >= C_{K+1}\)
  • ราคาจองหรือราคาพื้นจะแสดงเป็น \(F\)
  • ราคาเสนอที่รองลงมาจะแสดงเป็น \(R\)
การคำนวณสำหรับผู้ชนะการประมูล
ช่อง การคำนวณ
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(\{C_i\) ด้วยความน่าจะเป็น \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
สำหรับ \(1 <= i <= K\)

การคำนวณสำหรับผู้แพ้การประมูล
ช่อง การคำนวณ
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(max\{X_1, …, X_K\}\)

ตัวอย่างที่มีเชนสื่อกลาง (Mediation Chain) แบบง่าย

สมมติว่าผู้เผยแพร่โฆษณาใช้ทั้งการเสนอราคาแบบเรียลไทม์และเชนสื่อกลาง (Mediation Chain) ของ SDK ดังนี้

เชนสื่อกลาง SDK CPM ที่คาดไว้ อัตราการส่งโฆษณา
เครือข่าย 1 \(C_1 = $3.00\) \(f_1 = 5\%\)
เครือข่าย 2 \(C_2 = $2.00\) \(f_2 = 45\%\)
เครือข่าย 3 \(C_3 = $0.50\) \(f_3 = 80\%\)
เครือข่าย 4 \(C_4 = $0.10\) \(f_4 = 85\%\)

สมมติว่าผลลัพธ์ของการประมูล RTB เป็นดังนี้

การประมูล RTB CPM
ผู้ชนะการประมูล (W) $1.00
ผู้ชนะอันดับ 2 ในการประมูล (R) $0.05
ราคาจอง/ราคาพื้น (F) $0
ราคาเสนอที่ชนะการประมูล

ต่อไปนี้เป็นตัวอย่างวิธีคำนวณค่าและความน่าจะเป็นของ minimum_bid_to_win และ sampled_mediation_cpm_ahead_of_auction_winner สำหรับราคาเสนอที่ชนะ

minimum_bid_to_win Probability
\(max(F, R, C_3) = $0.50\) \(f_3 = 80\%\)
\(max(F, R, C_4) = $0.10\) \((1-f_3) \cdot f_4 = 17\%\)
\(max(F, R, 0) = $0.05\) \((1-f_3) \cdot (1-f_4) = 3\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Probability
\(C_1 = $3.00\) \(f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%\)
\(C_2 = $2.00\) \(((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%\)
ราคาเสนอที่แพ้การประมูล

ต่อไปนี้เป็นตัวอย่างวิธีคำนวณมูลค่าและความน่าจะเป็นของ minimum_bid_to_win และ sampled_mediation_cpm_ahead_of_auction_winner สำหรับราคาเสนอที่แพ้

minimum_bid_to_win Probability
\(max(F, W) = $1.00\) \(100\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Probability
\(C_1 = $3.00\) \(f_1 = 5\%\)
\(C_2 = $2.00\) \((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\) \((1-f_1) \cdot (1-f_2) =~ 52.2\%\)

การแยกการเสนอราคา

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

ระบบจะเปิดใช้การแยกการเสนอราคาโดยค่าเริ่มต้น แต่คุณสามารถติดต่อผู้จัดการฝ่ายดูแลลูกค้าหากต้องการปิดใช้

รูปแบบโฆษณา

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

คำขอราคาเสนอที่มีรูปแบบต่อไปนี้จะถูกแยกเป็นคำขอราคาเสนอที่แตกต่างกัน

  • แบนเนอร์
  • วิดีโอ
  • เสียง
  • เนทีฟ

ตัวอย่างการรวมรูปแบบโฆษณา

ด้านล่างนี้คือตัวอย่างที่แสดงคำขอราคาเสนอ JSON ของ OpenRTB แบบง่ายที่ไม่มีการแยกรูปแบบโฆษณาเมื่อเทียบกับชุดคำขอที่แยกแล้วที่เทียบเท่ากัน

Pre-flatten

หลังการปรับให้แบนราบ

ดีล

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

ความสามารถในการข้ามและความยาววิดีโอ

ข้อกำหนด OpenRTB ไม่มีช่องแยกต่างหากสำหรับระบุความยาววิดีโอสูงสุดของโฆษณาแบบข้ามได้และแบบข้ามไม่ได้ การติดตั้งใช้งานของ Google ใช้การแยกการเสนอราคาเพื่อแยกความแตกต่างระหว่างการเสนอราคาเหล่านี้โดยใช้ช่อง BidRequest.video.maxduration และ BidRequest.video.skip ที่มีอยู่

ต่อไปนี้เป็นตัวอย่างวิธีที่พื้นที่โฆษณาวิดีโอถูกปรับให้สอดคล้องกันเมื่อระยะเวลาสูงสุดของโฆษณาแบบข้ามไม่ได้คือ 15 และระยะเวลาสูงสุดของโฆษณาแบบข้ามได้คือ 60

ตัวอย่าง max_ad_duration skip (จริงหรือเท็จ)
คำขอเดิมที่ไม่มีการแยกข้อมูล 15 true
คำขอที่แยกเป็นหลายรายการ #1: ข้ามไม่ได้ 15 false
คำขอที่แยกเป็นหลายรายการ #2: ข้ามได้ 60 true

การแยกคำขอราคาเสนอตามความยาววิดีโอแบบข้ามได้จะเกิดขึ้นเมื่อเป็นไปตามเงื่อนไขต่อไปนี้เท่านั้น

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

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

พ็อดวิดีโอ

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

Open Measurement

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

คุณสามารถระบุได้ว่าผู้เผยแพร่โฆษณารองรับ Open Measurement ในคำขอราคาเสนอหรือไม่ โดยตรวจสอบว่าโอกาสในการแสดงโฆษณายกเว้นแอตทริบิวต์ OmsdkType: OMSDK 1.0 ที่พบในแอตทริบิวต์ครีเอทีฟโฆษณาที่ผู้เผยแพร่โฆษณายกเว้นได้หรือไม่ ซึ่งจะอยู่ในแอตทริบิวต์ battr สำหรับแบนเนอร์หรือวิดีโอ ทั้งนี้ขึ้นอยู่กับรูปแบบ

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีตีความคำขอราคาเสนอที่มีสัญญาณ Open Measurement ได้ที่บทความในศูนย์ช่วยเหลือเกี่ยวกับ SDK ของ Open Measurement

ตัวอย่างคำขอราคาเสนอ

ส่วนต่อไปนี้แสดงตัวอย่างคำขอราคาเสนอสำหรับประเภทโฆษณาต่างๆ

แบนเนอร์ของแอป

OpenRTB Protobuf

OpenRTB JSON

โฆษณาคั่นระหว่างหน้าในแอป

OpenRTB Protobuf

OpenRTB JSON

วิดีโอโฆษณาคั่นระหว่างหน้าในแอป

OpenRTB Protobuf

OpenRTB JSON

แอปเนทีฟ

OpenRTB Protobuf

OpenRTB JSON

วิดีโอบนเว็บ

OpenRTB Protobuf

OpenRTB JSON

แบนเนอร์เว็บบนมือถือสำหรับการเสนอราคาแลกเปลี่ยน

OpenRTB Protobuf

OpenRTB JSON

โฆษณาเนทีฟและวิดีโอแบบ Multi-Format

OpenRTB Protobuf

OpenRTB JSON