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

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

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

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

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

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

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

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

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

मोबाइल ऐप्लिकेशन की इन्वेंट्री के लिए बिड अनुरोधों में, पब्लिशर के ऐप्लिकेशन में मौजूद 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 में यह जानकारी भी शामिल होनी चाहिए:

एसडीके आईडी

विज्ञापन दिखाने के लिए एसडीके को आईडी देने के लिए, 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 फ़ील्ड का इस्तेमाल करके, खरीदार के एसडीके को डेटा दें. इससे वह आपके विज्ञापन को रेंडर कर पाएगा.

खरीदार के एसडीके का विज्ञापन दिखाने के लिए बिड में, 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 तरीके का इस्तेमाल किया जा सकता है.

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

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

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

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

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

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