साथ में दिखने वाले विज्ञापनों के लिए सहायता जोड़ना

यह गाइड उन पब्लिशर के लिए है जिन्हें Android आईएमए इंटिग्रेशन में सहभागी विज्ञापन जोड़ने हैं.

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

• ऐसा Android ऐप्लिकेशन जिसमें IMA SDK इंटिग्रेट किया गया हो. अगर आपके पास पहले से ऐसा ऐप्लिकेशन नहीं है जिसमें SDK टूल इंटिग्रेट किया गया हो, तो BasicExample देखें. अगर आपको अपने ऐप्लिकेशन में IMA SDK टूल को लागू करने में मदद चाहिए, तो IMA SDK टूल सेट अप करना लेख पढ़ें.
• सहभागी विज्ञापन दिखाने के लिए कॉन्फ़िगर किया गया विज्ञापन टैग. अगर आपको कोई सैंपल चाहिए, तो हमारे अक्सर पूछे जाने वाले सवाल देखें.

अपने ऐप्लिकेशन में सहभागी विज्ञापन जोड़ना

अपने ऐप्लिकेशन में सहभागी विज्ञापन स्लॉट जोड़ने और सहभागी विज्ञापन दिखाने के लिए, यह तरीका अपनाएं.

साथी विज्ञापन दिखाने के लिए ViewGroup बनाएं

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

अगर आपको BasicExample ऐप्लिकेशन में इंटिग्रेट करना है, तो इसे activity_my.xml फ़ाइल में videoPlayerContainer के नीचे जोड़ें.

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />
companion_ad_slot_snippet.xml

CompanionAdSlot बनाएं

अगला चरण, CompanionAdSlot ऑब्जेक्ट बनाना है. इसके बाद, इसे ArrayList<CompanionAdSlot> इंस्टेंस में जोड़ा जाता है. AdDisplayContainer इंटरफ़ेस, सहभागी विज्ञापन स्लॉट की सूची लेता है, ताकि आप एक साथ कई सहभागी विज्ञापन दिखा सकें. CompanionAdSlot ऑब्जेक्ट बनाने के लिए, आपको ImaSdkFactory क्लास का इंस्टेंस बनाना होगा.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

अपने ऐप्लिकेशन में दिखाए जाने वाले हर साइज़ के सहभागी विज्ञापन के लिए, एक सहभागी विज्ञापन स्लॉट बनाएं. IMA SDK, सहभागी विज्ञापन स्लॉट को VAST रिस्पॉन्स से मिले किसी भी सहभागी विज्ञापन से भर देता है. इसके लिए, विज्ञापन के डाइमेंशन, व्यू की ऊंचाई और चौड़ाई से मैच होने चाहिए. IMA SDK, फ़्लूइड साइज़ वाले कंपैनियन विज्ञापनों के इस्तेमाल के साथ भी काम करता है. companionAdSlots बनाने के बाद, उन्हें AdsLoader में जोड़ें. यहां दिए गए उदाहरणों से पता चलता है कि Exoplayer-IMA एक्सटेंशन या एक्सटेंशन का इस्तेमाल न करने वाले अन्य IMA इंटिग्रेशन के आधार पर, ऐसा कैसे किया जा सकता है.

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

बस इतना ही करना है! अब आपके ऐप्लिकेशन पर सहभागी विज्ञापन दिख रहे हैं.

फ़्लूइड साइज़ वाले सहभागी विज्ञापन दिखाना

IMA, फ़्लूइड सहयोगी विज्ञापनों के साथ काम करता है. इन सहभागी विज्ञापनों का साइज़, विज्ञापन स्लॉट के साइज़ के हिसाब से बदला जा सकता है. ये पैरंट व्यू की चौड़ाई को 100% भरते हैं. इसके बाद, कंपैनियन विज्ञापन के कॉन्टेंट के हिसाब से अपनी ऊंचाई बदलते हैं. इन्हें Ad Manager में Fluid कंपैनियन साइज़ का इस्तेमाल करके सेट किया जाता है. इस वैल्यू को सेट करने के लिए, यहां दी गई इमेज देखें.

Android ऐप्लिकेशन अपडेट करना, ताकि वे फ़्लूइड कंपैनियन के साथ काम कर सकें

CompanionAdSlot.setSize() तरीके को अपडेट करके, फ़्लूइड कंपैनियन स्लॉट का एलान किया जा सकता है. इसके लिए, दोनों पैरामीटर के तौर पर CompanionAdSlot.FLUID_SIZE को इस्तेमाल करें.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

अक्सर पूछे जाने वाले सवाल

मैंने गाइड में दिए गए निर्देशों का पालन किया है, लेकिन मुझे सहभागी विज्ञापन नहीं दिख रहे हैं. मुझे क्या करना चाहिए?

सबसे पहले, यह पक्का करें कि आपका टैग, कंपैनियन विज्ञापन दिखा रहा है. इसके लिए, टैग को किसी वेब ब्राउज़र में खोलें और <CompanionAds> टैग ढूंढें. अगर आपको यह दिखता है, तो पक्का करें कि दिखाए जा रहे कंपैनियन विज्ञापन का साइज़, उन डाइमेंशन के साइज़ के बराबर हो जिन्हें CompanionAdSlot ऑब्जेक्ट में पास किया जा रहा है.

इस गाइड का पालन करने पर, मेरा सहभागी विज्ञापन स्लॉट कैसा दिखेगा?

नीचे दी गई इमेज, BasicExample से बनाई गई है. इसमें वीडियो कॉन्टेंट सबसे ऊपर चल रहा है और उसके नीचे सहभागी विज्ञापन दिख रहा है.