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

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

प्रोटो

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

ओपन बीटा Protos

फ़ाइल ब्यौरा वर्शन पिछली बार अपडेट किए जाने की तारीख
openrtb-adx.proto Google के OpenRTB प्रोटोकॉल में कुछ एक्सटेंशन शामिल हैं, जो एक अलग प्रोटो में उपलब्ध कराए जाते हैं. v.172 23 मार्च, 2024
realtime-bidding.proto Google का Authorized Buyers आरटीबी प्रोटोकॉल. यह वही मैसेज है जिसका इस्तेमाल Google, बिड के लिए अनुरोध करने के लिए करता है. BidRequest में, एक ही इंप्रेशन से विज्ञापन स्लॉट शामिल होता है. v.329 14 मार्च, 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 फ़ील्ड में, नो-बिडिंग की वजह से जुड़ी स्टैंडर्ड वैल्यू दी जाएंगी.
पहले से टारगेट किए जा सकने वाले क्रिएटिव एट्रिब्यूट Buyer REST API में दिखाए गए PretargetingConfig संसाधन में supportedCreativeAttribute फ़ील्ड में इस्तेमाल किया जाता है. इस फ़ील्ड में उन क्रिएटिव एट्रिब्यूट के बारे में बताया गया है जो एक ही प्री-टारगेटिंग कॉन्फ़िगरेशन के सभी क्रिएटिव में मौजूद हो सकते हैं.
पब्लिशर को नहीं दिखाए जा सकने वाले क्रिएटिव एट्रिब्यूट इसका इस्तेमाल BidRequest के excluded_attribute फ़ील्ड में किया जाता है. इस फ़ील्ड में उन क्रिएटिव के बारे में बताया गया है जिन्हें पब्लिशर की अनुमति नहीं है. उदाहरण के लिए, वे कुकी के इस्तेमाल की पाबंदियों या मीडिया और/या टेक्स्ट विज्ञापनों की अनुमति पर पाबंदी लगा सकते हैं.
पब्लिशर के वर्टिकल इसका इस्तेमाल BidRequest के detected_vertical फ़ील्ड में किया जाता है. यह फ़ील्ड उस पेज के वर्टिकल (कीवर्ड से मिलते-जुलते ) तय करता है जिस पर विज्ञापन दिखाया जाएगा. Google, इस फ़ील्ड को पेज को क्रॉल करके जनरेट करता है. साथ ही, यह तय करता है कि कौनसे वर्टिकल का इस्तेमाल किया जाता है.
सेलर के नेटवर्क आईडी इसका इस्तेमाल BidRequest के seller_network_id फ़ील्ड में किया जाता है. यह फ़ील्ड उस सेलर नेटवर्क के बारे में बताता है जिससे पब्लिशर जुड़ा है. इस फ़ाइल का कॉन्टेंट, सेलर नेटवर्क आईडी की वैल्यू के आधार पर बढ़ते क्रम में है.
वेंडर इसका इस्तेमाल BidRequest के allowed_vendor_type फ़ील्ड में किया जाता है. यह फ़ील्ड उन रिच मीडिया वेंडर की सूची देता है जो Campaign Monitor और VoiceFive जैसे रिच मीडिया वेंडर को, दिखाए जा रहे क्रिएटिव के लिए अनुमति देते हैं. इसकी जानकारी पब्लिशर ने तय की होगी.

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

रेफ़रंस टेबल (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