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

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

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

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

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

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

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

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

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

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

एसडीके आईडी

बिड रिक्वेस्ट का इस्तेमाल करके, उस id को ढूंढा जा सकता है जो आपको बिड में देना होगा खरीदार के SDK टूल की तरफ़ से रेंडर किए गए विज्ञापन के लिए रिस्पॉन्स.

नीचे दिए गए फ़ील्ड देखें:

  • OpenRTB: BidRequest.app.ext.installed_sdk
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidRequest.mobile.installed_sdk

InstalledSdk मैसेज के बारे में ज़्यादा जानने के लिए, यहां जाएं: OpenRTB और Google से जुड़े लेख पढ़ें.

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

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

नीचे दिए गए फ़ील्ड देखें:

  • OpenRTB: BidRequest.imp.ext.ad_unit_mapping
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidRequest.AdSlot.ad_unit_mapping

AdUnitMapping ऑब्जेक्ट के बारे में ज़्यादा जानने के लिए, यहां जाएं: OpenRTB और Google से जुड़े लेख पढ़ें.

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

पब्लिशर, बिड करने वालों के साथ सुरक्षित सिग्नल शेयर कर सकते हैं. इन्हें यहां से पढ़ा जा सकता है OpenRTB का BuyerGeneratedRequestData ऑब्जेक्ट या काम न करने वाले Google से आरटीबी प्रोटोकॉल का SecureSignal ऑब्जेक्ट.

नीचे दिए गए फ़ील्ड देखें:

  • OpenRTB: BidRequest.imp.ext.buyer_generated_request_data.data
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidRequest.AdSlot.SecureSignal.data

सुरक्षित सिग्नल को दिखाने का तरीका OpenRTB और Google से जुड़े लेख पढ़ें.

परीक्षण अनुरोध

जांच के अनुरोध वाले फ़ील्ड को पढ़कर, यह समझा जा सकता है कि बिड रिक्वेस्ट परीक्षण.

नीचे दिए गए फ़ील्ड देखें:

  • OpenRTB: BidRequest.test
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidRequest.is_test

Test फ़ील्ड के बारे में ज़्यादा जानने के लिए, यहां जाएं: OpenRTB और Google से जुड़े लेख पढ़ें.

बोली अनुरोध का नमूना

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>"
  ...
}

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

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

  • OpenRTB:
    • BidResponse.seatbid.bid.adomain
    • BidResponse.seatbid.bid.ext.billing_id
    • BidResponse.seatbid.bid.crid
    • BidResponse.seatbid.bid.w
    • BidResponse.seatbid.bid.h
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है):
    • BidResponse.Ad.click_through_url
    • BidResponse.Ad.AdSlot.billing_id
    • BidResponse.Ad.buyer_creative_id
    • BidResponse.Ad.width
    • BidResponse.Ad.height

इसके अलावा, आपके बिड रिस्पॉन्स में SdkRenderedAd शामिल होना चाहिए, जिसमें फ़ॉलो किया जा रहा है:

एसडीके आईडी

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

बिड रिक्वेस्ट में, यहां दिए गए फ़ील्ड में मौजूद आईडी मिलेगा:

  • OpenRTB: BidRequest.app.ext.installed_sdk
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidRequest.mobile.installed_sdk

InstalledSdk मैसेज के बारे में ज़्यादा जानने के लिए, यहां जाएं: OpenRTB और Google से जुड़े लेख पढ़ें.

बताया गया विज्ञापन

बिड रिक्वेस्ट को पूरा करने वाला क्रिएटिव उपलब्ध कराने के लिए, declared_ad फ़ील्ड का इस्तेमाल करें CreativeEnforcementSettings की ज़रूरी शर्तें और यह विज्ञापन के बारे में बताता है रेंडरिंग डेटा. html_snippet, video_url, video_vast_xml या native_response में जानकारी भरी जानी चाहिए.

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

डेटा रेंडर किया जा रहा है

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

  • OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data
  • Google आरटीबी प्रोटोकॉल (अब सेवा में नहीं है): BidResponse.ad.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>",
  }
}

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

ज़्यादा जानकारी के लिए, Google और OpenRTB प्रोटोकॉल गाइड कृपया SdkRenderedAd फ़ील्ड से जुड़ी ज़्यादा जानकारी पाएं.

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

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

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"

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

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

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

रीयल-टाइम बिडिंग एपीआई (सुझाया गया)

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

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

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

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

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

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

इसके लिए क्रिएटिव गाइड देखें देखें.