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

यह गाइड उन पब्लिशर के लिए है जो Android IMA लागू करने के लिए, कंपैनियन विज्ञापन जोड़ना चाहते हैं.

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

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

अपने ऐप्लिकेशन में कंपैनियन विज्ञापन जोड़ना

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

कंपैनियन दिखाने के लिए, एक ViewGroup बनाएं

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

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

<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 से बनाई गई है. इसमें, सबसे ऊपर कॉन्टेंट वीडियो चल रहा है और उसके नीचे कंपैनियन विज्ञापन दिख रहा है.