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

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

प्रोटोस

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

बीटा Protos खोलें

फ़ाइल ब्यौरा वर्शन पिछली बार अपडेट किए जाने की तारीख
openrtb-adx.proto Google के OpenRTB प्रोटोकॉल में कुछ एक्सटेंशन शामिल होते हैं, जो एक अलग प्रोटो में दिए जाते हैं. v.179 24 मई, 2024
realtime-bidding.proto Google का Authorized Buyers आरटीबी प्रोटोकॉल. इस मैसेज का इस्तेमाल Google, बिड के लिए अनुरोध करने के लिए करता है. BidRequest में, एक इंप्रेशन का विज्ञापन स्लॉट शामिल होता है. v.338 24 मई, 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 फ़ील्ड, ऐसी संवेदनशील कैटगरी के बारे में बताता है जिन्हें पब्लिशर ने अनुमति नहीं दी है. उदाहरण के लिए, ऐसा तब हो सकता है, जब पब्लिशर, राजनीति से जुड़े विज्ञापनों को होस्ट न करना चाहता हो.
विज्ञापन देने वाले इसका इस्तेमाल स्निपेटStatusItem के advertiser_id फ़ील्ड में किया जाता है. इस फ़ील्ड में, स्निपेट से जुड़े क्रिएटिव से जुड़े विज्ञापन देने वाले के बारे में बताया जाता है. इस सूची में, एक्सचेंज में विज्ञापन देने वाले लोगों या कंपनियों को दिखाया जाता है. इसमें उन विज्ञापन देने वालों के बारे में नहीं बताया जाता जिनका प्रतिनिधित्व किसी एक खरीदार ने किया है.
ब्रैंड Client Access API में इस्तेमाल किए जाने वाले ब्रैंड की सूची.
खरीदार के एलान किए जा सकने वाले क्रिएटिव एट्रिब्यूट BidResponse में attribute फ़ील्ड के लिए इस्तेमाल किया जाता है. यह फ़ील्ड, क्रिएटिव पर उन एट्रिब्यूट के बारे में जानकारी देता है जिन्हें खरीदार ने एलान किया है. ये एट्रिब्यूट, BidRequest में excluded_attribute में नहीं दिखने चाहिए.
कॉलआउट स्टेटस कोड performancereport तरीके कॉल से मिले स्टेटस कोड.
कॉन्टेंट लेबल BidRequest के detected_content_labels फ़ील्ड में इस्तेमाल किया जाता है.
कुकी मैचर के स्टेटस कोड इसका इस्तेमाल आरटीबी प्रोटोकॉल परफ़ॉर्मेंस रिपोर्ट के cookieMatcherStatusRate फ़ील्ड में किया जाता है. कुकी मैचिंग गाइड में उपलब्ध कोड के बारे में बताया गया है.
क्रिएटिव के स्टेटस कोड

इतनी सेवाओं में इस्तेमाल हो रहा है

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

इसमें बंद हो चुकी gdn-vendors.txt डिक्शनरी फ़ाइल में मौजूद वेंडर शामिल हैं.

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

रेफ़रंस टेबल (CSV फ़ाइलें डाउनलोड करने के लिए क्लिक करें)

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

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

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

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

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

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

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