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

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

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

• 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 में जोड़ना ज़रूरी है. यहां दिए गए उदाहरणों से पता चलता है कि ऐसा कैसे किया जा सकता है. यह इस बात पर निर्भर करता है कि आपने IMA Android BasicExample का इस्तेमाल किया है या नहीं. यह उदाहरण, Exoplayer-IMA एक्सटेंशन का इस्तेमाल करता है. इसके अलावा, IMA के ऐसे अन्य वर्शन भी हैं जो एक्सटेंशन का इस्तेमाल नहीं करते.

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

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

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

फ़्लूइड साथ-साथ चलने वाले विज्ञापन दिखाना

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

फ़्लूइड साथी के लिए Android ऐप्लिकेशन अपडेट करना

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

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