Google से बिड रिक्वेस्ट प्रोसेस करने के बाद, आपके ऐप्लिकेशन को जवाब बनाना और भेजना होगा. इस गाइड में, जवाब बनाने के लिए अपने ऐप्लिकेशन को कोड करने का तरीका बताया गया है.
बिड रिस्पॉन्स मैसेज बनाना
बिड सबमिट करने के लिए, आपके बिडिंग ऐप्लिकेशन को बिड रिक्वेस्ट का जवाब देना होगा. इसके लिए, उसे आपके कॉन्फ़िगर किए गए फ़ॉर्मैट में Bid वाले BidResponse के साथ जवाब देना होगा. अगर JSON फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो आपके रिस्पॉन्स में Content-Type हेडर को application/json; charset=utf-8 पर सेट करना होगा. साथ ही, मुख्य हिस्से में JSON BidResponse को शामिल करना होगा. अगर Protobuf फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो आपके ऐप्लिकेशन को Content-Type हेडर को application/octet-stream पर सेट करना होगा. साथ ही, मुख्य हिस्से में सीरियलाइज़ किए गए BidResponse को शामिल करना होगा.
प्रोटोबफ़ फ़ॉर्मैट के लिए BidResponse बनाने और उसे सीरियलाइज़ करने के लिए, आपको openrtb.proto और openrtb-adx.proto के आधार पर प्रोटोबफ़ लाइब्रेरी जनरेट करनी होंगी और उनका इस्तेमाल करना होगा. ये लाइब्रेरी, प्रोटोबफ़ में स्टैंडर्ड OpenRTB BidResponse फ़ील्ड और Google एक्सटेंशन लागू करती हैं. इन्हें प्रोटो और रेफ़रंस डेटा में देखा जा सकता है.
अगर आपको किसी इंप्रेशन पर बिड नहीं करनी है, तो आपको खाली एचटीटीपी 204 रिस्पॉन्स दिखाना होगा. आपके ऐप्लिकेशन को हर BidRequest का जवाब देना होगा. टाइम आउट और ऐसे जवाब जिन्हें पार्स नहीं किया जा सकता, उन्हें गड़बड़ी माना जाता है. साथ ही, Google उन बिडर को थ्रॉटल करता है जिनकी गड़बड़ी की दर ज़्यादा होती है.
क्रिएटिव आईडी
आपका BidResponse, BidResponse.seatbid.bid.crid फ़ील्ड (128 बाइट की सीमा) के ज़रिए क्रिएटिव के बारे में बताता है. एक जैसे क्रिएटिव के लिए भी इस फ़ील्ड में यूनीक वैल्यू होनी चाहिए. ऐसा तब ज़रूरी है, जब वे किसी खास विशेषता में अलग हों. जैसे, साइज़, एलान किया गया यूआरएल, क्रिएटिव एट्रिब्यूट, और वेंडर टाइप. हालांकि, इनके अलावा और भी विशेषताएं हो सकती हैं. इसका मतलब है कि आपको ऐसे किन्हीं दो विज्ञापनों को अलग-अलग क्रिएटिव आईडी देने होंगे जो:
- अलग तरह से दिखना या व्यवहार करना.
- अलग-अलग इमेज रेंडर करना.
- अलग-अलग तरीकों से रेंडर करना. उदाहरण के लिए, एक विज्ञापन में इमेज और दूसरे में वीडियो शामिल हो.
ऐप्लिकेशन डिज़ाइन करते समय, आपको आइडेंटिफ़ायर जनरेट करने का एक व्यवस्थित तरीका तय करना चाहिए. इससे आपको सबमिट किए जाने वाले क्रिएटिव के लिए सही आइडेंटिफ़ायर जनरेट करने में मदद मिलेगी.
विज्ञापन की अहम जानकारियां
Google का सुझाव है कि आप क्रिएटिव एट्रिब्यूट का एलान करें, ताकि आपके विज्ञापन की विशेषताओं और उसकी टारगेटिंग के बारे में जानकारी दी जा सके. इसके लिए, BidResponse.seatbid.bid.apis और BidResponse.seatbid.bid.attr के कॉम्बिनेशन या BidResponse.seatbid.bid.ext.attribute एक्सटेंशन का इस्तेमाल करें. यहां एट्रिब्यूट तय करने का तरीका बताया गया है:
VPAIDBidResponse.seatbid.bid.apisकोVPAID_1याVPAID_2पर सेट करें. JSON फ़ॉर्मैट के लिए, इसे क्रमशः1या2पर सेट किया जा सकता है.MRAIDBidResponse.seatbid.bid.apisकोMRAID_1पर सेट करें या JSON फ़ॉर्मैट के लिए3पर सेट करें.SIZELESSBidResponse.seatbid.bid.attrकोRESPONSIVEपर सेट करें या JSON फ़ॉर्मैट के लिए18पर सेट करें.PLAYABLEइसके लिए,BidResponse.seatbid.bid.attrकोUSER_INTERACTIVEपर सेट करें. इसके अलावा, JSON फ़ॉर्मैट के लिए13पर सेट करें.
अपने क्रिएटिव की पहचानी गई प्रॉपर्टी के बारे में सुझाव पाने का तरीका जानने के लिए, क्रिएटिव संसाधन देखें.
ओपन बिडिंग के फ़ील्ड
ओपन बिडिंग में हिस्सा लेने वाले एक्सचेंज और नेटवर्क बिडर की ओर से भेजे गए बिड रिस्पॉन्स, स्टैंडर्ड रीयल-टाइम बिडिंग में हिस्सा लेने वाले Authorized Buyers के बिड रिस्पॉन्स से मिलते-जुलते होते हैं. ओपन बिडिंग का इस्तेमाल करने वाले ग्राहक, कुछ अतिरिक्त फ़ील्ड तय कर सकते हैं. साथ ही, कुछ मौजूदा फ़ील्ड के अन्य इस्तेमाल भी हो सकते हैं. इनमें ये शामिल हैं:
| फ़ील्ड | विवरण |
|---|---|
BidResponse.imp.pmp.deals.id |
एक्सचेंज के नेमस्पेस का डील आईडी, जो इस बिड से जुड़ा है और जिसकी जानकारी पब्लिशर को दी गई है. |
BidResponse.seatbid.bid.ext.exchange_deal_type |
पब्लिशर को रिपोर्ट की गई डील का टाइप. इससे यह तय होता है कि नीलामी में डील को कैसे मैनेज किया जाएगा. |
BidResponse.seatbid.bid.ext.third_party_buyer_token |
इस टोकन का इस्तेमाल, तीसरे पक्ष के खरीदार की जानकारी की पहचान करने के लिए किया जाता है. ऐसा तब होता है, जब ओपन बिडर के तौर पर एक्सचेंज, मध्यस्थ के तौर पर काम करता है. यह तीसरे पक्ष के खरीदार से मिलता है. इसे बिड रिस्पॉन्स में बिना किसी बदलाव के Google को पास करना ज़रूरी है. |
सुझाव
- अपने सर्वर पर, लगातार बने रहने वाले एचटीटीपीएस कनेक्शन चालू करें. इन्हें "कीप-अलाइव" या "कनेक्शन रीयूज़" भी कहा जाता है. टाइम आउट को कम से कम 10 सेकंड पर सेट करें. ज़्यादा वैल्यू सेट करने से कई मामलों में फ़ायदा होता है. Google, आपके ऐप्लिकेशन के शुरुआती इंतज़ार के समय की जांच के दौरान इसकी पुष्टि करता है. ऐसा इसलिए, क्योंकि Authorized Buyers, अनुरोधों को तेज़ी से भेजता है. साथ ही, उसे हर अनुरोध के लिए अलग टीसीपी कनेक्शन बनाने के इंतज़ार के समय से बचना होता है.
- बैंडविड्थ के इस्तेमाल और नेटवर्क के इंतज़ार के समय को कम करने के लिए, अपने बिड रिस्पॉन्स को कंप्रेस करें. ज़्यादा जानकारी के लिए, बिड रिस्पॉन्स को कंप्रेस करना लेख पढ़ें.
इंप्रेशन ट्रैकिंग यूआरएल को शामिल करें. यह ज़रूरी नहीं है. इससे यह ट्रैक किया जा सकता है कि इंप्रेशन कब रेंडर होता है, न कि बिडर कब जीतता है. जीत और रेंडरिंग के बीच ड्रॉपऑफ़ की वजह से, इससे ज़्यादा सटीक ट्रैकिंग आंकड़े मिलते हैं.
- अपने बिडर कोड को अब इस्तेमाल नहीं किए जा रहे फ़ील्ड पर निर्भर न रखें. इनकी वजह से, आपकी बिड में गड़बड़ियां हो सकती हैं.
- अपने
BidResponseमेंBidResponse.seatbid.bid.wऔरBidResponse.seatbid.bid.hको शामिल करें. एक से ज़्यादा विज्ञापन साइज़ वाले अनुरोध के लिए,BidResponseमें ये फ़ील्ड शामिल होने चाहिए. ऐसा न होने पर, उसे नीलामी से हटा दिया जाएगा. - अपने जवाब का साइज़ 8,000 वर्णों से कम रखें. बहुत बड़े जवाबों की वजह से, नेटवर्क लेटेंसी बढ़ सकती है और टाइम आउट हो सकता है.
- iOS इन्वेंट्री पर बिड करने के लिए, SKAdNetwork एट्रिब्यूशन से जुड़े दिशा-निर्देशों का पालन करें.
बिड रिस्पॉन्स का उदाहरण
यहां Protobuf और JSON अनुरोधों के ऐसे सैंपल दिए गए हैं जिन्हें कोई भी व्यक्ति आसानी से पढ़ सकता है.
OpenRTB प्रोटोबफ़
OpenRTB JSON
अहम जानकारी: सैंपल में दिखाए गए Protobuf मैसेज को यहां किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाले डेटा के तौर पर दिखाया गया है. हालांकि, मैसेज को वायर के ज़रिए इस तरह नहीं भेजा जाता. OpenRTB Protobuf फ़ॉर्मैट का इस्तेमाल करते समय, सिर्फ़ सीरियलाइज़ किए गए BidResponse मैसेज स्वीकार किए जाएंगे.
इस 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.seatbid.bid.ext.sdk_rendered_ad
- एएमपी
BidResponse.seatbid.bid.amp_ad_url
- वीडियो
BidResponse.seatbid.bid.adm
- नेटिव
BidResponse.seatbid.bid.adm_native
BidResponse.seatbid.bid.adm फ़ील्ड में एचटीएमएल स्निपेट का इस्तेमाल करके, अपने सर्वर पर होस्ट किए गए विज्ञापन की जानकारी दें. स्निपेट को वेब पेज में डाले गए iFrame में शामिल किया जाता है. इससे पेज लोड होने पर, विज्ञापन को वापस लाया जाता है और रेंडर किया जाता है. आपको एचटीएमएल स्निपेट को इस तरह से तैयार करना होगा कि विज्ञापन (बैनर या इंटरस्टीशियल) किसी iFrame में सही तरीके से रेंडर हो. साथ ही, विज्ञापन स्लॉट के लिए सही साइज़ में रेंडर हो, जिसके लिए बिडिंग की जा रही है.
इसके अलावा, बिड रिस्पॉन्स में बताए गए विज्ञापन का साइज़, बिड रिक्वेस्ट में बताए गए साइज़ के कॉम्बिनेशन में से किसी एक से पूरी तरह मैच होना चाहिए. ऐसा तब होना चाहिए, जब:
- विज्ञापन एक सामान्य बैनर है. यह वीडियो, नेटिव या इंटरस्टीशियल विज्ञापन नहीं है.
- बिडर ने बिड रिस्पॉन्स में साइज़ की जानकारी दी है. जब अनुरोध में एक से ज़्यादा साइज़ मौजूद हों, तो साइज़ की जानकारी देना ज़रूरी है.
- हालांकि, इंटरस्टीशियल विज्ञापनों के लिए ऐसा नहीं होता. इंटरस्टीशियल विज्ञापनों के लिए, चौड़ाई स्क्रीन की चौड़ाई की कम से कम 50% और ऊंचाई स्क्रीन की ऊंचाई की कम से कम 40% होनी चाहिए.
एचटीएमएल स्निपेट क्रिएटिव को किसी भी ऐसे मान्य एचटीएमएल कोड का इस्तेमाल करके तय किया जा सकता है जो ठीक से रेंडर होता हो. हालांकि, बिड रिस्पॉन्स मैसेज बनाएं सेक्शन में, crid फ़ील्ड को तय करने से जुड़ी पाबंदियों का ध्यान रखें.
इसका एक इस्तेमाल, उन यूआरएल के आर्ग्युमेंट में अतिरिक्त जानकारी डालना है जिन्हें विज्ञापन रेंडर करने के लिए, आपके सर्वर से फ़ेच किया जाता है. इससे आपको अपने सर्वर पर इंप्रेशन के बारे में आर्बिट्रेरी डेटा पास करने की सुविधा मिलती है.
बिड रिस्पॉन्स में दिखाए जाने वाले एचटीएमएल स्निपेट के लिए ज़्यादातर नीतियां, तीसरे पक्ष के विज्ञापनों के लिए बनी नीतियों जैसी ही होती हैं. ज़्यादा जानकारी के लिए, Authorized Buyers प्रोग्राम के दिशा-निर्देश, तीसरे पक्ष के विज्ञापन दिखाने से जुड़ी ज़रूरी शर्तें, और विज्ञापनों में क्लिक-थ्रू यूआरएल का एलान करना लेख पढ़ें.
एक जैसे क्लिकथ्रू यूआरएल इस्तेमाल करना
BidResponse.seatbid.bid.ext.clickurl फ़ील्ड में दिया गया क्लिकथ्रू यूआरएल, आपके क्रिएटिव में दिए गए लैंडिंग पेज के यूआरएल से मेल खाना चाहिए. यहां उन क्रिएटिव के उदाहरण दिए गए हैं जो इस्तेमाल किए जा सकने वाले फ़ॉर्मैट में हैं. ये क्रिएटिव, clickurl फ़ील्ड के लिए सेट की गई वैल्यू https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1 के मुताबिक हैं:
एचटीएमएल
<div id="my-app-install-ad"
style="font-family: sans-serif; border: 1px solid #ddd; padding: 10px;
display: flex; align-items: center; width: 100%; height: 100%;
box-sizing: border-box; cursor: pointer;"
onclick="window.open('https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1', '_blank')">
<img src="https://example.com/path/to/app_icon.png" alt="App Icon"
style="width: 60px; height: 60px; margin-right: 10px;
border-radius: 8px;">
<div style="flex-grow: 1;">
<h4 style="margin: 0 0 5px 0; font-size: 16px; color: #1a73e8;">
My Awesome App
</h4>
<p style="margin: 0 0 10px 0; font-size: 14px; color: #5f6368;">
The best app for doing awesome things! Download now and get started!
</p>
<span style="background-color: #1a73e8; color: white; padding: 8px 12px;
text-align: center; text-decoration: none;
display: inline-block; border-radius: 4px; font-size: 14px;
font-weight: bold;">Install</span>
</div>
</div>VAST एक्सएमएल
<VAST version="3.0"> <Ad id="creative_id_789"> <InLine> <AdSystem>MyBidderSystem</AdSystem> <AdTitle>My Awesome App Install Video</AdTitle> <Description>Install My Awesome App now!</Description> <Error> <![CDATA[https://tracking.example.com/vast_error?errorcode=[ERRORCODE]]]> </Error> <Impression> <![CDATA[https://tracking.example.com/vast_impression]]> </Impression> <Creatives> <!-- Main Video Creative --> <Creative> <Linear> <Duration>00:00:15</Duration> <TrackingEvents> <Tracking event="start"> <![CDATA[https://tracking.example.com/vast_event?label=start]]> </Tracking> <Tracking event="firstQuartile"> <![CDATA[https://tracking.example.com/vast_event?label=firstQuartile]]> </Tracking> <Tracking event="midpoint"> <![CDATA[https://tracking.example.com/vast_event?label=midpoint]]> </Tracking> <Tracking event="thirdQuartile"> <![CDATA[https://tracking.example.com/vast_event?label=thirdQuartile]]> </Tracking> <Tracking event="complete"> <![CDATA[https://tracking.example.com/vast_event?label=complete]]> </Tracking> </TrackingEvents> <VideoClicks> <ClickThrough id="gplay-video"> <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]> </ClickThrough> <ClickTracking id="bidder-tracker-video"> <![CDATA[https://tracking.example.com/vast_click]]> </ClickTracking> </VideoClicks> <MediaFiles> <MediaFile delivery="progressive" type="video/mp4" width="640" height="360" bitrate="800" scalable="true" maintainAspectRatio="true"> <![CDATA[https://cdn.example.com/myawesomeapp_video.mp4]]> </MediaFile> </MediaFiles> </Linear> </Creative> <!-- Companion Ad Creative --> <Creative> <CompanionAds> <Companion id="companion1" width="300" height="250" assetWidth="300" assetHeight="250"> <StaticResource creativeType="image/png"> <![CDATA[https://cdn.example.com/companion_banner_300x250.png]]> </StaticResource> <TrackingEvents> <Tracking event="creativeView"> <![CDATA[https://tracking.example.com/vast_companion_view]]> </Tracking> </TrackingEvents> <CompanionClickThrough> <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]> </CompanionClickThrough> <CompanionClickTracking> <![CDATA[https://tracking.example.com/vast_companion_click]]> </CompanionClickTracking> </Companion> </CompanionAds> </Creative> </Creatives> </InLine> </Ad> </VAST>
मूल भाषा वाला
{ "ver": "1.2", "assets": [ { "id": 1, "title": { "text": "My Awesome App" } }, { "id": 2, "img": { "url": "https://example.com/path/to/app_icon.png", "w": 60, "h": 60 } }, { "id": 3, "data": { "value": "The best app for doing awesome things! Download now and get started!" } }, { "id": 4, "data": { "value": "Install" } } ], "link": { "url": "https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1", "clicktrackers": [ "https://tracking.example.com/native_click" ] }, "imptrackers": [ "https://tracking.example.com/native_impression" ] }
मैक्रो तय करना
मैक्रो, फ़ॉर्मैट किया गया टेक्स्ट होता है. इसे बिड रिस्पॉन्स के कुछ फ़ील्ड में एम्बेड किया जाता है. इन फ़ील्ड में यूआरएल होते हैं. विज्ञापन दिखाने के समय, इन यूआरएल को काम की वैल्यू से बदल दिया जाता है. उदाहरण के लिए, अगर आपकी बिड के साथ शामिल एचटीएमएल स्निपेट क्रिएटिव में AUCTION_PRICE मैक्रो शामिल है, तो मैक्रो को ऐसी वैल्यू से बदल दिया जाएगा जिसे डिक्रिप्ट करके, नीलामी में इंप्रेशन के लिए चुकाई गई रकम का पता लगाया जा सकता है.
इन फ़ील्ड में मैक्रो शामिल किए जा सकते हैं:
-
BidResponse.seatbid.bid.admमैक्रो का इस्तेमाल, एचटीएमएल स्निपेट, नेटिव, वीडियो यूआरएल, और वीडियो VAST एक्सएमएल फ़ॉर्मैट के लिए किया जा सकता है.
-
BidResponse.seatbid.bid.adm_native.eventtrackers.url -
BidResponse.seatbid.bid.adm_native.imptrackers -
BidResponse.seatbid.bid.ext.amp_ad_urlएएमपी क्रिएटिव के लिए, सिर्फ़ Google के
WINNING_PRICEऔरWINNING_PRICE_ESCमैक्रो इस्तेमाल किए जा सकते हैं. -
BidResponse.seatbid.bid.burl -
BidResponse.seatbid.bid.ext.impression_tracking_urlअगर आपको एक से ज़्यादा बिलिंग यूआरएल की ज़रूरत है, तो
BidResponse.seatbid.bid.burlके बजाय इसका इस्तेमाल करें.
उदाहरण के लिए, क्रिएटिव को फ़ेच करने के लिए इस्तेमाल किए गए यूआरएल में ${MACRO} को एम्बेड करके, एचटीएमएल स्निपेट के हिस्से के तौर पर मैक्रो को शामिल किया जा सकता है. यहां MACRO, OpenRTB स्पेसिफ़िकेशन में बताए गए, काम करने वाले मैक्रो में से एक है.
Google मैक्रो
Google, OpenRTB स्पेसिफ़िकेशन में मौजूद मैक्रो के अलावा, अन्य मैक्रो के साथ भी काम करता है. इन्हें अलग तरीके से फ़ॉर्मैट किया जाता है. साथ ही, अगर इन्हें किसी यूआरएल में एम्बेड किया जाता है, तो ये %%MACRO%% के तौर पर दिखेंगे. नीचे दी गई टेबल में, इन मैक्रो के बारे में बताया गया है:
| मैक्रो | ब्यौरा |
|---|---|
ADVERTISING_IDENTIFIER |
इससे खरीदारों को इंप्रेशन रेंडरिंग पर, iOS आईडीएफ़ए या Android का विज्ञापन आईडी मिलता है. ज़्यादा जानकारी के लिए, विज्ञापन के लिए आइडेंटिफ़ायर को डिक्रिप्ट करना लेख पढ़ें. |
CACHEBUSTER |
यह रैंडम, अनसाइंड, और चार बाइट वाले इंटीजर की स्ट्रिंग होती है. |
CLICK_URL_UNESC |
विज्ञापन के लिए, अनएस्केप किया गया क्लिक यूआरएल. स्निपेट में, तीसरे पक्ष के क्लिक यूआरएल का एस्केप किया गया वर्शन, मैक्रो के ठीक बाद होना चाहिए. उदाहरण के लिए, अगर तीसरे पक्ष का क्लिक यूआरएल <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 |
विज्ञापन के लिए एस्केप किया गया क्लिक यूआरएल. अगर आपको वैल्यू को पहले किसी दूसरे सर्वर से पास करना है, तो उदाहरण के लिए, एचटीएमएल स्निपेट में इस कोड का इस्तेमाल किया जा सकता है: <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> इससे क्लिक को
|
CLICK_URL_ESC_ESC |
विज्ञापन के लिए दो बार एस्केप किया गया यूआरएल. अगर आपको पहले वैल्यू को किसी दूसरे सर्वर से पास करना है, जो फिर रीडायरेक्ट को वापस करेगा, तो उदाहरण के लिए, एचटीएमएल स्निपेट में इस कोड का इस्तेमाल किया जा सकता है: <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 |
प्रोडक्शन के लिए अलग-अलग वैल्यू और पुष्टि करने वाली पाइपलाइन में क्रिएटिव को स्कैन करने का समय. इसका फ़ॉर्मैट यह है:
उदाहरण के लिए, अगर किसी क्रिएटिव में |
WINNING_PRICE |
खाते की मुद्रा के माइक्रोज़ में, एन्कोड की गई इंप्रेशन की लागत (यानी, सीपीएम के बजाय सीपीआई). उदाहरण के लिए, 5 डॉलर का विनिंग सीपीएम,50,00, 000 माइक्रोस सीपीएम या 5,000 माइक्रोस सीपीआई के बराबर होता है. इस मामले में, इस मैक्रो को पार्स करने के लिए, आपको एक ऐसा ऐप्लिकेशन लागू करना होगा जो कीमत की पुष्टि करने वाले डेटा को डिक्रिप्ट करता हो. ज़्यादा जानकारी के लिए, कीमत की पुष्टि करने वाले मैसेज को डिक्रिप्ट करना पेज देखें. |
WINNING_PRICE_ESC |
यूआरएल-एस्केप किया गया WINNING_PRICE. |
Google के मुताबिक, आपको तीसरे पक्ष के विज्ञापन के क्रिएटिव में, CLICK_URL_UNESC या CLICK_URL_ESC मैक्रो का इस्तेमाल करना होगा. Google, क्लिक ट्रैकिंग के लिए CLICK_URL मैक्रो का इस्तेमाल करता है.
मैक्रो में यूआरएल एस्केपिंग के लिए, इस स्कीम का इस्तेमाल किया जाता है:
- स्पेस वर्ण को प्लस के निशान (
+) से बदल दिया जाता है. - अक्षर और अंक (0-9, a-z, A-Z) और !()*,-./:_~ सेट के वर्णों में कोई बदलाव नहीं होता.
- अन्य सभी वर्णों को
%XXसे बदल दिया जाता है. यहांXX, वर्ण को दिखाने वाली हेक्साडेसिमल संख्या है.
पब्लिशर की पाबंदियां और ज़रूरी शर्तें
बिड रिक्वेस्ट में, नीलामी में क्रिएटिव पर पब्लिशर की ओर से लगाई गई पाबंदियों और ज़रूरी शर्तों के बारे में जानकारी शामिल होती है.
BidRequest.bcat- इस फ़ील्ड में ब्लॉक की गई कैटगरी की तुलना, सबमिट किए गए क्रिएटिव के लिए पहचानी गई कैटगरी से की जा सकती है. इसके लिए, रीयल-टाइम बिडिंग एपीआई के
detectedCategoriesफ़ील्ड का इस्तेमाल करें.
- इस फ़ील्ड में ब्लॉक की गई कैटगरी की तुलना, सबमिट किए गए क्रिएटिव के लिए पहचानी गई कैटगरी से की जा सकती है. इसके लिए, रीयल-टाइम बिडिंग एपीआई के
BidRequest.imp.ext.allowed_vendor_typeBidRequest.imp.secure- आम तौर पर, इसे हमेशा
trueपर सेट किया जाएगा, क्योंकि Google को सभी क्रिएटिव के लिए एसएसएल की ज़रूरत होती है.
- आम तौर पर, इसे हमेशा
BidRequest.imp.{audio/banner/native/video}BidRequest.imp.{audio/banner/native/video}.apiBidRequest.imp.{audio/banner/native/video}.battrBidRequest.imp.{audio/banner/video}.mimes
ऐसे विज्ञापन के साथ कभी बिड न करें जिसमें प्रतिबंधित सुविधा शामिल हो. अनुमति वाली सुविधाओं के लिए, जैसे कि वेंडर टाइप, विज्ञापन सिर्फ़ तब दिखाएं, जब उसका वेंडर टाइप BidRequest में allowed_vendor_type सूची में हो. बिड रिक्वेस्ट में बताए गए विज्ञापन फ़ॉर्मैट ही आपकी बिड में शामिल होने चाहिए. इसके लिए, BidRequest.imp.banner जैसे फ़ील्ड में जानकारी भरें. ज़्यादा जानकारी के लिए, BidRequest प्रोटोकॉल बफ़र की परिभाषा में इन फ़ील्ड के लिए टिप्पणियां देखें.
अगर BidResponse में कोई विज्ञापन दिखाया जाता है, तो आपको BidResponse में BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat, और BidResponse.seatbid.bid.adomain या BidResponse.seatbid.bid.adm_native.link.url फ़ील्ड को सटीक तरीके से सेट करना होगा. अगर किसी विज्ञापन के लिए इन फ़ील्ड में एक से ज़्यादा वैल्यू लागू होती हैं, तो आपको हर वैल्यू शामिल करनी होगी. ज़्यादा जानकारी के लिए, BidResponse प्रोटोकॉल बफ़र की परिभाषा में इन फ़ील्ड के लिए टिप्पणियां देखें.
जिन जवाबों में ये फ़ील्ड सेट नहीं होते उन्हें खारिज कर दिया जाता है.
Open Measurement
ओपन मेज़रमेंट की मदद से, तीसरे पक्ष के उन वेंडर की जानकारी दी जा सकती है जो मोबाइल ऐप्लिकेशन पर दिखाए जाने वाले विज्ञापनों के लिए, स्वतंत्र तौर पर मेज़रमेंट और पुष्टि करने की सेवाएं देते हैं.
इन विज्ञापन फ़ॉर्मैट का इस्तेमाल किया जा सकता है: वीडियो विज्ञापन, बैनर विज्ञापन, और अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन. इन फ़ॉर्मैट वाले बिड रिस्पॉन्स में ओपन मेज़रमेंट का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, ओपन मेज़रमेंट एसडीके के बारे में सहायता केंद्र में मौजूद लेख पढ़ें.
बिड रिस्पॉन्स के सैंपल
यहां दिए गए सेक्शन में, अलग-अलग तरह के विज्ञापनों के लिए बिड रिस्पॉन्स के सैंपल दिखाए गए हैं.