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

प्लैटफ़ॉर्म चुनें: HTML5 Android iOS

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

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

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

काम की शुरुआती जानकारी

अगर आपको अब भी अपने ऐप्लिकेशन में IMA SDK लागू करना है, तो हमारी शुरू करने से जुड़ी गाइड देखें.

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

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

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

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" />

CompanionAdSlot ऑब्जेक्ट बनाना

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

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

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

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

लागू करने के अन्य तरीके

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

फ़्लूड कंपैनियन विज्ञापन दिखाना

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

Ad Manager की कंपैनियन विज्ञापन सेटिंग दिखाने वाली इमेज. इससे कंपैनियन साइज़ के विकल्प को हाइलाइट किया जाता है.

फ़्लूड कंपैनियन के लिए Android ऐप्लिकेशन अपडेट करना

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

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

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

मैंने दिशा-निर्देशों का पालन किया है, लेकिन मुझे सहयोगी विज्ञापन नहीं दिख रहे हैं. मुझे क्या करना चाहिए?: सबसे पहले, यह पक्का करें कि आपका टैग वाकई में कंपैनियन विज्ञापन दिखा रहा हो. इसके लिए, वेब ब्राउज़र में टैग खोलें और CompanionAds टैग ढूंढें. अगर आपको यह मैसेज दिखता है, तो पक्का करें कि दिखाए जा रहे कंपैनियन का साइज़, CompanionAdSlotऑब्जेक्ट
इस गाइड का पालन करने पर, वीडियो विज्ञापन के साथ दिखने वाला बैनर विज्ञापन कैसा दिखेगा?: नीचे दी गई इमेज को BasicExample से बनाया गया है. इसमें कॉन्टेंट वीडियो ऊपर चल रहा है और कंपैनियन विज्ञापन नीचे दिख रहा है.