ออบเจ็กต์ SupplyChain ช่วยให้ผู้ซื้อและตัวกลางสามารถดูทุกฝ่ายที่ขายหรือขายต่อพื้นที่โฆษณา ออบเจ็กต์ดังกล่าวทำงานร่วมกับ ads.txt
/ ads.txt
และ ads.txt
เพื่อสร้างความโปร่งใสในระบบนิเวศของโฆษณา
- ผู้เผยแพร่โฆษณาจะส่งคำขอราคาเสนอ
- ผู้ซื้อจะรับคำขอราคาเสนอและข้อมูลจากออบเจ็กต์ SupplyChain
- ผู้ซื้อจะหาตัวตนของตัวกลางทั้งหมดที่ขายต่อพื้นที่โฆษณา
- ผู้ซื้อจะรวบรวมข้อมูลและยืนยันผู้ขายที่ได้รับสิทธิ์ให้ขายพื้นที่โฆษณา
Google จะสร้างออบเจ็กต์นี้โดยอัตโนมัติภายในคำขอ OpenRTB หรือโปรโตคอล Google RTB หากมี
วิธีการทำงานของออบเจ็กต์ SupplyChain
ออบเจ็กต์ SupplyChain หรือที่เรียกอีกอย่างว่า
เป็นส่วนหนึ่งของคำขอราคาเสนอ OpenRTB และประกอบได้ด้วย "โหนดต่างๆ" แต่ละโหนดในออบเจ็กต์ schain
schain
แสดงถึงเอนทิตีที่เจาะจงซึ่งมีส่วนร่วมในคำขอราคาเสนอ โดยประกอบด้วยเอนทิตีทั้งหมดที่มีส่วนร่วมในขั้นตอนโดยตรงของการชำระเงินสำหรับพื้นที่โฆษณา
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
"hp":1
}],
"ver":"1.0"
}
อ่านรายละเอียดเพิ่มเติมได้จากเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของ OpenRTB และเอกสารประกอบของ IAB
ออบเจ็กต์ SupplyChain จะมีลักษณะแตกต่างกันไป ขึ้นอยู่กับวิธีที่คุณทำงานร่วมกับผู้ซื้อ
ผู้เผยแพร่โฆษณาที่ขายโดยตรงกับ Google
สำหรับผู้เผยแพร่โฆษณาที่ขายพื้นที่โฆษณาผ่าน Ad Manager, AdMob หรือ AdSense โดยตรง ออบเจ็กต์ schain
จะมีเพียงโหนดเดียวสำหรับ "google.com" ที่มี seller_id
อยู่ใน sellers.json
ผู้เผยแพร่โฆษณาที่ใช้การเสนอราคาแบบเปิด
ผู้เผยแพร่โฆษณาที่ใช้การเสนอราคาแบบเปิดเพื่อทำงานร่วมกับ Exchange บุคคลที่สามจะมี 2 โหนดในออบเจ็กต์ schain
ได้แก่ 1 โหนดสำหรับ google.com ซึ่งมี seller_id
ที่พบในไฟล์ sellers.json และอีก 1 โหนดสำหรับพาร์ทเนอร์ผลตอบแทนของ Exchange
Exchange บุคคลที่สามมีหน้าที่เพิ่มโหนดของตนก่อนส่งต่อคำขอ เช่นเดียวกับที่ Google สร้างโหนดสำหรับ google.com ก่อนส่งคำขอราคาเสนอ
ตัวกลางที่ไม่ได้ชำระเงิน
ตัวกลางที่ไม่ได้จัดการการชำระเงินจะไม่รวมอยู่ในออบเจ็กต์ SupplyChain ซึ่งรวมถึงการเสนอราคาส่วนหัวฝั่งไคลเอ็นต์ การเสนอราคาส่วนหัวที่ไม่ได้ชําระเงิน การแชร์พื้นที่โฆษณา และสื่อกลางอื่นๆ
ผู้เผยแพร่โฆษณาที่ใช้สื่อกลางการชำระเงินก่อนส่งคำขอ (เบต้า)
ฟีเจอร์ที่อยู่ในเวอร์ชันเบต้าอาจใช้งานไม่ได้ในเครือข่ายของคุณ ไปที่บันทึกประจำรุ่นเพื่อดูว่าฟีเจอร์นี้จะพร้อมให้บริการสำหรับผู้ใช้ทั่วไปเมื่อใด
ผู้เผยแพร่โฆษณาที่ใช้สื่อกลางการชำระเงินก่อนส่งคำขอไปยัง Google Ad Manager ต้องส่งออบเจ็กต์ SupplyChain
ตามหลักเกณฑ์ IAB ออบเจ็กต์ SupplyChain
ควรมีเฉพาะตัวกลางที่มีส่วนร่วมโดยตรงในขั้นตอนการชำระเงินสำหรับพื้นที่โฆษณา โดยสื่อกลางดังกล่าวอาจรวมถึงเทคโนโลยีเซิร์ฟเวอร์โฆษณาบุคคลที่สามที่ผู้เผยแพร่โฆษณาใช้ คุณส่งออบเจ็กต์ SupplyChain
ในคำขอโฆษณาได้โดยใช้พารามิเตอร์ schain
คำอธิบาย
พารามิเตอร์ซัพพลายเชน (schain
) ยอมรับค่าตัวแปรซึ่งควรเป็นออบเจ็กต์ SupplyChain ที่ทำให้เป็นอนุกรม เมื่อรวมพารามิเตอร์นี้ไว้ Google จะนำโหนดไปต่อท้ายออบเจ็กต์ schain
ที่ได้รับก่อนที่จะส่งไปยังผู้ซื้อ
ดูเอกสารประกอบฉบับเต็มของ IAB สำหรับการสื่อสารข้อมูล SupplyChain ผ่านแท็ก (แทนที่จะเป็น OpenRTB)
ดูข้อกำหนดในการแยกวิเคราะห์schain
อย่างถูกต้อง
ต่อไปนี้เป็นการกำหนดการทำให้เป็นอนุกรมสำหรับออบเจ็กต์ SupplyChain
โดยอิงตามเอกสารประกอบของ IAB
{SupplyChainObject}!{SupplyChainNode array} พร็อพเพอร์ตี้ SupplyChainObject
และSupplyChainNode
มีการคั่นด้วยคอมมาเพื่อให้สามารถข้ามฟิลด์ที่ไม่บังคับ รวมทั้งตัวคั่นคอมมาที่ใช้คั่นฟิลด์นั้น- องค์ประกอบ
SupplyChainNode
แต่ละรายการจะคั่นด้วย "!
" - หากค่าของพร็อพเพอร์ตี้ใดมีอักขระที่ต้องเข้ารหัส URL (เช่น "
,
" หรือ "!
") ค่าดังกล่าวควรเข้ารหัส URL ก่อนการทำให้เป็นอนุกรม
ลำดับการทำให้เป็นอนุกรม
ระบบจะทำให้พร็อพเพอร์ตี้ SupplyChainObject
เป็นอนุกรมตามลำดับนี้
ver,complete
ระบบจะทำให้พร็อพเพอร์ตี้ SupplyChainNode
เป็นอนุกรมตามลำดับนี้
asi,sid,hp,rid,name,domain,ext
ext
จะเป็นค่าเฉพาะสำหรับแต่ละพาร์ทเนอร์การจอง Google Ad Manager จะไม่แยกวิเคราะห์พร็อพเพอร์ตี้นี้ตัวอย่างวิธีทำให้ออบเจ็กต์ SupplyChain เป็นอนุกรม
ด้านล่างนี้คือตัวอย่าง 2 วิธีในการทำให้ออบเจ็กต์ SupplyChain
ข้างต้นเป็นอนุกรม
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
ตัวอย่างการใช้
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
หากค่าของ asi
คือ exchange,1
การทำให้เป็นอนุกรมด้วยอักขระหลีกจะมีลักษณะดังนี้
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือธุรกรรมประเภทใดโดยเฉพาะ แต่ผู้เผยแพร่โฆษณาที่ใช้สื่อกลางการชําระเงินก่อนส่งคำขอไปยัง Google Ad Manager ต้องใช้พารามิเตอร์นี้ ซึ่งรวมถึงผู้เผยแพร่โฆษณาที่ใช้เทคโนโลยีเซิร์ฟเวอร์โฆษณาบุคคลที่สาม
SupplyChain
ควรแสดงในไฟล์ ads.txt/app-ads.txt ของผู้เผยแพร่โฆษณาด้วย ไม่เช่นนั้นผู้ซื้ออาจถือว่าการเข้าชมไม่ได้รับอนุญาตผู้เผยแพร่โฆษณาที่ใช้เครื่องมือบริหารจัดการบัญชีลูกค้า (MCM)
เครื่องมือบริหารจัดการบัญชีลูกค้า (MCM) ช่วยให้ผู้เผยแพร่โฆษณาหลักสร้างรายได้จากพื้นที่โฆษณาของผู้เผยแพร่โฆษณาย่อยได้ทั้งแบบเดี่ยวด้วยการมอบสิทธิ์ประเภท "จัดการบัญชี" หรือแบบจำนวนมากด้วยการมอบสิทธิ์ประเภท "จัดการพื้นที่โฆษณา"
สำหรับพาร์ทเนอร์ที่ใช้สิทธิ์จัดการบัญชี
สำหรับผู้เผยแพร่โฆษณาหลักและย่อยที่ใช้สิทธิ์จัดการบัญชี ออบเจ็กต์ schain
จะมี 1 โหนดที่มีรหัสผู้ขายของผู้เผยแพร่โฆษณาย่อยและเชนดังกล่าวจะทำเครื่องหมายว่าสมบูรณ์แล้ว สำหรับผู้เผยแพร่โฆษณาที่ใช้สิทธิ์จัดการบัญชี การสร้างรายได้จะเกิดขึ้นในบัญชีของผู้เผยแพร่โฆษณาย่อย โดยจะถือว่าผู้เผยแพร่ย่อยเป็นผู้เผยแพร่โฆษณาปลายทาง ข้อมูลของผู้เผยแพร่โฆษณาหลักจะไม่รวมอยู่ในออบเจ็กต์ schain
สำหรับพาร์ทเนอร์ที่ใช้สิทธิ์จัดการพื้นที่โฆษณา
ปัจจุบันออบเจ็กต์ SupplyChain มีการทําเครื่องหมายว่าสมบูรณ์แล้วสําหรับผู้เผยแพร่โฆษณาที่ใช้จัดการพื้นที่โฆษณาของ MCM โดยมี 1 โหนดสําหรับผู้เผยแพร่โฆษณาย่อยของ MCM, 1 โหนดสําหรับผู้เผยแพร่โฆษณาหลักของ MCM และเชนดังกล่าวจะมีสถานะเป็นสมบูรณ์แล้ว
การอัปเดตนี้กําหนดให้ผู้เผยแพร่โฆษณาหลักที่มช้การจัดการพื้นที่โฆษณาของ MCM ต้องแชร์รหัสผู้ขาย (SID) ของผู้เผยแพร่โฆษณาย่อยผ่านฟรอนท์เอนด์หรือ API ของ Ad Manager
ตัวอย่างออบเจ็กต์ SupplyChain ที่สมบูรณ์แล้ว
"schain" : {
"ver": "1.0",
"complete" : 1,
"nodes" : [
// Node for MCM child publisher
{
"asi":"mcm-parent-example.com", // This is an example. Be sure to enter the parent's actual domain.
"sid":"52e41fac28963d1e058a106f", // Child’s seller ID within parent’s seller.json
"hp":1,
},
// Node for MCM MI parent
{
"asi":"google.com",
"sid":"pub-1234567891234567", // MCM parent’s publisher ID within Google’s seller.json
"hp":1,
}
]
}
คำถามที่พบบ่อย
ทำไมผู้เผยแพร่โฆษณาหลักที่ใช้ MCM จึงต้องสร้างไฟล์ sellers.json
การทำให้ข้อมูลของพาร์ทเนอร์พร้อมใช้งานแบบสาธารณะโดยให้ข้อมูลดังกล่าวแสดงอยู่ในไฟล์ sellers.json เป็นขั้นตอนสำคัญที่ช่วยให้ผู้ซื้อโฆษณาสามารถตรวจสอบพื้นที่โฆษณาของตน
ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดของ IAB เกี่ยวกับไฟล์ sellers.json
ผู้เผยแพร่โฆษณาย่อยทั้งหมดของฉันต้องมีไฟล์ ads.txt ที่ถูกต้องใช่ไหม
หากไฟล์ ads.txt ของผู้เผยแพร่โฆษณาย่อยไม่มีบรรทัดที่ระบุผู้เผยแพร่โฆษณาหลักที่ใช้ MCM เป็น DIRECT (เช่น MCM-parent-example.com, รหัสผู้ขายของผู้เผยแพร่โฆษณาย่อยที่ใช้ MCM, DIRECT) แต่ระบุรหัสผู้เผยแพร่โฆษณาหลักในบรรทัดของ Google (เช่น google.com, รหัสผู้เผยแพร่โฆษณาของผู้เผยแพร่โฆษณาหลักที่ใช้ MCM, RESELLER, f08c47fec0942fa0) จะส่งผลเสียต่อรายได้หรือไม่ ซัพพลายเชนจะสมบูรณ์ไหม