הגדרת גודל קבוע של באנר

Google Mobile Ads SDK (Legacy) תומך בגודלי מודעות קבועים למקרים שבהם מודעות באנר מותאמות לא עונות על הצרכים שלכם.

בטבלה הבאה מפורטים הגדלים הסטנדרטיים של מודעות באנר.

גודל ב-dp (רוחב x גובה) תיאור זמינות ערך קבוע של AdSize
320x50 מודעת באנר טלפונים וטאבלטים BANNER
320x100 מודעת באנר גדולה טלפונים וטאבלטים LARGE_BANNER
300x250‎ מלבן בינוני של IAB טלפונים וטאבלטים MEDIUM_RECTANGLE
468x60 מודעת באנר בגודל מלא של IAB טאבלטים FULL_BANNER
728x90 Leaderboard של IAB טאבלטים LEADERBOARD

הגודל של מאגר התגית שבו אתם ממקמים את המודעה צריך להיות לפחות בגודל של מודעת הבאנר. כל ריפוד מקטין בפועל את גודל הקונטיינר. אם מודעת הבאנר לא מתאימה למאגר, המודעה לא תוצג ותתועד האזהרה הבאה:

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

צריך להגדיר גודל מודעה שקטן מגודל המסך של המכשיר או שווה לו. כדי לקבוע את גודל המסך המקסימלי, משתמשים ב-method‏ Resources.getDisplayMetrics. המידות של האובייקט AdSize מוגדרות בפיקסלים שלא תלויים בצפיפות (dp). כשמשווים, צריך להמיר את גודל המסך מפיקסלים ל-dp. לפרטים על מגבלות הגודל, קראו את המאמר פתרון בעיות שקשורות לחשיפות שלא מולאו ב-Ad Manager.

הוספת 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 עם רוחב וגובה מותאמים אישית שתואמים לפריט.

Java

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

Kotlin

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

מספר גדלים של מודעות

אם רוצים לטרגט פריטים בגדלים שונים של מודעות באותה בקשה להצגת מודעה, אפשר להגדיר כמה גדלים של מודעות בבת אחת באמצעות AdManagerAdView.

Java

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

Kotlin

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