रीयल-टाइम में कॉन्टेंट चुनने की सुविधा के बारे में जानकारी

Google, आपकी टारगेट की गई इन्वेंट्री से मैच करने वाले विज्ञापन अनुरोधों के आधार पर, आपके रीयल-टाइम क्यूरेशन इंटिग्रेशन को SegmentRequest भेजता है. SegmentRequest ऑब्जेक्ट, कॉन्टेक्स्ट के हिसाब से सिग्नल या सुरक्षित सिग्नल उपलब्ध कराता है. इनका इस्तेमाल करके यह पता लगाया जा सकता है कि आपके कौनसे सेगमेंट, SegmentResponse में दी गई इन्वेंट्री पर लागू होते हैं. रीयल-टाइम क्युरेशन, JSON फ़ॉर्मैट में भेजे गए SegmentRequest और SegmentResponse ऑब्जेक्ट के साथ काम करता है.

यह गाइड, कॉन्टेंट को रीयल-टाइम में मैनेज करने के प्रोटोकॉल के लिए एक रेफ़रंस है. इससे आपको इंटिग्रेशन बनाने में मदद मिल सकती है.

SegmentRequest

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

इंप्रेशन

एट्रिब्यूट	टाइप	ब्यौरा
id	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. सेगमेंट के अनुरोध के संदर्भ में, इस इंप्रेशन के लिए यूनीक आइडेंटिफ़ायर. वैल्यू 1 से शुरू होती है और n इंप्रेशन के लिए n तक बढ़ती है.
banner	बैनर	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. अगर इंप्रेशन को बैनर विज्ञापन के तौर पर दिखाया जाता है, तो इस फ़ील्ड में जानकारी अपने-आप भर जाती है.
video	वीडियो	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. अगर इंप्रेशन को वीडियो विज्ञापन के तौर पर दिखाया जाता है, तो इस फ़ील्ड में जानकारी अपने-आप भर जाती है.
ext	ImpExt	इसमें Imp ऑब्जेक्ट के एक्सटेंशन शामिल होते हैं.

बैनर

एट्रिब्यूट	टाइप	ब्यौरा
w	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस इंडिपेंडेंट पिक्सल (डीआईपी) में चौड़ाई.
h	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस इंडिपेंडेंट पिक्सल (डीआईपी) में ऊंचाई.
pos	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. स्क्रीन पर विज्ञापन की पोज़िशन. प्लेसमेंट की संभावित जगहों के बारे में ज़्यादा जानने के लिए, AdCOM 1.0 में सूची: प्लेसमेंट की जगहें देखें.

वीडियो

एट्रिब्यूट	टाइप	ब्यौरा
w	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस इंडिपेंडेंट पिक्सल (डीआईपी) में वीडियो प्लेयर की चौड़ाई.
h	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस इंडिपेंडेंट पिक्सल (डीआईपी) में वीडियो प्लेयर की ऊंचाई.
pos	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. स्क्रीन पर विज्ञापन की पोज़िशन. प्लेसमेंट की संभावित जगहों के बारे में ज़्यादा जानने के लिए, AdCOM 1.0 में सूची: प्लेसमेंट की जगहें देखें.

ImpExt

एट्रिब्यूट	टाइप	ब्यौरा
gpid	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. ग्लोबल प्लेसमेंट आईडी के बारे में बताता है. यह पब्लिशर की ओर से तय किया गया एक अलग और परसिस्टेंट आईडी होता है. यह आईडी, पेज पर मौजूद हर विज्ञापन यूनिट के लिए, सप्लाई पाथ में एक जैसा होता है. यह लेख पढ़ें.

साइट

एट्रिब्यूट	टाइप	ब्यौरा
page	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. उस पेज का यूआरएल जिस पर इंप्रेशन दिख रहा है.
mobile	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. इससे पता चलता है कि साइट को मोबाइल डिवाइसों पर देखने के लिए, लेआउट को ऑप्टिमाइज़ करने के लिए प्रोग्राम किया गया है या नहीं. इसमें 0 = नहीं और 1 = हां होता है.

ऐप्लिकेशन

एट्रिब्यूट	टाइप	ब्यौरा
bundle	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. यह प्लैटफ़ॉर्म के हिसाब से ऐप्लिकेशन आइडेंटिफ़ायर होता है. इसका मकसद, ऐप्लिकेशन के लिए यूनीक आइडेंटिफ़ायर बनाना होता है. Android पर, bundle फ़ील्ड, बंडल या पैकेज का नाम होता है. iOS पर, यह अंकों में होता है.

प्रकाशक

एट्रिब्यूट	टाइप	ब्यौरा
id	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. पब्लिशर आईडी, जिसे वेब प्रॉपर्टी कोड के पब्लिशर कोड सफ़िक्स से तय किया जाता है. उदाहरण के लिए, अगर किसी पब्लिशर की वेब प्रॉपर्टी का कोड ca-pub-123 है, तो उसका आईडी pub-123 पर सेट होगा.

उपयोगकर्ता

एट्रिब्यूट	टाइप	ब्यौरा
consent	स्ट्रिंग	यह वेब-सेफ़ आधारित, base64-encoded IAB पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) v2 की सहमति स्ट्रिंग है. इसे पब्लिशर के IAB Consent Management Platform (सीएमपी) से फ़ेच किया जाता है. अगर पब्लिशर ने टीसीएफ़ v2 के लिए सीएमपी के साथ इंटिग्रेट किया है और सीएमपी यह बताता है कि विज्ञापन अनुरोध पर जीडीपीआर लागू होता है और मान्य सहमति स्ट्रिंग उपलब्ध कराता है, तो consent फ़ील्ड भर जाता है. सहमति वाली स्ट्रिंग में शामिल वेंडर के बारे में जानकारी पाने के लिए, IAB की ग्लोबल वेंडर लिस्ट देखें. इसके लिए, vendor-list.consensu.org/v2/vendor-list.json पर जाएं.
eids	EID ऐरे	यह सुविधा सिर्फ़ सुरक्षित सिग्नल क्युरेशन पार्टनर के लिए उपलब्ध है. आईडी के एक्सटेंड किए गए इंस्टेंस. क्युरेशन में, eids फ़ील्ड, पब्लिशर की ओर से उपलब्ध कराया गया डेटा होता है. जैसे, सुरक्षित सिग्नल.

ईआईडी

एट्रिब्यूट	टाइप	ब्यौरा
source	स्ट्रिंग	यह सुविधा सिर्फ़ सुरक्षित सिग्नल क्युरेशन पार्टनर के लिए उपलब्ध है. शामिल किए गए डेटा के सेट के लिए ज़िम्मेदार सोर्स या टेक्नोलॉजी प्रोवाइडर. इसे टॉप-लेवल डोमेन के तौर पर दिखाया जाता है.
uids	UID ऐरे	यह सुविधा सिर्फ़ सुरक्षित सिग्नल क्युरेशन पार्टनर के लिए उपलब्ध है. दिए गए सोर्स से यूआईडी ऑब्जेक्ट का कलेक्शन.

UID

एट्रिब्यूट	टाइप	ब्यौरा
id	स्ट्रिंग	यह सुविधा सिर्फ़ सुरक्षित सिग्नल क्युरेशन पार्टनर के लिए उपलब्ध है. आइडेंटिफ़ायर. कलेक्शन बनाने के दौरान, id फ़ील्ड एक सुरक्षित सिग्नल होता है. सुरक्षित सिग्नल के बारे में ज़्यादा जानने के लिए, Ad Manager का बिड करने वाली इकाइयों और curation पार्टनर के साथ सुरक्षित सिग्नल शेयर करना लेख पढ़ें.

डिवाइस

एट्रिब्यूट	टाइप	ब्यौरा
geo	भौगोलिक	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. उपयोगकर्ता के डिवाइस की जगह की जानकारी.
devicetype	int	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस का सामान्य टाइप. डिवाइस टाइप के बारे में ज़्यादा जानने के लिए, AdCOM 1.0 में सूची: डिवाइस टाइप देखें.
os	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस का ऑपरेटिंग सिस्टम (जैसे, "iOS").
make	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. डिवाइस का मेक (जैसे, "Apple").

Geo

एट्रिब्यूट	टाइप	ब्यौरा
country	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. ISO-3166-1 Alpha-3 स्टैंडर्ड के मुताबिक देश का नाम.
region	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. ISO-3166-2 स्टैंडर्ड का इस्तेमाल करके बनाया गया क्षेत्र का कोड. अगर अमेरिका है, तो दो अक्षरों वाला राज्य का कोड.
metro	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. Google मेट्रो कोड, geo-table.csv फ़ाइल में मौजूद होता है.
city	स्ट्रिंग	यह सुविधा सिर्फ़ कॉन्टेक्स्ट के हिसाब से कॉन्टेंट चुनने वाले पार्टनर के लिए उपलब्ध है. व्यापार और परिवहन की जगहों के लिए, संयुक्त राष्ट्र के कोड का इस्तेमाल करने वाला शहर.

SegmentResponse

एट्रिब्यूट	टाइप	ब्यौरा
segment	Segment ऐरे	सेगमेंट के लिए डिस्क्रिप्टर.

सेगमेंट

एट्रिब्यूट	टाइप	ब्यौरा
segment_id	स्ट्रिंग	सेगमेंट का आईडी. यह आईडी, Marketplace API के curators.dataSegments संसाधन में मौजूद सेगमेंट के नाम में मौजूद curatorDataSegmentId से मेल खाना चाहिए.