ओपन बिडिंग इंटिग्रेशन को कॉन्फ़िगर करना

ओपन बिडिंग की मदद से, एक्सचेंज और अन्य खरीदार, Google Ad Manager और AdMob इन्वेंट्री पर बिड करने के लिए, Google की रीयल-टाइम बिडिंग इन्फ़्रास्ट्रक्चर का फ़ायदा ले सकते हैं.

ओपन बिडिंग में हिस्सा लेने के लिए, अपने ओपन बिडिंग के इस्तेमाल के उदाहरण के हिसाब से रीयल-टाइम बिडिंग इंटिग्रेशन कॉन्फ़िगर करें. साथ ही, जांच के लिए अपने Google खाता मैनेजर को बिडर एंडपॉइंट भेजें, ताकि यह पुष्टि की जा सके कि इंटिग्रेशन सही तरीके से काम कर रहा है या नहीं. यह प्रोसेस सिर्फ़ एक बार की जाती है.

चुनिंदा पब्लिशर के साथ इंटिग्रेशन सीमित करना

आपका ओपन बिडिंग इंटिग्रेशन तब तक "निजी मोड" में रह सकता है, जब तक कि आप किसी पब्लिशर से अनुरोध स्वीकार करने के लिए तैयार न हों. निजी मोड में, चुनिंदा पब्लिशर से कनेक्ट करने के लिए, अपनी खाता टीम के साथ काम किया जा सकता है. साथ ही, इस मोड में तब तक बने रहना चाहिए, जब तक कि आपका खाता बड़े पैमाने पर काम करने के लिए तैयार न हो जाए. निजी मोड से बाहर निकलने के बाद, आपका खाता सभी पब्लिशर को दिखेगा.

इस्तेमाल किए जा सकने वाले प्रोटोकॉल और एन्कोडिंग

OpenRTB का इस्तेमाल, JSON या Protobuf फ़ॉर्मैट में किया जा सकता है. ज़्यादा जानें.

Google OpenRTB लागू करना

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

आने वाले बिड रिक्वेस्ट मैनेज करना

ओपन बिडिंग, Authorized Buyers के BidRequest स्ट्रक्चर का इस्तेमाल करती है. हालांकि, कुछ फ़ील्ड सिर्फ़ ओपन बिडिंग में हिस्सा लेने वाले लोगों को भेजे जाते हैं. बिड रिक्वेस्ट में भेजे गए, ओपन बिडिंग से जुड़े फ़ील्ड के बारे में ज़्यादा जानने के लिए, अनुरोध से जुड़ी गाइड देखें.

बिड के साथ जवाब देना

ओपन बिडिंग में भी Authorized Buyers की तरह ही BidResponse स्ट्रक्चर का इस्तेमाल किया जाता है. इसमें ओपन बिडिंग में हिस्सा लेने वाले लोगों को कुछ खास फ़ील्ड भेजे जाते हैं. ओपन बिडिंग से जुड़े उन फ़ील्ड के बारे में ज़्यादा जानने के लिए, जवाब देने से जुड़ी गाइड देखें जिनका इस्तेमाल करके जवाब दिया जा सकता है.

ध्यान दें: ओपन बिडिंग में हिस्सा लेने वाले लोगों को भेजे गए बिड रिक्वेस्ट पर, इन्वेंट्री फ़ॉर्मैट के आधार पर 300 से 1,000 मिलीसेकंड के अंदर जवाब मिल जाना चाहिए. किसी अनुरोध के लिए ज़रूरी शर्त जानने के लिए, BidRequest.tmax फ़ील्ड देखें.

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

• पेज पर अचानक दिखने वाले विज्ञापन
• वीडियो विज्ञापन
• OpenRTB वीडियो विज्ञापन
• नेटिव विज्ञापन
• नेटिव वीडियो विज्ञापन
• Buyer SDK टूल से दिखाए जाने वाले विज्ञापन

अंतर को कम करने के लिए इंप्रेशन ट्रैक करना

हमारा सुझाव है कि आप BidResponse.seatbid.bid.ext.impression_tracking_url फ़ील्ड का इस्तेमाल करें. इससे आपको इंप्रेशन-लेवल का डेटा मिलेगा. इस डेटा से पता चलेगा कि Google, बिल किए जा सकने वाले किन इवेंट को रिकॉर्ड करता है और उनसे आपको शुल्क कब देना होगा.

Google की मांग में अंतर को हल करने की सुविधा (बीटा वर्शन)

इस सुविधा का मकसद यह पक्का करना है कि जिन इंप्रेशन के लिए एक्सचेंज को बिल भेजा जाता है उनकी संख्या, Google Display & Video 360 (DV360) से पेमेंट किए गए इंप्रेशन की संख्या से मेल खाती हो.

ओपन बिडिंग की मदद से दिखाए गए DV360 इंप्रेशन की सटीक पहचान करके, Google विज्ञापन स्पैम और बिलिंग के लायक इवेंट में अंतर को अडजस्ट कर सकता है. इससे यह पक्का किया जा सकता है कि आपको उन इंप्रेशन के लिए बिल न भेजा जाए जिनके लिए आपको पेमेंट नहीं किया जाता.

बिड रिक्वेस्ट में google_query_id को प्रॉपगेट करना

यह पक्का करने के लिए कि Google की मांग के सभी प्लैटफ़ॉर्म पर मान्य इंप्रेशन की संख्या एक जैसी हो, google_query_id को ओपन बिडिंग के अनुरोधों से Google की मांग वाले प्लैटफ़ॉर्म पर जैसा है वैसा ही भेजा जाना चाहिए. यह ओपन बिडिंग में अंतर को हल करने के लिए ज़रूरी है. google_query_id की मौजूदा अनुमानित लंबाई करीब 64 बाइट है.

बिड रिस्पॉन्स में third_party_buyer_token को प्रॉपगेट करना

अगर Google डिमांड प्लैटफ़ॉर्म किसी एक्सचेंज की इंटरनल बिडिंग में जीत जाता है, तो third_party_buyer_token फ़ील्ड को ओपन बिडिंग इंप्रेशन के ज़रिए, बिड रिस्पॉन्स में जैसा है वैसा ही भेजा जाना चाहिए. इससे Google के पब्लिशर प्लैटफ़ॉर्म यह तय कर सकते हैं कि ओपन बिडिंग पार्टनर की जीतने वाली बिड, उसी इंप्रेशन के अवसर के लिए Google की मांग की ओर से लगाई गई बिड है. इस फ़ील्ड की मौजूदा लंबाई 150 बाइट हो सकती है.

बिड रिस्पॉन्स में Google क्रिएटिव मार्कअप को वैसे ही पास करना

यह पक्का करने के लिए कि अंतर को हल करने की सुविधा, Google की मांग से जुड़ी बिड पर लागू हो, किसी एक्सचेंज को बिना किसी रैपर (स्क्रिप्ट टैग, iframes या VAST रैपर) के Google क्रिएटिव मार्कअप को प्रॉपगेट करना ज़रूरी है. अंतर को हल करने की वजह से, Google उन ओपन बिडिंग इंप्रेशन को अमान्य कर सकता है जिन्हें Google के मांग प्लैटफ़ॉर्म ने नहीं गिना था. साथ ही, इनके लिए इनवॉइस भी नहीं भेजा जा सकता. Google, क्रिएटिव मार्कअप की समय-समय पर जांच करेगा. इससे यह पुष्टि की जा सकेगी कि third_party_buyer_token वाली बिड, Google की मांग के आधार पर सबमिट की गई हैं, न कि किसी दूसरे खरीदार की.

HTML5 क्रिएटिव

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

अगर कोई एक्सचेंज, Google एचटीएमएल क्रिएटिव को किसी टैग (script, iframe या अन्य तकनीकों) में रैप करता है, जो बाद में Google एचटीएमएल कोड को लोड या रेंडर करता है, तो Google अंतर को हल नहीं कर पाता.

तकनीकी ज़रूरी शर्तें पूरी करना

इस उदाहरण में, Google (DV360) बिड रिस्पॉन्स से मिले क्रिएटिव एचटीएमएल कोड को हूबहू पास किया जाता है. साथ ही, इसे एक्सचेंज के हिसाब से एचटीएमएल कोड से शुरू और खत्म किया जाता है.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

तकनीकी ज़रूरी शर्तें पूरी न करना

इस उदाहरण में, एक्सचेंज की ओर से दिए गए बिड रिस्पॉन्स में, क्रिएटिव का Google से मिला एचटीएमएल कोड बदला गया है. साथ ही, बिड रिस्पॉन्स में यह कोड पूरी तरह से नहीं दिखता. Google से मिले एचटीएमएल कोड को ब्राउज़र में, एक्सचेंज से मिले रैपर की मदद से रेंडर किया जा सकता है.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

VAST वीडियो क्रिएटिव

अंतर को ठीक करने की सुविधा पाने के लिए, एक्सचेंज को VAST एक्सएमएल रिस्पॉन्स में VASTTagURI को पॉप्युलेट करने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करना होगा:

1. एक्सचेंज, VASTTagURI एलिमेंट की वैल्यू को BidResponse.seatbid.bid.adm फ़ील्ड में Google के दिखाए गए VAST एक्सएमएल दस्तावेज़ के हिस्से के तौर पर जैसा है के तौर पर सेव कर सकता है. साथ ही, आम तौर पर लागू होने वाले एक्सचेंज के हिसाब से मैक्रो एक्सपैंशन का इस्तेमाल कर सकता है.
2. DV360, एक्सचेंज के बिड रिस्पॉन्स में BidResponse.seatbid.bid.adm.nurl फ़ील्ड को VAST दस्तावेज़ के यूआरएल से पॉप्युलेट कर सकता है. इसके बाद, एक्सचेंज उस वैल्यू को VASTTagURI टैग के साथ पास कर सकता है. साथ ही, ज़रूरत के हिसाब से एक्सचेंज के हिसाब से मैक्रो को सामान्य तौर पर बड़ा किया जा सकता है.

ज़रूरत पड़ने पर, एक्सचेंज VAST XML दस्तावेज़ में अतिरिक्त VAST इवेंट और गड़बड़ी ट्रैकर तय कर सकता है.

तकनीकी ज़रूरी शर्तें पूरी करना

इस उदाहरण में, Google (DV360) बिड रिस्पॉन्स से क्रिएटिव VAST यूआरआई को हूबहू पास किया जाता है. साथ ही, एक्सचेंज अपना खास VAST इवेंट और गड़बड़ी ट्रैकर जोड़ता है.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

तकनीकी ज़रूरी शर्तें पूरी न करना

इस उदाहरण में, क्रिएटिव का VAST कोड या Google से मिला यूआरआई, बिड रिस्पॉन्स में पूरी तरह से नहीं दिखता. इसके बजाय, एक्सचेंज के हिसाब से VAST रैपर का इस्तेमाल किया जाता है. SDK टूल के विज्ञापन लोड करने पर, Google के दिए गए VAST कोड को एक्सचेंज के दिए गए VAST रैपर (VASTAdTagURI एलिमेंट, https://video.exchange.example.com/creative?… में बताया गया है) से लोड किया जा सकता है.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

डील

ओपन बिडिंग में हिस्सा लेने वाले एक्सचेंज, ओपन बिडिंग के साथ प्राथमिकता वाली डील (PD), निजी नीलामियों (PA) का इस्तेमाल कर सकते हैं. डील का आईडी और टाइप इस तरह से दिया जाना चाहिए:

फ़ील्ड	ब्यौरा
BidResponse.seatbid.bid.dealid	बिड से जुड़े एक्सचेंज के नेमस्पेस का डील आईडी, जिसकी जानकारी पब्लिशर को दी जाती है. यह यूटीएफ़8 टेक्स्ट है. इसमें 64 से ज़्यादा बाइट नहीं होने चाहिए.
BidResponse.seatbid.bid.ext.exchange_deal_type	डील का टाइप बताने वाला एक एनम. इसकी जानकारी पब्लिशर को दी जाती है. इससे नीलामी में डील के व्यवहार पर असर पड़ता है. वैल्यू इस तरह की हो सकती हैं: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

यहां पीडी/पीए के लिए बिड रिस्पॉन्स का सैंपल दिया गया है.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

कुकी मैचिंग

Google की ओर से होस्ट की जाने वाली मैच टेबल में जानकारी भरने के लिए, ओपन बिडिंग में हिस्सा लेने वाले लोग, अपनी ज़रूरत के हिसाब से इनमें से किसी भी विकल्प का इस्तेमाल कर सकते हैं:

• कुकी मैचिंग: खरीदार या एक्सचेंज की ओर से शुरू की गई मैचिंग ज़्यादा जानें.
• पिक्सल मैचिंग: Google की ओर से शुरू की गई मैचिंग ज़्यादा जानें.
• कुकी मैच असिस्ट: बिड लगाने वाले लोगों या कंपनियों के साथ एक्सचेंज की ओर से शुरू की गई मैचिंग के बारे में ज़्यादा जानें.

ध्यान दें: ओपन बिडिंग में हिस्सा लेने वाले लोग, फ़िलहाल उपयोगकर्ता सूचियां नहीं बना सकते, उनमें जानकारी नहीं जोड़ सकते या उन्हें टारगेट नहीं कर सकते.

इंतज़ार का समय मैनेज करना

आपको पियरिंग गाइड में दी गई ट्रेडिंग लोकेशन का इस्तेमाल करना चाहिए. इससे, आपको यह अनुमान लगाने में मदद मिलेगी कि आने वाले बिड रिक्वेस्ट का जवाब देते समय, बिडर एंडपॉइंट में कितनी देरी होगी.

आम तौर पर, इन्वेंट्री को सबसे नज़दीकी ट्रैडिंग प्लेसमेंट के ज़रिए भेजा जाता है. हालांकि, इसकी कोई गारंटी नहीं है. सभी इंप्रेशन का ऐक्सेस पाने की गारंटी पाने का एक ही तरीका है कि सभी ट्रेडिंग लोकेशन में बिडर एंडपॉइंट हों.

जिन बड़े एक्सचेंज को बिड के ज़्यादा अनुरोध मिलते हैं उन्हें Google के साथ पीयरिंग की सुविधा का इस्तेमाल करना चाहिए. इससे, इंतज़ार का समय और इंतज़ार के समय में होने वाले उतार-चढ़ाव कम हो सकते हैं. पियरिंग के बारे में ज़्यादा जानें.

क्लिक मैक्रो

हमारा सुझाव है कि आप क्लिक मैक्रो लागू करें. इनकी मदद से, रिपोर्टिंग की सुविधा मिलेगी. इसमें आपके खाते और उन पब्लिशर के लिए क्लिक और क्लिक से मिली मेट्रिक शामिल होंगी जिनके साथ आप काम करते हैं. ज़्यादा जानें.

API

ओपन बिडिंग के ग्राहक, Authorized Buyers REST API का इस्तेमाल करके, ऐसा डेटा ऐक्सेस कर सकते हैं जो समस्या हल करने के लिए काम का हो सकता है. फ़िलहाल, सिर्फ़ ये एपीआई संसाधन ऐक्सेस किए जा सकते हैं:

• v1.4 परफ़ॉर्मेंस रिपोर्ट
• v2beta1 आरटीबी से जुड़ी समस्या हल करना

इन एपीआई को ऐक्सेस करने के लिए, अपने खाते को कॉन्फ़िगर करने और एपीआई कॉल करने के लिए ज़रूरी खाता आईडी पाने के लिए, अपने तकनीकी खाता मैनेजर से संपर्क करें. इन एपीआई का इस्तेमाल करने में तकनीकी सहायता पाने के लिए, [e-mail] पर संपर्क करें.

अन्य संसाधन

• कनेक्शन मैनेज करने के सबसे सही तरीके
• बिडिंग यूआरएल मैक्रो का इस्तेमाल करना
• WINNING_PRICE मैक्रो का इस्तेमाल करने पर, कीमत की पुष्टि को डिक्रिप्ट करना
• टेस्टिंग के सुझाव और सबसे सही तरीके

बिड रिक्वेस्ट और रिस्पॉन्स के सैंपल

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