কম্প্যানিয়ন বিজ্ঞাপন সংক্রান্ত সহায়তা যোগ করা

এই নির্দেশিকাটি সেইসব প্রকাশকদের জন্য যারা তাদের Android IMA ইমপ্লিমেন্টেশনে সহযোগী বিজ্ঞাপন যোগ করতে আগ্রহী।

পূর্বশর্ত

• IMA SDK ইন্টিগ্রেট করা Android অ্যাপ্লিকেশন। আপনার কাছে আগে থেকে SDK ইন্টিগ্রেট করা অ্যাপ না থাকলে, BasicExample দেখুন। আপনার অ্যাপে IMA SDK প্রয়োগ করার জন্য সাহায্য প্রয়োজন হলে, IMA SDK সেট-আপ করুন বিকল্পটি দেখুন।
• সহযোগী বিজ্ঞাপন দেখানোর জন্য কনফিগার করা বিজ্ঞাপন ট্যাগ। আপনার স্যাম্পেল প্রয়োজন হলে, আমাদের প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

আপনার অ্যাপে সহযোগী বিজ্ঞাপন যোগ করা

আপনার অ্যাপে সহযোগী বিজ্ঞাপন স্লট যোগ করতে এবং সহযোগী বিজ্ঞাপন দেখাতে, এই ধাপগুলি অনুসরণ করুন।

আপনার কম্প্যানিয়ন দেখানোর জন্য একটি ViewGroup তৈরি করুন

কম্প্যানিয়নের অনুরোধ করার আগে, আপনার লেআউটে এটির জন্য একটি স্পেস তৈরি করতে হবে। আপনার লেআউট XML-এ, একটি 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-তে ফ্লুইড কম্প্যানিয়ন বিজ্ঞাপন কাজ করে। এইসব সহযোগী বিজ্ঞাপন, বিজ্ঞাপন স্লটের সাইজের সাথে ম্যাচ করার জন্য ছোট বড় করা যেতে পারে। এগুলি মূল ভিউয়ের প্রস্থের ১০০% পূরণ করে, তারপর কম্প্যানিয়নের কন্টেন্ট ফিট করার জন্য এগুলির উচ্চতা ছোট বড় করে। Ad Manager-এ Fluid কম্প্যানিয়ন সাইজ ব্যবহার করে এগুলি সেট করা হয়। এই ভ্যালু কোথায় সেট করতে হবে তা জানতে নিচের ছবি দেখুন।

ফ্লুইড কম্প্যানিয়নের জন্য Android অ্যাপ আপডেট করুন

আপনি CompanionAdSlot.setSize() পদ্ধতি আপডেট করে ফ্লুইড কম্প্যানিয়ন স্লট ঘোষণা করতে পারেন যাতে CompanionAdSlot.FLUID_SIZE দুটি প্যারামিটার হিসেবে নেওয়া যায়।

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

প্রায়শই জিজ্ঞাসিত প্রশ্ন

আমি নির্দেশিকা অনুসরণ করেছি, কিন্তু আমি সহযোগী বিজ্ঞাপন দেখতে পাচ্ছি না। আমার কী করা উচিত?

প্রথমে, আপনার ট্যাগ সত্যিই কম্প্যানিয়ন ফিরিয়ে দিচ্ছে কিনা তা চেক করে দেখুন। এটি করতে, ওয়েব ব্রাউজারে ট্যাগটি খুলুন এবং <CompanionAds> ট্যাগটি খুঁজুন। আপনি যদি এটি দেখতে পান, তাহলে চেক করে নিশ্চিত করুন যে ফেরত আসা কম্প্যানিয়নের সাইজ CompanionAdSlot অবজেক্টে

আপনার পাস করা ডাইমেনশনের সাইজের সমান।

এই নির্দেশিকা অনুসরণ করলে আমার সহযোগী বিজ্ঞাপনের স্লট কেমন দেখতে হবে?

নিচের ছবিটি BasicExample থেকে তৈরি করা হয়েছে এবং এতে উপরে কন্টেন্ট ভিডিও এবং নিচে সহযোগী বিজ্ঞাপন দেখানো হয়েছে।