जवाब तैयार करें

जब आपका ऐप्लिकेशन, Google का बिड रिक्वेस्ट प्रोसेस कर लेता है, तब उसे जवाब भेजना होगा. इस गाइड में बताया गया है कि रिस्पॉन्स तैयार करने के लिए, अपने ऐप्लिकेशन को कैसे कोड करें.

बिड रिस्पॉन्स मैसेज बनाएं

Authorized Buyers, BidRequest को एचटीटीपी POST के मैसेज के मुख्य हिस्से के तौर पर भेजता है. आपके ऐप्लिकेशन से भेजे जाने वाले रिस्पॉन्स में Content-Type हेडर, application/octet-stream पर सेट होना चाहिए. साथ ही, मैसेज का मुख्य भाग ऐसा होना चाहिए कि क्रम के मुताबिक प्रोटोकॉल बफ़र हो. प्रोटोकॉल बफ़र, BidResponse मैसेज होता है, जैसा कि realtime-bidding.proto में बताया गया है. हर BidRequest के जवाब में, आपके ऐप्लिकेशन को पार्स किया जा सकने वाला एक BidResponse मिलना चाहिए. टाइम आउट और उन रिस्पॉन्स को जिन्हें पार्स नहीं किया जा सकता, उन्हें गड़बड़ी माना जाता है. इसके अलावा, Google ज़्यादा गड़बड़ी दर वाले, बिडिंग करने वालों को वापस कर देता है.

अगर आपको किसी इंप्रेशन पर बिड नहीं करनी है, तो सिर्फ़ processing_time_ms फ़ील्ड को सेट करें और बाकी सभी फ़ील्ड को खाली छोड़ दें. आपको realtime-bidding.proto, पहचान डेटा पेज से मिल सकता है.

क्रिएटिव का आईडी

आपका BidResponse, buyer_creative_id फ़ील्ड (64 बाइट की सीमा) का इस्तेमाल करके क्रिएटिव तय करता है. यहां तक कि मिलते-जुलते क्रिएटिव के लिए buyer_creative_id के लिए यूनीक वैल्यू होनी चाहिए, अगर वे किसी भी अहम विशेषता में अलग-अलग हों. इनमें साइज़, बताया गया यूआरएल, क्रिएटिव एट्रिब्यूट, और वेंडर टाइप के अलावा, और भी चीज़ें शामिल हो सकती हैं. दूसरे शब्दों में, आपको इन दो विज्ञापनों को अलग-अलग क्रिएटिव आईडी देना होगा, जो:

  • अलग तरह से देखें या व्यवहार करें.
  • अलग-अलग इमेज रेंडर करें.
  • अलग-अलग तरीकों से रेंडर करना. उदाहरण के लिए, एक विज्ञापन में इमेज और दूसरे में फ़्लैश शामिल है.

अपना ऐप्लिकेशन डिज़ाइन करते समय, आपको आइडेंटिफ़ायर जनरेट करने का एक व्यवस्थित तरीका तय करना चाहिए. यह आइडेंटिफ़ायर जनरेट करने का ऐसा तरीका होना चाहिए जो उन क्रिएटिव टाइप के लिए सही हो जिन्हें आपको सबमिट करना है.

विज्ञापन की अहम जानकारियां

आपको उन क्रिएटिव एट्रिब्यूट का एलान करना होगा जो BidResponse.Ad.attribute में विज्ञापन की विशेषताओं और टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के बारे में पूरी तरह से बताते हों. इन एट्रिब्यूट का एलान करना ज़रूरी है. साथ ही, इस्तेमाल किए जा सकने वाले एट्रिब्यूट की पूरी सूची buyer-declarable-creative-attributes.txt पर देखें:

  • 7 Tagging: IsTagged
    विज्ञापन में एक पिक्सल या वेब बीकन होता है, जिसका इस्तेमाल करके कुकी आईडी की सूची बनाई जाती है, ताकि बाद में रीमार्केटिंग की जा सके.
  • 8 Remarketing: IsRemarketing
    विज्ञापन, उपभोक्ताओं को उनके कुकी आईडी या डिवाइस आईडी के आधार पर टारगेट करता है. हालांकि, कुकी आईडी या डिवाइस आईडी की सूची में उपभोक्ताओं को दिखाया जाता है. ये ऐसे उपभोक्ता होते हैं जिन्होंने पहले किसी ऐसी साइट से इंटरैक्ट किया था जिसके मालिक या कंपनी हैं.
  • 9 UserInterestTargeting: IsUserInterestTargeted
    विज्ञापन, उपभोक्ताओं को उनकी कुकी आईडी या डिवाइस आईडी के आधार पर टारगेट करता है. हालांकि, कुकी आईडी या डिवाइस आईडी की सूची में उपभोक्ताओं को दिखाया जाता है. खरीदारों को कॉमन इंटरेस्ट ग्रुप के तौर पर शामिल किया गया है.
  • 30 InstreamVastVideoType: Vpaid
    विज्ञापन को रेंडर करने के लिए, VPAID सहायता की ज़रूरत है.
  • 32 MraidType: MRAID
    विज्ञापन को रेंडर करने के लिए, MRAID एपीआई की ज़रूरत है.

इसके अलावा, नीचे दिए गए एट्रिब्यूट इस्तेमाल किए जा सकते हैं, लेकिन उनके एलान की ज़रूरत नहीं है. इसकी वजह यह है कि Authorized Buyers, अपने-आप इन एट्रिब्यूट की पहचान करता है. साथ ही, आपके एलान के बजाय, पता लगाई गई वैल्यू के आधार पर आपके क्रिएटिव को ब्लॉक कर देगा या अनुमति देगा. अपने क्रिएटिव की पहचानी गई प्रॉपर्टी के बारे में सुझाव पाने का तरीका जानने के लिए, Creatives API देखें.

  • 34 RichMediaCapabilityType: RichMediaCapabilityFlash
    विज्ञापन को रेंडर करने के लिए, फ़्लैश के साथ काम करने की ज़रूरत है.
  • 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
    विज्ञापन को रेंडर करने के लिए Flash की ज़रूरत नहीं है.
  • 47 RichMediaCapabilityType: RichMediaCapabilitySSL
    विज्ञापन को एसएसएल पेज पर रेंडर किया जा सकता है. ध्यान दें कि Authorized Buyers, इस एट्रिब्यूट के लिए बताई गई अलग-अलग वैल्यू वाले क्रिएटिव को अलग मानते हैं. उनकी अलग से समीक्षा की जाएगी और उनकी मंज़ूरी की स्थिति अलग-अलग होगी. इसलिए, अगर एक ही क्रिएटिव के एसएसएल और एसएसएल न करने वाले, दोनों वर्शन में बिडिंग की जाती है, तो आपको इस एट्रिब्यूट के बारे में जानकारी देनी चाहिए, ताकि AdX में यह अंतर सही तरीके से दिखे.

ओपन बिडिंग फ़ील्ड

ओपन बिडिंग में हिस्सा लेने वाले एक्सचेंज और नेटवर्क बिडर से मिलने वाले बिड रिस्पॉन्स, स्टैंडर्ड रीयल-टाइम बिडिंग में हिस्सा लेने वाले Authorized Buyers से मिलते-जुलते होते हैं. ओपन बिडिंग की सुविधा इस्तेमाल करने वाले ग्राहक, कुछ अतिरिक्त फ़ील्ड तय कर सकते हैं. साथ ही, कुछ मौजूदा फ़ील्ड के लिए अन्य फ़ील्ड का इस्तेमाल भी किया जा सकता है. इनमें नीचे दी गई चीज़ें शामिल हैं:

OpenRTB Authorized Buyers जानकारी
BidResponse.imp[].pmp.deals[].id BidResponse.ad[].adslot[].exchange_deal_id

एक्सचेंज के नेमस्पेस में मौजूद डील आईडी, जो इस बिड से जुड़ा है और पब्लिशर को रिपोर्ट किया जाता है.

BidResponse.seatbid[].bid[].ext.exchange_deal_type BidResponse.ad[].adslot[].exchange_deal_type

पब्लिशर को किस तरह की डील के बारे में बताया गया है. इससे नीलामी में डील के व्यवहार पर असर पड़ता है.

BidResponse.seatbid[].bid[].ext.third_party_buyer_token BidResponse.ad[].adslot[].third_party_buyer_token अगर ओपन बिडर के तौर पर एक्सचेंज, कोई मध्यस्थ है, तो तीसरे पक्ष के असली खरीदार की जानकारी की पहचान करने के लिए, इसका इस्तेमाल किया जाने वाला टोकन. यह जानकारी, तीसरे पक्ष के खरीदार से मिलती है. इसलिए, बिड के जवाब में बिना कोई बदलाव किए, इसे Google को भेजा जाना चाहिए.

सुझाव

  • अपने सर्वर पर स्थायी एचटीटीपीएस कनेक्शन (जिसे "कीप-अलाइव" या "कनेक्शन का फिर से इस्तेमाल" भी कहा जाता है) चालू करें. टाइम आउट की अवधि को कम से कम 10 सेकंड पर सेट करें. कई मामलों में, वैल्यू ज़्यादा होना फ़ायदेमंद होता है. आपके ऐप्लिकेशन के इंतज़ार के समय की शुरुआती जांच के दौरान, Google इसकी पुष्टि करता है. ऐसा इसलिए किया जाता है, क्योंकि Authorized Buyers, ज़्यादा दर पर अनुरोध भेजते हैं. साथ ही, उन्हें हर अनुरोध के लिए एक अलग टीसीपी कनेक्शन बनाने में लगने वाले समय से बचने की ज़रूरत होती है.
  • बिड करने वाले के जीतने के बजाय, इंप्रेशन रेंडर होने पर ट्रैक करने के लिए, वैकल्पिक इंप्रेशन ट्रैकिंग यूआरएल शामिल करें. जीत और रेंडरिंग के बीच ड्रॉप-ऑफ़ होने की वजह से, इससे ट्रैकिंग के ज़्यादा सटीक आंकड़े मिलते हैं.

  • बिड करने वाले के कोड को काम नहीं करने वाले फ़ील्ड पर डिपेंडेंसी के बिना रखें. इन फ़ील्ड की वजह से हो सकता है कि आपकी बिड गड़बड़ियों के साथ काम न करें.
  • अपने BidResponse में BidResponse.Ad.width और BidResponse.Ad.height शामिल करें. कई विज्ञापन साइज़ वाले अनुरोध के BidResponse में, width और height की वैल्यू शामिल होनी चाहिए. ऐसा न करने पर, उसे नीलामी से हटा दिया जाएगा.
  • अपने जवाबों का साइज़ 8 हज़ार से कम रखें. बहुत ज़्यादा जवाब देने पर नेटवर्क के इंतज़ार का समय बढ़ सकता है. इसकी वजह से टाइम आउट भी हो सकता है.
  • उन iOS इन्वेंट्री पर बिड के लिए दिशा-निर्देशों का पालन करें जिनके लिए SKAdNetwork एट्रिब्यूशन की ज़रूरत होती है.

बिड रिस्पॉन्स का उदाहरण

नीचे दिए गए उदाहरण, Protobuf और JSON अनुरोधों के ऐसे सैंपल हैं जिन्हें इंसान पढ़ सकते हैं.

Google

OpenRTB JSON

ओपनआरटीबी प्रोटोबफ़

ज़रूरी जानकारी: सैंपल में दिखाए गए प्रोटोबफ़ मैसेज, यहां इस तरह दिखाए गए हैं कि इन्हें इंसान पढ़ सके. हालांकि, वायर पर मैसेज इस तरह नहीं भेजे जाते हैं. Google या OpenRTB प्रोटोबफ़ फ़ॉर्मैट का इस्तेमाल करते समय, सिर्फ़ क्रम के मुताबिक बिड रिस्पॉन्स मैसेज स्वीकार किए जाएंगे.

नीचे दिए गए C++ कोड का इस्तेमाल करके, BidResponse मैसेज बनाया जा सकता है और उसे क्रम में लगाया जा सकता है:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

क्रिएटिव बताएं

अगर आपकी बोली जीत जाती है, तो आपकी बोली के जवाब से विज्ञापन दिखाने के लिए क्रिएटिव की जानकारी मिलती है. आपकी बिड में, इस्तेमाल किए जा सकने वाले कोई एक विज्ञापन फ़ॉर्मैट (एएमपी, वीडियो, नेटिव) शामिल होना चाहिए. इस उदाहरण में, हम html_snippet फ़ील्ड का इस्तेमाल करके क्रिएटिव की जानकारी देते हैं.

इसके अलावा, आप विज्ञापन फ़ॉर्मैट के आधार पर नीचे दिए गए फ़ील्ड में से एक का इस्तेमाल करके, अपने क्रिएटिव के बारे में बता सकते हैं:

  • SDK टूल से रेंडर किया गया विज्ञापन
    • BidResponse.Ad.sdk_rendered_ad
  • एएमपी
    • BidResponse.Ad.amp_ad_url
  • वीडियो
    • BidResponse.Ad.video_url या
    • BidResponse.Ad.video_vast_xml
  • नेटिव
    • BidResponse.Ad.native_ad

BidResponse के html_snippet फ़ील्ड में एचटीएमएल स्निपेट का इस्तेमाल करके, अपने सर्वर पर होस्ट किए जाने वाले विज्ञापन के बारे में बताएं. स्निपेट को वेब पेज में डाले गए iframe में रखा जाता है, जिसकी वजह से पेज लोड होने पर विज्ञापन को वापस लाया जाता है और रेंडर किया जाता है. आपको एचटीएमएल स्निपेट बनाना होगा, ताकि विज्ञापन (बैनर या इंटरस्टीशियल) किसी iFrame में सही तरह से रेंडर हो सके. साथ ही, उस विज्ञापन स्लॉट के लिए सही साइज़ में हो जिस पर आप बोली लगा रहे हैं.

इसके अलावा, बिड रिस्पॉन्स में दिया गया विज्ञापन साइज़, बिड रिक्वेस्ट में साइज़ कॉम्बिनेशन से पूरी तरह मैच होना चाहिए. ऐसा तब होना चाहिए, जब:

  • विज्ञापन एक सामान्य बैनर होता है (वीडियो, नेटिव या पेज पर अचानक दिखने वाले विज्ञापन नहीं).
  • बिड करने वाले ने बिड रिस्पॉन्स में साइज़ का एलान किया है. अगर अनुरोध में एक से ज़्यादा साइज़ मौजूद हैं, तो साइज़ का एलान करना ज़रूरी है.
  • पेज पर अचानक दिखने वाले विज्ञापनों को अपवाद माना जा सकता है. पेज पर अचानक दिखने वाले विज्ञापनों के लिए, पेज की चौड़ाई, स्क्रीन की चौड़ाई का कम से कम 50% और ऊंचाई, स्क्रीन की ऊंचाई के कम से कम 40% होनी चाहिए.

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

बिड रिस्पॉन्स में दिखाए गए एचटीएमएल स्निपेट के लिए, ज़्यादातर नीतियां तीसरे पक्ष के विज्ञापनों जैसी ही होती हैं. ज़्यादा जानकारी के लिए, Authorized Buyers कार्यक्रम के दिशा-निर्देश, तीसरे पक्ष के विज्ञापन दिखाने के लिए ज़रूरी शर्तें, और विज्ञापनों में क्लिक-थ्रू यूआरएल का एलान देखें.

मैक्रो की जानकारी दें

किसी क्रिएटिव को तय करने वाले एचटीएमएल स्निपेट में, एक या उससे ज़्यादा ऐसे खास कंस्ट्रक्ट शामिल हो सकते हैं जिन्हें मैक्रो कहा जाता है. विज्ञापन दिखाते समय, वैल्यू को मैक्रो से बदल दिया जाता है. उदाहरण के लिए, अगर आपका क्लाइंट बिडिंग ऐप्लिकेशन नीलामी जीत जाता है, तो वह WINNING_PRICE मैक्रो का इस्तेमाल करके, यह पता लगा सकता है कि उसने विज्ञापन के लिए कितने पैसे चुकाए हैं. इस मैक्रो को पार्स करने के लिए, आपको एक ऐसा ऐप्लिकेशन लागू करना होगा जो कीमत की पुष्टि को डिक्रिप्ट करता हो. ज़्यादा जानकारी के लिए, कीमत की पुष्टि करना पेज देखें.

एचटीएमएल स्निपेट के हिस्से के तौर पर, किसी मैक्रो को %%MACRO%% फ़ॉर्मैट में सेट करें. यहां MACRO नीचे दी गई टेबल में मौजूद मैक्रो में से एक है.

Google के मुताबिक यह ज़रूरी है कि आप तीसरे पक्ष से दिखाए जाने वाले विज्ञापन के क्रिएटिव में CLICK_URL_UNESC या CLICK_URL_ESC मैक्रो का इस्तेमाल करें. Google, क्लिक ट्रैकिंग के लिए CLICK_URL मैक्रो का इस्तेमाल करता है.

मैक्रो का इस्तेमाल करने के लिए, इसे विज्ञापन में शामिल करें, ताकि जब कोई व्यक्ति उस पर क्लिक करे, तो यूआरएल फ़ेच हो जाए. फ़ेच करने की रिटर्न वैल्यू, किसी दूसरे यूआरएल पर रीडायरेक्ट होता है, जिसे CLICK_URL में जोड़ा जाता है.

मैक्रो Description
ADVERTISING_IDENTIFIER इंप्रेशन रेंडरिंग पर खरीदारों को iOS IDFA या Android का विज्ञापन आईडी पाने की अनुमति देती है. ज़्यादा जानकारी के लिए, विज्ञापन देने वाले के आइडेंटिफ़ायर को डिक्रिप्ट करना देखें.
CACHEBUSTER बिना किसी क्रम के, चार बाइट वाले पूर्णांक को दिखाने वाला स्ट्रिंग.
CLICK_URL_UNESC

विज्ञापन के लिए वह क्लिक यूआरएल जिसे एस्केप नहीं किया गया है. स्निपेट में, तीसरे पक्ष के क्लिक यूआरएल के एस्केप किए गए वर्शन को सीधे मैक्रो के बाद होना चाहिए.

उदाहरण के लिए, अगर तीसरे पक्ष का क्लिक यूआरएल http://my.adserver.com/some/path/handleclick?click=clk है, तो मैक्रो को शुरू करने के बाद, तीसरे पक्ष के क्लिक यूआरएल के सिंगल-एस्केप्ड वर्शन के साथ इस कोड का इस्तेमाल किया जा सकता है:

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

विज्ञापन दिखाने के समय, यह सीमा इतनी होती है कि:

<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

यूआरएल सबसे पहले क्लिक को Google के साथ रजिस्टर करेगा और फिर तीसरे पक्ष के क्लिक यूआरएल पर रीडायरेक्ट करेगा.

CLICK_URL_ESC

विज्ञापन के लिए एस्केप्ड क्लिक यूआरएल. अगर आपको पहले, किसी दूसरे सर्वर के ज़रिए वैल्यू पास करनी है, तो CLICK_URL_UNESC के बजाय इसका इस्तेमाल करें. सर्वर, रीडायरेक्ट करने के बाद रीडायरेक्ट करेगा.

उदाहरण के लिए, एचटीएमएल स्निपेट में इस कोड का इस्तेमाल किया जा सकता है:

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>

विज्ञापन दिखाने के समय, यह सीमा इतनी होती है कि:

<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>

इससे क्लिक को my.adserver.com के साथ रजिस्टर किया जाएगा, जो google_click_url पैरामीटर में पास किए गए यूआरएल पर रीडायरेक्ट करने के लिए ज़िम्मेदार होगा. इसके लिए यह माना जाता है कि my.adserver.com, google_click_url पैरामीटर को अनएस्केप करता है.

%%CLICK_URL_ESC%% के बाद, डबल-एस्केप्ड यूआरएल जोड़ा जा सकता है. my.adserver.com से एस्केप करना पूरा होने के बाद, यूआरएल का सिंगल-एस्केप्ड वर्शन google_click_url में जुड़ जाता है. google_click_url को फ़ेच करने पर, यह एक बार फिर अन-एस्केप हो जाएगा और फिर रीडायरेक्ट हो जाएगा.

CLICK_URL_ESC_ESC

विज्ञापन के लिए डबल-एस्केप्ड यूआरएल. अगर आपको पहले, किसी दूसरे सर्वर के ज़रिए वैल्यू पास करनी है, तो CLICK_URL_UNESC के बजाय इसका इस्तेमाल करें. सर्वर, रीडायरेक्ट करने के बाद रीडायरेक्ट करेगा.

उदाहरण के लिए, एचटीएमएल स्निपेट में इस कोड का इस्तेमाल किया जा सकता है:

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>

विज्ञापन दिखाने के समय, यह सीमा इतनी होती है कि:

<a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME अगर बिड रिक्वेस्ट के लिए एसएसएल की ज़रूरत नहीं है, तो उसे http: तक बढ़ाया जाता है. अगर बिड अनुरोध के लिए एसएसएल ज़रूरी है, तो https: तक बढ़ाया जाता है.
SITE कॉन्टेंट यूआरएल का यूआरएल-एस्केप्ड डोमेन या पहचान ज़ाहिर न करने वाली इन्वेंट्री के लिए पहचान छिपाने वाला आईडी.
SITE_URL समर्थन नहीं होना या रुकना. इसे SITE मैक्रो से बदल दिया गया है, जो एक जैसा काम करता है.
TZ_OFFSET टाइम-ज़ोन ऑफ़सेट.
VERIFICATION प्रोडक्शन के लिए अलग-अलग वैल्यू और पुष्टि की प्रोसेस में क्रिएटिव को स्कैन किए जाने पर अलग-अलग वैल्यू. फ़ॉर्मैट यह है: %%?VERIFICATION:true-val:false-val%%, जहां मैक्रो के अलावा किसी भी वैल्यू का इस्तेमाल true-val और false-val के लिए किया जा सकता है. इसमें खाली स्ट्रिंग भी शामिल हैं. ओपन बिडिंग के लिए, हमारा सुझाव है कि एक्सचेंज इस मैक्रो का इस्तेमाल करें. ऐसा करने के बाद, डिमांड-साइड प्लैटफ़ॉर्म को बदलाव करने की ज़रूरत नहीं होती.

उदाहरण के लिए, अगर किसी क्रिएटिव में %%?VERIFICATION:-1:5000%% को शामिल किया जाता, तो टेक्स्ट बदलने के लिए 5000 का इस्तेमाल किया जाएगा और पुष्टि की प्रोसेस में -1 होगा. इसकी मदद से, पिंग के इन दो सेट के बीच अंतर किया जा सकता है.
WINNING_PRICE खाते की मुद्रा के माइक्रो में, कोड में बदली गई इंप्रेशन की कीमत (सीपीएम के बजाय, हर इंस्टॉल की लागत (सीपीआई)). उदाहरण के लिए, 5 डॉलर का जीतने वाला सीपीएम 50,00,000 माइक्रो सीपीएम या 5,000 माइक्रो हर इंस्टॉल की लागत (सीपीआई) के बराबर होता है. इस मामले में, WINNING_PRICE की डिकोड की गई वैल्यू 5,000 होगी. जीतने की कीमत, हर इंस्टॉल की लागत (सीपीआई) में बताई जाती है.
WINNING_PRICE_ESC यूआरएल-एस्केप्ड WINNING_PRICE किया गया.

मैक्रो में यूआरएल एस्केपिंग करने के लिए, नीचे दी गई स्कीम का इस्तेमाल किया जाता है:

  • स्पेस वर्ण को प्लस के निशान (+) से बदल दिया जाता है.
  • इस सेट में मौजूद अक्षर और अंकों वाले वर्ण (0-9, a-z, A-Z) और !()*,-./:_~ सेट में मौजूद वर्णों में कोई बदलाव नहीं होगा.
  • बाकी सभी वर्णों को %XX से बदल दिया जाता है. इसमें XX, वर्ण को दिखाने वाला हेक्साडेसिमल नंबर है.

पब्लिशर की पाबंदियां

पब्लिशर, BidRequest का इस्तेमाल करके यह तय करते हैं कि कौनसे विज्ञापन दिखाने की अनुमति है. आपको इन फ़ील्ड में पाबंदियां लागू करनी होंगी:

  • allowed_vendor_type
  • excluded_attribute
  • excluded_sensitive_category

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

अगर BidResponse में एचटीएमएल स्निपेट दिखाया जाता है, तो आपको BidResponse में attribute, category, और click_through_url फ़ील्ड को सही तरीके से सेट करना होगा. अगर किसी विज्ञापन में इन फ़ील्ड के लिए कई लागू मान हैं, तो आपको हर एक मान को शामिल करना होगा. ज़्यादा जानकारी के लिए, BidResponse प्रोटोकॉल बफ़र परिभाषा में इन फ़ील्ड की टिप्पणियों को देखें. जिन जवाबों में ये फ़ील्ड सेट नहीं होते उन्हें खारिज कर दिया जाता है.

BidRequest.excluded_attribute की संभावित वैल्यू ये हैं (publisher-excludable-creative-attributes.txt देखें):

  • 7 Tagging: IsTagged
    अगर विज्ञापनों में पिक्सल या वेब बीकन होता है, ताकि दोबारा मार्केटिंग के लिए कुकी आईडी की सूची बनाई जा सके, तो उन विज्ञापनों को अनुमति नहीं दी जाती.
  • 8 CookieTargeting: IsCookieTargeted
    विज्ञापनों की अनुमति तब नहीं है, जब वे उपभोक्ताओं को उनकी कुकी आईडी के आधार पर टारगेट करते हैं. हालांकि, कुकी आईडी की सूची में उन उपभोक्ताओं को शामिल किया जाता है जिन्होंने पहले कभी खरीदार के मालिकाना हक वाली या उसके प्रतिनिधि के तौर पर किसी साइट से इंटरैक्ट किया था.
  • 9 UserInterestTargeting: IsUserInterestTargeted
    विज्ञापनों की अनुमति तब नहीं है, जब वे उपभोक्ताओं को उनकी कुकी आईडी के आधार पर टारगेट करते हैं. वहीं, कुकी आईडी की सूची में उपभोक्ताओं को एक ही हित वाले ग्रुप के खरीदार के तौर पर दिखाया गया है.
  • 21 CreativeType: Html
    विज्ञापनों को BidResponse.Ad में html_snippet या snippet_template फ़ील्ड का इस्तेमाल करने की अनुमति नहीं है.
  • 22 CreativeType: VastVideo
    BidResponse.Ad में, video_url फ़ील्ड का इस्तेमाल करने की अनुमति नहीं है.
  • 30 InstreamVastVideoType: Vpaid
    विज्ञापनों को रेंडर करने के लिए, VPAID सहायता की ज़रूरत नहीं है.
  • 32 MraidType: MRAID
    विज्ञापनों को रेंडर करने के लिए MRAID एपीआई की ज़रूरत नहीं होती.
  • 34 RichMediaCapabilityType: RichMediaCapabilityFlash
    विज्ञापनों को रेंडर करने के लिए फ़्लैश सपोर्ट की ज़रूरत नहीं है.
  • 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
    विज्ञापनों को रेंडर करने के लिए, HTML5 सुविधाओं की ज़रूरत नहीं होती.
  • 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
    SSL से गैर-एसएसएल अनुरोध करने के लिए विज्ञापनों को अनुमति नहीं है.

इसलिए, अगर excluded_attribute फ़ील्ड में वैल्यू 7 है, तो आपको ऐसा विज्ञापन नहीं दिखाना चाहिए जो सूची बनाने के लिए पिक्सल या वेब बीकन का इस्तेमाल करता हो. ध्यान दें कि अगर कोई विज्ञापन ऐसा करता है, तो उसे BidResponse के एट्रिब्यूट फ़ील्ड में वैल्यू 7 सेट करनी होगी. इसी तरह, अगर excluded_attribute फ़ील्ड में वैल्यू 48 है, तो आपको सिर्फ़ ऐसे विज्ञापन दिखाने चाहिए जो किसी एसएसएल पेज पर रेंडर हो सकें. इसके हिसाब से, एट्रिब्यूट 47 RichMediaCapabilityType: RichMediaCapabilitySSL का एलान करें.

साथ ही, BidRequest का excluded_sensitive_category फ़ील्ड, पहचान डेटा पेज पर मौजूद ad-sensitive-categories.txt फ़ाइल में मौजूद कोड का इस्तेमाल करता है. यहां इनमें से कुछ कोड की ज़्यादा जानकारी दी गई है:

  • 3 Politics
    इसमें राजनैतिक या विवादित सामाजिक मुद्दे शामिल हैं. साथ ही, इसमें समाचार संगठनों के ऐसे विज्ञापन शामिल नहीं हैं जो आम तौर पर मुद्दों पर एक पक्ष के नज़रिए से न जुड़े हों.
  • 4 Dating
    इसमें डेटिंग सेवाएं और ऑनलाइन डेटिंग समुदाय शामिल हैं.
  • 5 Religion
    इसमें धार्मिक विज्ञापन और धार्मिक विचारों के पक्ष या विपक्ष का समर्थन करने वाले विज्ञापन शामिल हैं. इसमें ज्योतिष शास्त्र या धर्म के बिना किसी धर्म का अपमान करने वाली आध्यात्मिकता शामिल नहीं है.
  • 7 Video Games (Casual & Online)
    इनमें वीडियो गेम, ऑनलाइन गेम, और डाउनलोड किए जा सकने वाले गेम शामिल हैं. इसमें वीडियो गेम कंसोल शामिल नहीं हैं.
  • 8 Ringtones & Downloadables
    रिंगटोन के साथ मोबाइल के ऐड-ऑन और डाउनलोड की जा सकने वाली अन्य चीज़ें, जैसे कि डेस्कटॉप पीसी के लिए स्क्रीन सेवर और वॉलपेपर. साथ ही, सोशल नेटवर्क के लिए प्रोफ़ाइल लेआउट और ग्राफ़िक.
  • 10 Get Rich Quick
    तेज़ी से कमाई करने का वादा करने वाली स्कीम.
  • 18 Weight Loss
    इसमें वज़न घटाने, डाइटिंग, और इससे जुड़े प्रॉडक्ट और प्रोग्राम शामिल हैं; इसमें सेहत के लिए बेहतर खान-पान और फ़िटनेस से जुड़े सामान्य विज्ञापन शामिल नहीं हैं.
  • 19 Cosmetic Procedures & Body Modification
    इसमें लिफ़्ट, सक्शन, लेज़र, बाल हटाना और वापस लाना, टैटू, और शरीर में बदलाव करना शामिल है.
  • 23 Drugs & Supplements:
    इसमें दवाएं, विटामिन, सप्लीमेंट, और इनसे जुड़े खुदरा दुकानदार शामिल हैं. हालांकि, नशीली दवाओं के बारे में जानकारी देने वाले संसाधन शामिल नहीं हैं.
  • 24 Sexual & Reproductive Health
    इसमें यौन गतिविधि और प्रजनन की क्षमता से जुड़े विज्ञापन शामिल हैं. हालांकि, इसमें सामान्य गर्भावस्था से जुड़े संसाधन शामिल नहीं हैं.
  • 35 Social Casino Games
    इनमें, जुए से जुड़े नकली गेम शामिल होते हैं, जिनमें बिना किसी सीमा के पोकर, स्लॉट, बिंगो, लॉटरी, खेलों पर सट्टेबाज़ी, रेस पर सट्टेबाज़ी, साथ ही ताश के अन्य गेम, और कसीनो गेम शामिल हैं. इनमें किसी भी कीमती चीज़ (जैसे कि पैसे या इनाम) को जीतने का कोई मौका नहीं होता.
  • 36 Significant Skin Exposure
    विज्ञापन की ऐसी इमेज जिनमें शरीर के शरीर का कोई भी हिस्सा, छाती के बीच से जांघ के बीच तक नहीं पहना गया है. इसके अलावा, शरीर के साथ अंडरवियर, स्विमवियर, लॉन्जरी या अन्य पारदर्शी कपड़े पहने गए हैं. इसके अलावा, तौलिया या चादर जैसे कपड़े पहने नहीं गए हैं.
  • 37 Sensationalism
    ऐसे विज्ञापन जिनका मकसद लोगों की दिलचस्पी बढ़ाकर, उन पर क्लिक करने के लिए उकसाना होता है. इन विज्ञापनों में अक्सर हाइपरबोलिक भाषा या तस्वीरों के साथ टीज़र मैसेज का इस्तेमाल किया जाता है. इसमें ऐसे विज्ञापन शामिल हैं जो सनसनीखेज़ विषयों (जैसे, मशहूर हस्तियों की गिरफ़्तारी, मौत या तलाक) पर केंद्रित होते हैं या जिनका मकसद किसी को चौंकाना होता है.

मेज़रमेंट खोलें

ओपन मेज़रमेंट की मदद से, तीसरे पक्ष के उन वेंडर के बारे में बताया जा सकता है जो मोबाइल ऐप्लिकेशन एनवायरमेंट पर दिखाए जाने वाले विज्ञापनों के लिए, स्वतंत्र मेज़रमेंट और पुष्टि की सेवाएं देते हैं.

फ़िलहाल, इन विज्ञापन फ़ॉर्मैट का इस्तेमाल किया जा सकता है: वीडियो, बैनर, और पेज पर अचानक दिखने वाले विज्ञापन. इन फ़ॉर्मैट वाले बिड रिस्पॉन्स में, ओपन मेज़रमेंट का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी के लिए, मेज़रमेंट SDK टूल खोलें सहायता केंद्र लेख पढ़ें.

सैंपल बिड रिस्पॉन्स

नीचे दिए सेक्शन में अलग-अलग विज्ञापन टाइप के लिए बिड के सैंपल दिखाए गए हैं.

ऐप्लिकेशन बैनर

Google

OpenRTB JSON

ओपनआरटीबी प्रोटोबफ़

ऐप्लिकेशन पर अचानक दिखने वाला विज्ञापन

Google

OpenRTB JSON

ओपनआरटीबी प्रोटोबफ़

ऐप्लिकेशन पर अचानक दिखने वाला वीडियो

Google

ओपनआरटीबी प्रोटोबफ़

ऐप्लिकेशन नेटिव

Google

OpenRTB JSON

ओपनआरटीबी प्रोटोबफ़

वेब वीडियो

Google

एक्सचेंज बिडर के लिए मोबाइल वेब बैनर

ओपनआरटीबी प्रोटोबफ़