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

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

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

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

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

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

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

Google OpenRTB लागू करने की सुविधा

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

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

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

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

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

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

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

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

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

हमारा सुझाव है कि आप 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 की मांग से मिली बोलियों पर लागू हो, एक्सचेंज को Google क्रिएटिव मार्कअप को बिना किसी रैपर (स्क्रिप्ट टैग, iframe या VAST रैपर) के फैलाना होगा. डिसक्रेपेंसी को ठीक करने के लिए, 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 वीडियो क्रिएटिव

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

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

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

तकनीकी शर्तों को पूरा करता हो

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

<!-- 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 -->

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

इस उदाहरण में, Google से मिला क्रिएटिव VAST कोड या यूआरआई, बिड रिस्पॉन्स में हूबहू नहीं दिखता. इसके बजाय, एक्सचेंज के हिसाब से VAST रैपर का इस्तेमाल किया जाता है. Google की ओर से उपलब्ध कराया गया वीएएसटी कोड, विज्ञापन दिखाने के लिए एसडीके लोड होने पर, एक्सचेंज की ओर से उपलब्ध कराए गए वीएएसटी रैपर (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 -->

डील

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

फ़ील्ड	ब्यौरा
BidResponse.seatbid.bid.dealid	एक्सचेंज के नेमस्पेस से जुड़ा वह डील आईडी जो बिड से जुड़ा है और जिसे पब्लिशर को रिपोर्ट किया गया है. यह कोई भी UTF8 टेक्स्ट हो सकता है और यह 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 पर होस्ट की गई मैच टेबल को भरने के लिए, ओपन बिडिंग में हिस्सा लेने वाले लोग या कंपनियां, नीचे दिए गए विकल्पों में से किसी भी विकल्प का इस्तेमाल कर सकती हैं. हालांकि, उन्हें अपनी ज़रूरतों के हिसाब से सही विकल्प चुनना होगा:

• कुकी मैचिंग: खरीदार या एक्सचेंज की ओर से शुरू की गई मैचिंग ज़्यादा जानें.
• Pixel Matching: Google-initiated matching Learn more.
• कुकी मैच असिस्ट: एक्सचेंज, बिड लगाने वालों के साथ मैचिंग शुरू करता है ज़्यादा जानें.

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

लेटेंसी मैनेज करना

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

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

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

क्लिक मैक्रो

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

API

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

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

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

अन्य संसाधन

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

बिड अनुरोध और रिस्पॉन्स के उदाहरण

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