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" }
      ]
    }]
  }
}

अगले चरण