این راهنما برای ناشرانی در نظر گرفته شده است که علاقه‌مند به اضافه کردن تبلیغات همراه به پیاده‌سازی IMA اندروید خود هستند.
پیش‌نیازها
- برنامه اندروید با IMA SDK یکپارچه. اگر از قبل برنامه‌ای با SDK یکپارچه ندارید، به مثال پایه مراجعه کنید. اگر برای پیاده‌سازی IMA SDK در برنامه خود به کمک نیاز دارید، به بخش راه‌اندازی IMA SDK مراجعه کنید.
- یک تگ تبلیغاتی که برای نمایش یک تبلیغ همراه پیکربندی شده است. اگر به نمونه نیاز دارید، به سوالات متداول ما مراجعه کنید.
تبلیغات همراه را به برنامه خود اضافه کنید
برای اضافه کردن یک جایگاه تبلیغات همراه و نمایش تبلیغات همراه در برنامه خود، با ما همراه باشید.
یک ViewGroup برای نمایش همراه خود ایجاد کنید
قبل از درخواست یک همراه، باید فضایی برای آن در طرح‌بندی خود ایجاد کنید. در XML طرح‌بندی خود، یک عنصر ViewGroup اضافه کنید؛ این مثال از LinearLayout استفاده می‌کند. در مرحله بعد، ارجاعی به این عنصر را به AdDisplayContainer خود ارسال خواهید کرد.
اگر در حال ادغام با برنامه BasicExample هستید، این را به فایل activity_my.xml ، زیر videoPlayerContainer اضافه کنید.
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 اضافه کنید. مثال‌های زیر نحوه انجام این کار را بسته به اینکه از افزونه Exoplayer-IMA استفاده می‌کنید یا سایر پیاده‌سازی‌های IMA که از این افزونه استفاده نمی‌کنند، نشان می‌دهند.
افزونه Exoplayer-IMA
adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();
سایر پیاده‌سازی‌ها
adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);
همین! برنامه شما اکنون تبلیغات همراه را نمایش می‌دهد.
نمایش تبلیغات همراه با مایعات
IMA از تبلیغات همراه سیال پشتیبانی می‌کند. این تبلیغات همراه می‌توانند تغییر اندازه دهند تا با اندازه جایگاه تبلیغ مطابقت داشته باشند. آنها ۱۰۰٪ عرض نمای والد را پر می‌کنند، سپس ارتفاع خود را تغییر می‌دهند تا با محتوای همراه متناسب شوند. آنها با استفاده از اندازه همراه Fluid در 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);
سوالات متداول
- من طبق راهنما عمل کردم، اما تبلیغات همراه را نمی‌بینم. چه کاری باید انجام دهم؟
- ابتدا، بررسی کنید که آیا تگ شما واقعاً companionها را برمی‌گرداند یا خیر. برای انجام این کار، تگ را در یک مرورگر وب باز کنید و به دنبال تگ
<CompanionAds>بگردید. اگر چنین چیزی را مشاهده کردید، بررسی کنید که آیا اندازه companion برگردانده شده با ابعادی که به شیءCompanionAdSlotارسال می‌کنید، یکسان است یا خیر. - با پیروی از این راهنما، جایگاه تبلیغاتی همراه من چگونه خواهد بود؟
تصویر زیر از روی مثال پایه ساخته شده است و ویدیوی محتوا در بالا و تبلیغ همراه آن در زیر آن پخش می‌شود.
