सहभागी विज्ञापन

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

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

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

मददगार प्राइमर

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

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

अपना साथी दिखाने के लिए ViewGroup बनाएं

किसी साथी का अनुरोध करने से पहले, आपको अपने लेआउट में इसके लिए स्पेस बनाना होगा. अपने लेआउट एक्सएमएल में, ViewGroup एलिमेंट जोड़ें. यह उदाहरण LinearLayout का इस्तेमाल करता है. बाद के चरण में, अपने AdDisplayContainer पर इस एलिमेंट का रेफ़रंस भेजा जाएगा. अगर आपको BasicExample ऐप्लिकेशन के साथ इंटिग्रेट किया जा रहा है, तो इसे com.google.android.exoplayer2.ui.PlayerView के नीचे मौजूद 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 में जोड़ना ज़रूरी था. नीचे दिए गए उदाहरणों में, इस प्रोसेस को करने का तरीका बताया गया है. यह इस बात पर निर्भर करता है कि IMA Android BasicExample का इस्तेमाल किया जा रहा है या नहीं, जो Exoplayer-IMA एक्सटेंशन का इस्तेमाल करता है या 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 से बनाई गई है और इसमें नीचे दिए गए वीडियो विज्ञापन के साथ, कॉन्टेंट वीडियो चल रहा है.

IMA Android के सहयोगी विज्ञापन का उदाहरण इमेज.