खरीदार के SDK टूल का विज्ञापन फ़ॉर्मैट

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

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

बिड में, खरीदार के SDK टूल से रेंडर किया गया विज्ञापन या Google Mobile Ads SDK के साथ काम करने वाला कोई भी अन्य विज्ञापन फ़ॉर्मैट शामिल किया जा सकता है. हालांकि, दोनों को शामिल करने वाली बिड फ़िल्टर कर दी जाती हैं.

ज़रूरी शर्तें

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

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

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

बिड रिक्वेस्ट

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

SDK टूल का आईडी

बिड रिक्वेस्ट का इस्तेमाल करके, SDK टूल का वह आईडी ढूंढा जा सकता है जिसे आपको बिड रिस्पॉन्स में BidRequest.app.ext.installed_sdk.id फ़ील्ड के साथ देना होगा.

इस बारे में ज़्यादा जानने के लिए, InstalledSdk रेफ़रंस दस्तावेज़ देखें.

विज्ञापन यूनिट की मैपिंग

बिड रिक्वेस्ट का इस्तेमाल करके, BidRequest.imp.ext.ad_unit_mapping फ़ील्ड के साथ बिड स्लॉट से मैच करने वाली विज्ञापन यूनिट मैपिंग ढूंढी जा सकती हैं.

इस बारे में ज़्यादा जानने के लिए, AdUnitMapping रेफ़रंस दस्तावेज़ देखें.

सुरक्षित सिग्नल

पब्लिशर, बिड लगाने वालों के साथ सुरक्षित सिग्नल शेयर कर सकते हैं. ये आपको BidRequest.imp.ext.buyer_generated_request_data.data में मिल सकते हैं.

BuyerGeneratedRequestData रेफ़रंस दस्तावेज़ में जाकर, सुरक्षित सिग्नल को दिखाने के तरीके के बारे में ज़्यादा जानें.

टेस्ट के अनुरोध

BidRequest.test फ़ील्ड का इस्तेमाल करके, यह पुष्टि की जा सकती है कि बिड रिक्वेस्ट एक जांच है या नहीं.

इस फ़ील्ड के बारे में ज़्यादा जानने के लिए, BidRequest रेफ़रंस दस्तावेज़ देखें.

बिड रिक्वेस्ट का सैंपल

id: "<bid_request_id>"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    ...
  }
...
  adx_ext {
   ...
    ad_unit_mapping {
      keyvals {
        key: "key_1"
        value: "value_1"
      }
      keyvals {
        key: "key_2"
        value: "value_2"
      }
      ...
      format: FORMAT_BANNER
    }
  }
}
app {
 ...
  adx_ext {
    installed_sdk {
      id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      sdk_version {
        major: 1
        minor: 2
        micro: 30
      }
      adapter_version {
        major: 1
        minor: 2
        micro: 3000
      }
    }
    installed_sdk {
    ...
    }
    ...
  }
}
device {
  ...
}
user {
  ...
  }
  adx_ext {
    eids {
      source: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      uids {
        id: "<partner_signal_string>"
      }
    }
  }
}
at: 1
tmax: 1000
cur: "USD"
test: 1
...
adx_ext {
  google_query_id: "<query_string>"
  ...
}

बिड रिस्पॉन्स

बिड रिस्पॉन्स में इन फ़ील्ड की वैल्यू देना ज़रूरी है:

• BidResponse.seatbid.bid.adomain
• BidResponse.seatbid.bid.ext.billing_id
• BidResponse.seatbid.bid.crid
• BidResponse.seatbid.bid.w
• BidResponse.seatbid.bid.h

इसके अलावा, बिड रिस्पॉन्स में BidResponse.seatbid.bid.ext.sdk_rendered_ad के लिए ये वैल्यू होनी चाहिए:

SDK टूल का आईडी

विज्ञापन रेंडर करने के लिए, एसडीके टूल को आईडी देने के लिए id फ़ील्ड का इस्तेमाल करें.

आईडी, BidRequest.app.ext.installed_sdk में देखा जा सकता है.

एलान किया गया विज्ञापन

BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad का इस्तेमाल करके ऐसा क्रिएटिव दें जो BidRequest.imp.ext.creative_enforcement_settings में बताई गई ज़रूरी शर्तों को पूरा करता हो और विज्ञापन के रेंडरिंग डेटा को दिखाता हो. html_snippet, video_url, video_vast_xml या native_response में से सिर्फ़ एक प्रॉपर्टी को पॉप्युलेट किया जाना चाहिए.

अगर आपने declared_ad को पॉप्युलेट नहीं किया है, तो हम क्रिएटिव की समीक्षा नहीं कर पाएंगे. साथ ही, क्रिएटिव वाली सभी बिड को नीलामी से फ़िल्टर कर दिया जाएगा.

DeclaredAd रेफ़रंस दस्तावेज़ में जाकर, एलान किए गए विज्ञापन के बारे में ज़्यादा जानें.

डेटा रेंडर करना

BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data फ़ील्ड का इस्तेमाल करके, खरीदार के एसडीके टूल को डेटा दें, ताकि वह आपके विज्ञापन को रेंडर कर सके.

खरीदार के SDK टूल से विज्ञापन दिखाने के लिए, बिड में declared_ad फ़ील्ड में क्रिएटिव की जानकारी देनी होगी. एलान किए गए विज्ञापन में rendering_data के बारे में सही जानकारी होनी चाहिए.

यहां SdkRenderedAd ऑब्जेक्ट का सैंपल दिया गया है:

{
  "id": "1234567",
  "rendering_data": "\xd58...,\xd4\x89\xd\xf9",
  "declared_ad": {
    "html_snippet": "<iframe src=\"https://example.com/ads?id=123&
      curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
  }
}

हमारा सुझाव है कि बिड रिस्पॉन्स में क्रिएटिव शामिल करने से पहले, रीयल-टाइम बिडिंग एपीआई का इस्तेमाल करके, क्रिएटिव की समीक्षा के लिए सबमिट करें.

SdkRenderedAd फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, OpenRTB गाइड देखें.

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

यहां हर विज्ञापन फ़ॉर्मैट के लिए बिड रिस्पॉन्स के सैंपल दिए गए हैं:

बैनर

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 99
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 320
    h: 50
    burl: "https://abc.com/billing?td=fn&win_price=${AUCTION_PRICE}"
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          html_snippet: "<!doctype html> <html> ... </html>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
      billing_id: 141763360450
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

मध्यवर्ती

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

पुरस्कृत वीडियो

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

मूल भाषा वाला

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 1200
    h: 627
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          native_response {
            ...
            assets {
              id: 1
              title {
                text: ""
              }
            }
            assets {
              id: 2
              data {
                value: "<some_string>"
              }
            }
            assets {
              id: 3
              data {
                value: "View now"
              }
            }
            assets {
              id: 4
              img {
                url: "<valid_image_url>"
                w: 1200
                h: 627
                type: 3
              }
            }
            assets {
              id: 5
              img {
                url: "<valid_image_url>"
                w: 100
                h: 100
                type: 1
              }
            }
            assets {
              id: 6
              data {
                value: ""
              }
            }
            assets {
              id: 7
              data {
                value: "<some_string>"
              }
            }
            link {
              url: "<destination_link>"
            }
          }
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

क्रिएटिव की समीक्षा

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

क्रिएटिव को समीक्षा के लिए सबमिट करने के दो तरीके यहां दिए गए हैं:

Real-time Bidding API (सुझाया गया)

समीक्षा के लिए क्रिएटिव सबमिट करने के लिए, रीयल-टाइम बिडिंग एपीआई के buyers.creatives.create तरीके का इस्तेमाल किया जा सकता है.

एपीआई के लिए, हर क्रिएटिव को सिर्फ़ एक बार सबमिट करना ज़रूरी है. साथ ही, इससे आपको अपने क्रिएटिव की समीक्षा की स्थिति देखने की सुविधा मिलती है.

बिड रिस्पॉन्स

नए क्रिएटिव को सीधे बिड रिस्पॉन्स में सबमिट किया जा सकता है.

समीक्षा के लिए, बिड रिस्पॉन्स के साथ खरीदार के SDK टूल का क्रिएटिव सबमिट करने के लिए, आपको SdkRenderedAd ऑब्जेक्ट के declared_ad फ़ील्ड का इस्तेमाल करना होगा.

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

ज़्यादा जानकारी के लिए, क्रिएटिव गाइड देखें.