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

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

پیش‌نیازها

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

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

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

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

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

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

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

پرسشگان

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

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

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

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