تبلیغات همراه

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

پیش نیازها

  • برنامه اندروید با IMA SDK یکپارچه. اگر قبلاً برنامه ای با SDK یکپارچه ندارید، به BasicExample مراجعه کنید.
  • یک برچسب تبلیغاتی پیکربندی شده برای بازگرداندن یک تبلیغ همراه.

پرایمرهای مفید

اگر هنوز نیاز به پیاده سازی IMA SDK در برنامه خود دارید، راهنمای شروع ما را بررسی کنید.

تبلیغات همراه را به برنامه خود اضافه کنید

یک ViewGroup برای نمایش همراه خود ایجاد کنید

قبل از درخواست همراه، باید فضایی برای آن در چیدمان خود ایجاد کنید. در طرح XML خود، یک عنصر ViewGroup اضافه کنید. این مثال از LinearLayout استفاده می کند. در مرحله بعد شما یک ارجاع به این عنصر را به AdDisplayContainer خود ارسال خواهید کرد. اگر در حال ادغام با برنامه BasicExample هستید، آن را به activity_my.xml زیر com.google.android.exoplayer2.ui.PlayerView اضافه کنید.

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 که از برنامه افزودنی استفاده نمی‌کنند، نشان می‌دهد.

مثال پایه 

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

سایر پیاده سازی ها

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

این تمام چیزی است که وجود دارد! برنامه شما اکنون در حال نمایش تبلیغات همراه است.

نمایش تبلیغات همراه روان

IMA اکنون از تبلیغات همراه روان پشتیبانی می کند. این تبلیغات همراه می توانند اندازه آنها را تغییر دهند تا با اندازه جایگاه تبلیغات مطابقت داشته باشد. آنها 100٪ عرض نمای والد را پر می کنند، سپس اندازه ارتفاع خود را متناسب با محتوای همراه تغییر می دهند. آنها با استفاده از اندازه همراه Fluid در Ad Manager تنظیم می شوند. برای اینکه این مقدار را کجا تنظیم کنید، تصویر زیر را ببینید.

تصویری که تنظیمات تبلیغات همراه Ad Manager را نشان می دهد. گزینه اندازه های همراه را برجسته می کند.

برنامه های اندروید را برای همراهان روان به روز کنید

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

  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 ایجاد شده است و محتوای ویدیویی در بالا با تبلیغ همراه زیر در حال پخش است.

تصویر مثال تبلیغ همراه اندروید IMA.