แยกวิเคราะห์ SegmentRequest

ในการดูแลจัดการแบบเรียลไทม์ Google จะส่ง JSON SegmentRequest ไปยังปลายทางการดูแลจัดการของคุณเพื่อระบุสัญญาณที่อธิบายการแสดงผลอย่างน้อย 1 รายการ ซึ่งช่วยให้คุณ กำหนดกลุ่มข้อมูลที่เกี่ยวข้องสําหรับการแสดงผลแต่ละรายการได้ คู่มือนี้ครอบคลุมการพัฒนาตรรกะการดูแลจัดการ ที่จัดการ SegmentRequest

ใช้การเข้ารหัส gzip

Google จะใช้การเข้ารหัส gzip เมื่อส่ง SegmentRequest ไปยังปลายทางของคุณ ปลายทางต้องรับและตอบกลับด้วยการเข้ารหัส gzip ได้

การดูแลจัดการด้วยปลายทางสัญญาณตามบริบทหรือสัญญาณที่ปลอดภัย

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

ใช้สัญญาณบริบท

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

  • SegmentRequest.site: อธิบายเว็บไซต์ที่แสดงผลการแสดงผล เช่น URL ของเว็บไซต์ ป้อนข้อมูลได้เพียง 1 รายการใน SegmentRequest.site และ SegmentRequest.app ใน SegmentRequest
  • SegmentRequest.app: อธิบายแอปที่แสดงผลการแสดงผล เช่น ตัวระบุแอปพลิเคชันเฉพาะแพลตฟอร์มของแอป ป้อนข้อมูลได้เพียง SegmentRequest.site หรือ SegmentRequest.app อย่างใดอย่างหนึ่งใน SegmentRequest
  • SegmentRequest.pub: อธิบายผู้เผยแพร่สื่อที่แสดงผลการแสดงโฆษณา เช่น รหัสของผู้เผยแพร่โฆษณา
  • SegmentRequest.user: อธิบายตัวเลือกของผู้ใช้เกี่ยวกับวิธีประมวลผลข้อมูลส่วนตัวของผู้ใช้ เช่น สตริงความยินยอมของ TCF
  • SegmentRequest.device: อธิบายข้อมูลเกี่ยวกับอุปกรณ์ เช่น ตำแหน่งทางภูมิศาสตร์ของอุปกรณ์ที่ระดับความแม่นยำของเขตเมือง

คุณสามารถใช้สัญญาณตามบริบทเพื่อใช้ตรรกะการดูแลจัดการที่สามารถระบุกลุ่มข้อมูลที่เกี่ยวข้องเพื่อส่งคืนใน SegmentResponse ได้

ใช้สัญญาณที่ปลอดภัย

สัญญาณที่ปลอดภัยคือข้อมูลที่ผู้เผยแพร่โฆษณาสร้างขึ้นและเลือกที่จะแชร์กับพาร์ทเนอร์อย่างน้อย 1 ราย ระบบจะปกปิดข้อมูลดังกล่าวก่อนที่จะแชร์กับ Google ในคำขอโฆษณา และใน Real-time Curation จะปรากฏในรูปแบบที่ปกปิดใน 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" }
      ]
    }]
  }
}

ขั้นตอนถัดไป