تنظیم اندازه ثابت برنما

Google Mobile Ads SDK (Legacy) از اندازه‌های ثابت آگهی برای شرایطی که آگهی‌های برنمای تطبیقی نیازهای شما را برآورده نمی‌کنند پشتیبانی می‌کند.

جدول زیر اندازه‌های استاندارد برنما را فهرست می‌کند.

اندازه محفظه‌ای که آگهی‌تان را در آن قرار می‌دهید باید حداقل به‌اندازه برنما باشد. هرگونه حاشیه داخلی به‌طور مؤثری اندازه محفظه را کاهش می‌دهد. اگر آگهی برنمایی در ظرف جا نشود، آگهی نشان داده نمی‌شود و هشدار زیر ثبت می‌شود:

W/Ads: Not enough space to show ad. Needs 320x50 dp, but only has 288x495 dp.

اندازه آگهی را کوچک‌تر یا برابر با اندازه صفحه دستگاه تنظیم کنید. برای تعیین حداکثر اندازه صفحه‌نمایش، از روش Resources.getDisplayMetrics استفاده کنید. ابعاد شیء AdSize از پیکسل‌های مستقل از تراکم (dp) استفاده می‌کند. هنگام مقایسه، اندازه صفحه را از پیکسل به dp تبدیل کنید. برای جزئیات مربوط به محدودیت‌های اندازه، به عیب‌یابی کردن ظهورهای پرنشده در «مدیر آگهی» مراجعه کنید.

افزودن AdManagerAdView به چیدمان

به‌جای ایجاد کردن AdManagerAdView به‌صورت برنامه‌نویسی، AdManagerAdView را به چیدمان XML برای Activity یا Fragment که می‌خواهید آن را نمایش دهید اضافه کنید. مثالی در اینجا ارائه شده است:

<com.google.android.gms.ads.admanager.AdManagerAdView
    xmlns:ads="http://schemas.android.com/apk/res-auto"
    android:id="@+id/banner_ad_view"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true"
    ads:adSize="BANNER"
    ads:adUnitId="/21775744923/example/fixed-size-banner" />

به مشخصه‌های الزامی زیر توجه کنید:

• ads:adSize: این را روی اندازه آگهی‌ای که می‌خواهید استفاده کنید تنظیم کنید. اگر نمی‌خواهید از اندازه استانداردی که با ثابت تعریف شده است استفاده کنید، می‌توانید اندازه سفارشی تنظیم کنید. مثال: ads:adSize="320x50".

• ‫ads:adUnitId: این را روی واحد آگهی در برنامه‌تان تنظیم کنید که آگهی‌ها در آن نمایش داده می‌شود. اگر آگهی‌های برنما را در فعالیت‌های مختلف نشان می‌دهید، هرکدام به یک واحد آگهی نیاز دارند.

اندازه آگهی سفارشی

اگر ردیف‌های آگهی رزرو Ad Manager دارید که اندازه سفارشی را هدف‌یابی می‌کند، می‌توانید AdSize با عرض و ارتفاع سفارشی ایجاد کنید که با ردیف آگهی شما مطابقت داشته باشد.

AdSize customAdSize = new AdSize(250, 250);
AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(customAdSize);

val customAdSize = AdSize(250, 250)
val adView = AdManagerAdView(this)
adView.setAdSizes(customAdSize)

اندازه‌های آگهی چندگانه

اگر می‌خواهید ردیف‌های چند اندازه آگهی را در یک درخواست آگهی هدف‌یابی کنید، AdManagerAdView به شما امکان می‌دهد چند اندازه آگهی را به‌طور هم‌زمان تنظیم کنید.

AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(AdSize.BANNER, new AdSize(120, 20), new AdSize(250, 250));

val adView = AdManagerAdView(this)
adView.setAdSizes(AdSize.BANNER, AdSize(120, 20), AdSize(250, 250))

AdManagerAdView به‌طور پیش‌فرض روی اولین اندازه آگهی تنظیم می‌شود. وقتی آگهی بار می‌شود، اندازه AdManagerAdView به اندازه آگهی بارشده تغییر می‌کند. چیدمان شما باید بتواند به‌طور خودکار با اندازه جدید سازگار شود.

همچنین می‌توانید بااستفاده از مشخصه ads:adSizes در فایل چیدمان XML، چندین اندازه آگهی را مشخص کنید:

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/multiple_ad_sizes_view"
   android:layout_width="wrap_parent"
   android:layout_height="wrap_content"
   android:layout_alignParentBottom="true"
   android:layout_centerHorizontal="true"
   ads:adSizes="BANNER,120x20,250x250"
   ads:adUnitId="AD_UNIT_ID" />

نمونه اندازه‌های آگهی چندگانه

Java Kotlin