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

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

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

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

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

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

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

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

  • SegmentRequest.site: อธิบายเว็บไซต์ที่แสดงผลการแสดงผล เช่น URL ของเว็บไซต์ ป้อนข้อมูลได้เพียงค่าเดียวจาก SegmentRequest.site และ SegmentRequest.app ใน SegmentRequest
  • SegmentRequest.app: อธิบายแอปที่แสดงผลการแสดงผล เช่น ตัวระบุแอปพลิเคชันเฉพาะแพลตฟอร์มของแอป ป้อนข้อมูลได้เพียง SegmentRequest.site หรือ SegmentRequest.app อย่างใดอย่างหนึ่งใน SegmentRequest
  • SegmentRequest.pub: อธิบายผู้เผยแพร่สื่อที่แสดงผลการแสดงโฆษณา เช่น รหัสของผู้เผยแพร่โฆษณา
  • SegmentRequest.user: อธิบายตัวเลือกของผู้ใช้เกี่ยวกับวิธีประมวลผลข้อมูลส่วนตัว เช่น สตริงความยินยอม TCF
  • SegmentRequest.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"
  }
}

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