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

এই গাইড সেইসব প্রকাশকদের জন্য যারা নিজেদের 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

আপনার অ্যাপে দেখাতে চান এমন প্রতিটি সাইজের কম্প্যানিয়নের জন্য একটি কম্প্যানিয়ন বিজ্ঞাপন স্লট তৈরি করুন। VAST রেসপন্স থেকে এমন যেকোনও কম্প্যানিয়ন দিয়ে IMA SDK কম্প্যানিয়ন বিজ্ঞাপন স্লট পূরণ করে যেগুলির ডাইমেনশন ভিউয়ের উচ্চতা ও প্রস্থের সাথে ম্যাচ করে। এছাড়াও, 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 থেকে তৈরি করা হয়েছে এবং এতে কন্টেন্ট ভিডিওটি উপরে চলছে এবং তার নিচে কম্প্যানিয়ন বিজ্ঞাপন দেখানো হচ্ছে।