افزودن پشتیبانی آگهی‌های همپا

پلاتفرم را انتخاب کنید: HTML5 Android iOS

این راهنما برای ناشرانی است که می‌خواهند آگهی‌های همپا را به پیاده‌سازی IMA در Android خود اضافه کنند.

پیش‌نیازها

• برنامه Android با کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی ادغام‌شده. اگر هنوز برنامه‌ای ندارید که کیت توسعه نرم‌افزار در آن ادغام شده باشد، BasicExample را ببینید. اگر برای پیاده‌سازی «کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی» در برنامه‌تان به کمک نیاز دارید، راه‌اندازی کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی را ببینید.
• برچسب آگهی پیکربندی‌شده برای برگرداندن آگهی همپا. اگر به نمونه نیاز دارید، پرسشگان ما را بررسی کنید.

افزودن آگهی‌های همپا به برنامه

برای افزودن جایگاه آگهی همپا و نمایش آگهی‌های همپا در برنامه‌تان، مراحل را دنبال کنید.

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 که ابعاد آن با ارتفاع و عرض نما مطابقت دارد، پر می‌کند. کیت توسعه نرم‌افزار آگهی‌های رسانه‌ای تعاملی از استفاده از همراهان با اندازه سیال نیز پشتیبانی می‌کند. وقتی companionAdSlots را ایجاد کردید، آن‌ها را به AdsLoader اضافه کنید. مثال‌های زیر نشان می‌دهند که چگونه این کار را انجام دهید، بسته به اینکه آیا از افزونه Exoplayer-IMA استفاده می‌کنید یا از سایر پیاده‌سازی‌های IMA که از این افزونه استفاده نمی‌کنند.

افزونه Exoplayer-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 از آگهی‌های همپای سیال پشتیبانی می‌کند. این آگهی‌های همپا می‌توانند تغییر اندازه دهند تا با اندازه جایگاه آگهی مطابقت داشته باشند. این آگهی‌ها ۱۰۰٪ عرض نمای اصلی را پر می‌کنند، سپس ارتفاعشان را برای جا دادن محتوای آگهی همراه تغییر می‌دهند. این تبلیغات بااستفاده از اندازه همراه Fluid در Ad Manager تنظیم می‌شوند. برای دیدن جایی که این مقدار را تنظیم می‌کنید، تصویر زیر را ببینید.

به‌روزرسانی برنامه‌های Android برای همراهان روان

می‌توانید با به‌روزرسانی روش CompanionAdSlot.setSize() برای گرفتن CompanionAdSlot.FLUID_SIZE به‌عنوان هر دو پارامتر، جایگاه همراه سیال را اعلام کنید.

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

پرسشگان

من راهنما را دنبال کردم، اما آگهی‌های همپا را نمی‌بینم. چه کاری باید انجام دهم؟

ابتدا، بررسی کنید تا مطمئن شوید برچسبتان واقعاً همراه برمی‌گرداند. برای انجام این کار، برچسب را در مرورگر وب باز کنید و به‌دنبال برچسب <CompanionAds> بگردید. اگر این را دیدید، بررسی کنید تا مطمئن شوید اندازه همراهی که برگردانده می‌شود با ابعادی که به CompanionAdSlot شیء ارسال می‌کنید یکسان باشد.

وقتی این راهنما را دنبال می‌کنم، جایگاه آگهی همپای من چگونه خواهد بود؟

تصویر زیر از BasicExample ایجاد شده است و ویدیو محتوا در بالا درحال پخش است و آگهی همپا در زیر آن قرار دارد.