ในการดูแลจัดการแบบเรียลไทม์ 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"
}
}
}
}
ปลายทางการดูแลจัดการแบบเรียลไทม์ของสัญญาณที่ปลอดภัย
{
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}]
}
}
ขั้นตอนถัดไป
- ค้นหาไฟล์ข้อมูลอ้างอิงที่ใช้ในการ
ตีความ
SegmentRequestฟิลด์บางรายการ - ดูวิธีตอบกลับด้วย SegmentResponse