प्रोटोस और एएमपी; रेफ़रंस डेटा

आरटीबी प्रोटोकॉल के साथ काम करने वाली फ़ाइलें देखना या डाउनलोड करना.

Protos

फ़ाइल ब्यौरा वर्शन पिछली बार अपडेट किए जाने की तारीख
cookie-bulk-upload.proto उपयोगकर्ता टारगेटिंग डेटा को एक साथ अपलोड करने के लिए, इस मैसेज का इस्तेमाल करें. v.24 27 मार्च, 2024
openrtb.proto Google, JSON या Protobuf एन्कोडिंग का इस्तेमाल करके, OpenRTB प्रोटोकॉल के साथ काम करता है. OpenRTB/Protobuf का इस्तेमाल करने पर, यह प्रोटोकॉल ज़रूरी है. इसमें, काम करने वाले फ़ील्ड और Google के नेटिव प्रोटोकॉल के साथ उनकी मैपिंग का दस्तावेज़ भी शामिल होता है. 2.6 31 अक्टूबर, 2024
openrtb-adx.proto Google के OpenRTB प्रोटोकॉल में कुछ एक्सटेंशन शामिल होते हैं, जिन्हें अलग प्रोटो में उपलब्ध कराया जाता है. v.180 01 नवंबर, 2024
publisher-settings.proto रीयल-टाइम बिडर नेटवर्क के लिए खास तौर पर पब्लिशर सेटिंग का सेट. v.13 5 फ़रवरी, 2024
realtime-bidding.proto Google का Authorized Buyers आरटीबी प्रोटोकॉल. Google इस मैसेज का इस्तेमाल, बिड का अनुरोध करने के लिए करता है. BidRequest में, किसी एक इंप्रेशन का विज्ञापन स्लॉट शामिल होता है. v.331 01 नवंबर, 2024

ओपन बीटा प्रोटोटाइप

फ़ाइल ब्यौरा वर्शन पिछली बार अपडेट किए जाने की तारीख
openrtb-adx.proto Google के OpenRTB प्रोटोकॉल में कुछ एक्सटेंशन शामिल होते हैं, जो एक अलग प्रोटो में दिए जाते हैं. v.186 1 नवंबर, 2024
realtime-bidding.proto Google का Authorized Buyers आरटीबी प्रोटोकॉल. Google इस मैसेज का इस्तेमाल, बिड का अनुरोध करने के लिए करता है. BidRequest में, एक इंप्रेशन का विज्ञापन स्लॉट शामिल होता है. v.342 31 अक्टूबर, 2024

संदर्भ डेटा

डिक्शनरी (.txt फ़ाइल डाउनलोड करने के लिए क्लिक करें)
विज्ञापन की प्रॉडक्ट कैटगरी BidRequest के excluded_product_category फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में उन प्रॉडक्ट और सेवाओं की कैटगरी के बारे में बताया गया है जिनके लिए पब्लिशर ने अनुमति नहीं दी है. उदाहरण के लिए, अगर पब्लिशर को ऑनलाइन बैंकिंग से जुड़े विज्ञापन होस्ट नहीं करने हैं.
विज्ञापन पर पाबंदी वाली कैटगरी इसका इस्तेमाल, BidRequest के allowed_restricted_category फ़ील्ड और BidResponse के restricted_category फ़ील्ड में किया जाता है. allowed_restricted_category फ़ील्ड में उन कैटगरी के बारे में बताया जाता है जिन पर आम तौर पर पाबंदी होती है. हालांकि, पब्लिशर ने इन कैटगरी के लिए साफ़ तौर पर अनुमति दी हो. उदाहरण के लिए, शराब से जुड़े कॉन्टेंट वाले विज्ञापन.
संवेदनशील विज्ञापन कैटगरी BidRequest के excluded_sensitive_category फ़ील्ड और BidResponse के category फ़ील्ड में इस्तेमाल किया जाता है. excluded_sensitive_category फ़ील्ड में, संवेदनशील कैटगरी के बारे में बताया जाता है जिनकी अनुमति पब्लिशर नहीं देता. उदाहरण के लिए, अगर पब्लिशर को राजनीति से जुड़े विज्ञापन होस्ट नहीं करने हैं.
विज्ञापन देने वाले इसका इस्तेमाल SnippetStatusItem के advertiser_id फ़ील्ड में किया जाता है. इस फ़ील्ड से, स्निपेट से जुड़े क्रिएटिव से विज्ञापन देने वाले के बारे में पता चलता है. इस सूची में, एक्सचेंज में मौजूद विज्ञापन देने वाले सभी लोग दिखते हैं. इसमें, किसी एक खरीदार के ज़रिए दिखाए जाने वाले विज्ञापन देने वाले लोग नहीं दिखते.
ब्रैंड क्लाइंट ऐक्सेस एपीआई में इस्तेमाल किए जाने वाले ब्रैंड की सूची.
क्रिएटिव के लिए, खरीदार के बताए जाने वाले एट्रिब्यूट BidResponse में attribute फ़ील्ड के लिए इस्तेमाल किया जाता है. इस फ़ील्ड में, क्रिएटिव पर खरीदार के एलान वाले ऐसे एट्रिब्यूट के बारे में बताया गया है जो BidRequest में excluded_attribute में नहीं दिखने चाहिए.
कॉलआउट के स्टेटस कोड performancereport वाले तरीके के कॉल से मिले स्टेटस कोड.
कॉन्टेंट लेबल BidRequest के detected_content_labels फ़ील्ड में इस्तेमाल किया जाता है.
कुकी मैचर के स्टेटस कोड इसका इस्तेमाल आरटीबी प्रोटोकॉल परफ़ॉर्मेंस रिपोर्ट के cookieMatcherStatusRate फ़ील्ड में किया जाता है. उपलब्ध कोड के बारे में कुकी मैचिंग के लिए बनी गाइड में बताया गया है.
क्रिएटिव के स्टेटस कोड

इसमें इस्तेमाल की गईं

creative_status_code को रीयल-टाइम में सुझाव, राय या शिकायत के तौर पर दिखाया गया.
होस्ट किए गए मैच के स्टेटस कोड इसका इस्तेमाल आरटीबी प्रोटोकॉल परफ़ॉर्मेंस रिपोर्ट के hostedMatchStatusRate फ़ील्ड में किया जाता है.
बोली लगाने की कोई वजह नहीं है बिड न देने की वजह की स्टैंडर्ड वैल्यू, Authorized Buyers बिड प्रोटोकॉल में BidResponse.no_bid_reason फ़ील्ड में दी जानी चाहिए.
पहले से टारगेट किए जा सकने वाले क्रिएटिव एट्रिब्यूट Buyer REST API में दिखाए गए, PretargetingConfig संसाधन के supportedCreativeAttribute फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में, उन क्रिएटिव एट्रिब्यूट के बारे में बताया गया है जो किसी एक प्री-टारगेटिंग कॉन्फ़िगरेशन से जुड़े सभी क्रिएटिव में मौजूद होने चाहिए.
पब्लिशर के लिए, क्रिएटिव में शामिल न किए जाने वाले एट्रिब्यूट BidRequest के excluded_attribute फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में उन क्रिएटिव टाइप के बारे में बताया गया है जिन्हें पब्लिशर की अनुमति नहीं है. उदाहरण के लिए, वे इस बात पर पाबंदियां लगा सकते हैं कि कुकी का इस्तेमाल किया जा सकता है या नहीं या मीडिया और/या टेक्स्ट विज्ञापनों को दिखाने की अनुमति है या नहीं.
पब्लिशर वर्टिकल BidRequest के detected_vertical फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड से उस पेज के वर्टिकल (कीवर्ड की तरह) की जानकारी मिलती है जिस पर विज्ञापन दिखाया जाएगा. Google, पेज को क्रॉल करके और यह तय करके यह फ़ील्ड जनरेट करता है कि किन वर्टिकल का इस्तेमाल किया जाता है.
वेंडर BidRequest के allowed_vendor_type फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में, रिच मीडिया वेंडर की सूची दी जाती है. जैसे,

इसमें, बंद की गई gdn-vendors.txt डिक्शनरी फ़ाइल के वेंडर शामिल हैं.
डेटा उपलब्ध करवाने वाली कंपनियां BidRequest के SegmentData.id फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में उस इकाई के बारे में जानकारी होती है जिसने पब्लिशर से मिले सिग्नल उपलब्ध कराए थे.

रेफ़रंस टेबल (CSV डाउनलोड करने के लिए क्लिक करें)
Android मोबाइल ऐप टारगेट किए जा सकने वाले Android मोबाइल ऐप्लिकेशन की सूची. इसमें ऐप्लिकेशन आईडी, कैटगरी आईडी, और ऐप्लिकेशन के ऐसे नाम शामिल होते हैं जिन्हें कोई भी पढ़ सकता है.
जियो टेबल BidRequest के geo_criteria_id फ़ील्ड को डिकोड करने के लिए इस्तेमाल की जाने वाली टेबल. ज़्यादा जानकारी के लिए, जियोटारगेटिंग देखें.
एलजीपीडी की सेवा देने वाली कंपनियां दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा देने वाली कंपनियों की सूची, जो एलजीपीडी ट्रैफ़िक पर विज्ञापन दिखा सकती है. साथ ही, इसमें उनका आईडी, ऐसा नाम, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता हो, निजता का यूआरएल, और उन डोमेन की सूची शामिल होती है जिनका नाम सेवा देने वाली कंपनी को दिया जा सकता है. एलजीपीडी को लागू करने का तरीका, दिए गए बिड रिक्वेस्ट पर Authorized Buyers बिडिंग प्रोटोकॉल में BidRequest.adslot.regs_lgpd फ़ील्ड और OpenRTB बिड प्रोटोकॉल में BidRequest.regs.ext.lgpd फ़ील्ड के ज़रिए दिखाया जाता है.
मोबाइल और इंटरनेट सेवा देने वाली कंपनियां मोबाइल और इंटरनेट सेवा देने वाली कंपनियों की सूची.
मोबाइल डिवाइस मोबाइल डिवाइसों की सूची.
मोबाइल ऑपरेटिंग सिस्टम मोबाइल ऑपरेटिंग सिस्टम की सूची.
सेवा देने वाली कंपनियां विज्ञापनों को मनमुताबिक बनाने की सुविधा देने वाली कंपनी के आईडी को, मनुष्य के पढ़ने लायक नाम, निजता नीति के यूआरएल, और उन डोमेन की सूची से मैप करता है जिन्हें सेवा देने वाली कंपनी को एट्रिब्यूट किया जा सकता है. फ़िलहाल, AdX प्रोटोकॉल के लिए BidRequest.AdSlot.consented_providers_settings फ़ील्ड और OpenRTB प्रोटोकॉल के लिए BidRequest.User.UserExt.consented_providers_settings फ़ील्ड में, सेवा देने वाली कंपनियों का इस्तेमाल किया जाता है. इन फ़ील्ड में, सूची में शामिल सेवा देने वाली कंपनियों के पास उपयोगकर्ता की सहमति है. यह सहमति, यूरोपियन इकनॉमिक एरिया के देशों में रहने वाले उपयोगकर्ताओं के लिए, पब्लिशर ने दी है.

प्रकाशक सेटिंग

अपने खाते के प्रतिनिधि से publisher-settings.pb.gz फ़ाइल का अनुरोध करें.

क्रिएटिव समीक्षा की नीति के विषय

इस फ़ाइल में नीति से जुड़े विषयों का इस्तेमाल करके, रीयल-टाइम बिडिंग एपीआई में समीक्षा के दौरान क्रिएटिव को फ़िल्टर किया जा सकता है

नीति के विषयों को CSV फ़ाइल के तौर पर डाउनलोड करें.

पिछले अपडेट की तारीख: 18 अप्रैल, 2022