ในการดูแลจัดการแบบเรียลไทม์ Google จะส่ง JSON
SegmentRequest
ไปยังปลายทางการดูแลจัดการของคุณเพื่อระบุสัญญาณที่อธิบายการแสดงผลอย่างน้อย 1 รายการ ซึ่งช่วยให้คุณกำหนดกลุ่มข้อมูลที่เกี่ยวข้องสำหรับการแสดงผลแต่ละรายการได้
คู่มือนี้ครอบคลุมการพัฒนาตรรกะการดูแลจัดการที่จัดการ SegmentRequest
ใช้การเข้ารหัส gzip
Google จะใช้การเข้ารหัส gzip เมื่อส่ง SegmentRequest ไปยังปลายทางของคุณ
ปลายทางต้องรับและตอบกลับด้วยการเข้ารหัส gzip ได้
การดูแลจัดการด้วยปลายทางสัญญาณตามบริบทหรือสัญญาณกลุ่มเป้าหมาย
เมื่อสร้างปลายทางของ Real-time Curation คุณต้องเลือกว่าจะรับสัญญาณตามบริบทหรือสัญญาณกลุ่มเป้าหมาย สัญญาณที่คุณเลือกจะส่งผลต่อวิธีสร้างคำขอกลุ่มที่ส่งไปยังปลายทาง ปริมาณพื้นที่โฆษณาที่สร้างคำขอกลุ่มที่ส่งไปยังปลายทาง และตรรกะการดูแลจัดการที่ใช้ในการผสานรวม
ใช้สัญญาณบริบท
สัญญาณตามบริบทประกอบด้วยข้อมูลเกี่ยวกับผู้เผยแพร่โฆษณา อุปกรณ์ และผู้ใช้ ที่อธิบายแหล่งที่มาของการแสดงผล รายการต่อไปนี้อธิบาย สัญญาณที่ใช้ได้
SegmentRequest.site: อธิบายเว็บไซต์ที่แสดงผลการแสดงผล เช่น URL ของเว็บไซต์ ป้อนข้อมูลได้เพียงค่าเดียวจากSegmentRequest.siteและSegmentRequest.appในSegmentRequestSegmentRequest.app: อธิบายแอปที่แสดงผลการแสดงผล เช่น ตัวระบุแอปพลิเคชันเฉพาะแพลตฟอร์มของแอป ป้อนข้อมูลได้เพียงSegmentRequest.siteหรือSegmentRequest.appอย่างใดอย่างหนึ่งในSegmentRequestSegmentRequest.pub: อธิบายผู้เผยแพร่สื่อที่แสดงผลการแสดงโฆษณา เช่น รหัสของผู้เผยแพร่โฆษณาSegmentRequest.user: อธิบายตัวเลือกของผู้ใช้เกี่ยวกับวิธีประมวลผลข้อมูลส่วนตัว เช่น สตริงความยินยอม TCFSegmentRequest.device: อธิบายข้อมูลเกี่ยวกับอุปกรณ์ เช่น ตำแหน่งทางภูมิศาสตร์ของอุปกรณ์ ที่ระดับความแม่นยำระดับเขตเมือง
คุณใช้สัญญาณตามบริบทเพื่อใช้ตรรกะการดูแลจัดการที่สามารถระบุ
กลุ่มเป้าหมายตามข้อมูลที่เกี่ยวข้องเพื่อแสดงใน SegmentResponse ได้
ใช้สัญญาณของกลุ่มเป้าหมาย
สัญญาณของกลุ่มเป้าหมายประกอบด้วยตัวระบุผู้ใช้หรืออุปกรณ์ รวมถึงสัญญาณที่ปลอดภัย
สัญญาณที่ปลอดภัยคือข้อมูลที่ผู้เผยแพร่โฆษณาสร้างขึ้นและเลือกที่จะแชร์
กับพาร์ทเนอร์อย่างน้อย 1 ราย โดยจะมีการปกปิดข้อมูลก่อนแชร์กับ Google
ในคำขอโฆษณา และในการดูแลจัดการแบบเรียลไทม์จะปรากฏในรูปแบบที่ปกปิดข้อมูลใน
SegmentRequest.user.eids.uids.id
หากกำหนดค่าอุปกรณ์ปลายทางให้ใช้สัญญาณของกลุ่มเป้าหมาย อุปกรณ์ปลายทางจะได้รับเฉพาะคำขอกลุ่มสำหรับพื้นที่โฆษณาของผู้เผยแพร่โฆษณาที่เลือกแชร์สัญญาณที่ปลอดภัยกับบัญชีการดูแลจัดการของคุณ ด้วยเหตุนี้ จึงมีจำนวนการแสดงผลทั้งหมดที่มีสิทธิ์ส่งไปยังปลายทางสัญญาณของกลุ่มเป้าหมายน้อยกว่า เมื่อเทียบกับปลายทางสัญญาณบริบท
ตรรกะการดูแลจัดการของปลายทางต้องตีความสัญญาณของกลุ่มเป้าหมายและ
กําหนดกลุ่มเป้าหมายตามข้อมูลที่เกี่ยวข้องเพื่อส่งคืนใน SegmentResponse
ตัวอย่าง SegmentRequest
ปลายทางการดูแลจัดการแบบเรียลไทม์ของสัญญาณตามบริบท
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
ปลายทางของสัญญาณกลุ่มเป้าหมายและการดูแลจัดการแบบเรียลไทม์
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
ขั้นตอนถัดไป
- ค้นหาไฟล์ข้อมูลอ้างอิงที่ใช้ในการ
ตีความ
SegmentRequestฟิลด์บางรายการ - ดูวิธีตอบกลับด้วย SegmentResponse