SegmentRequest को पार्स करें

रीयल-टाइम क्यूरेशन में, Google आपके क्यूरेशन एंडपॉइंट को एक JSON SegmentRequest भेजता है. इससे एक या उससे ज़्यादा इंप्रेशन के बारे में बताने वाले सिग्नल मिलते हैं. इससे आपको हर इंप्रेशन के लिए लागू होने वाले डेटा सेगमेंट का पता चलता है. इस गाइड में, क्यूरेशन लॉजिक डेवलप करने के बारे में बताया गया है. यह लॉजिक, SegmentRequest को मैनेज करता है.

gzip एन्कोडिंग का इस्तेमाल करना

Google, आपके एंडपॉइंट पर SegmentRequest भेजते समय gzip एन्कोडिंग का इस्तेमाल करता है. आपका एंडपॉइंट, gzip एन्कोडिंग का इस्तेमाल करके डेटा पाने और उसका जवाब देने में सक्षम होना चाहिए.

कॉन्टेक्स्ट के हिसाब से सिग्नल या सुरक्षित सिग्नल वाले एंडपॉइंट के साथ क्यूरेशन

रीयल-टाइम क्युरेशन एंडपॉइंट बनाते समय, आपको यह चुनना होगा कि आपको कॉन्टेक्स्ट के हिसाब से सिग्नल चाहिए या सुरक्षित सिग्नल. आपके चुने गए सिग्नल से इन बातों पर असर पड़ता है: आपके एंडपॉइंट को भेजे गए सेगमेंट के अनुरोधों में डेटा कैसे भरा जाता है, कितनी इन्वेंट्री से आपके एंडपॉइंट को सेगमेंट के अनुरोध भेजे जाते हैं, और आपके इंटिग्रेशन में इस्तेमाल किया गया क्यूरेशन लॉजिक.

कॉन्टेक्स्ट के हिसाब से सिग्नल इस्तेमाल करना

सदर्भ के हिसाब से काम आने वाले सिग्नल में पब्लिशर, डिवाइस, और उपयोगकर्ता के बारे में जानकारी शामिल होती है. इससे इंप्रेशन के सोर्स के बारे में पता चलता है. यहां दी गई सूची में, उपलब्ध सिग्नल के बारे में बताया गया है:

  • SegmentRequest.site: यह उस वेबसाइट के बारे में बताता है जिस पर इंप्रेशन दिख रहा है. जैसे, साइट का यूआरएल. SegmentRequest में, SegmentRequest.site और SegmentRequest.app में से सिर्फ़ एक को भरा जा सकता है.
  • SegmentRequest.app: इससे उस ऐप्लिकेशन के बारे में पता चलता है जो इंप्रेशन दिखा रहा है. जैसे, ऐप्लिकेशन का प्लेटफ़ॉर्म के हिसाब से ऐप्लिकेशन आइडेंटिफ़ायर. SegmentRequest में, सिर्फ़ SegmentRequest.site या SegmentRequest.app में से किसी एक को भरा जा सकता है.
  • SegmentRequest.pub: यह इंप्रेशन रेंडर करने वाले मीडिया के पब्लिशर की जानकारी देता है. उदाहरण के लिए, पब्लिशर का आईडी.
  • SegmentRequest.user: इसमें उपयोगकर्ता के पास यह चुनने का विकल्प होता है कि उसके निजी डेटा को कैसे प्रोसेस किया जाए. उदाहरण के लिए, टीसीएफ़ की सहमति स्ट्रिंग के साथ.
  • SegmentRequest.device: इसमें डिवाइस के बारे में जानकारी होती है. जैसे, मेट्रो-लेवल की सटीक जानकारी के साथ डिवाइस की भौगोलिक जगह की जानकारी.

कॉन्टेक्स्ट के हिसाब से काम करने वाले सिग्नल का इस्तेमाल करके, क्यूरेशन लॉजिक लागू किया जा सकता है. इससे यह तय किया जा सकता है कि SegmentResponse में कौनसे डेटा सेगमेंट दिखाए जाएं.

सुरक्षित सिग्नल का इस्तेमाल करना

सुरक्षित सिग्नल, पब्लिशर का बनाया गया ऐसा डेटा होता है जिसे वह एक या उससे ज़्यादा पार्टनर के साथ शेयर करता है. विज्ञापन अनुरोध में 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" }
      ]
    }]
  }
}

अगले चरण