מודעות באנר מותאמות שמוצגות בתוך הטקסט

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

במדריך הזה מוסבר איך ליצור מודעות באנר מותאמות שמוצגות בתוך הטקסט ואיך להגדיר את הגודל של מודעות הבאנר.

בתמונה הבאה מוצגות מודעות באנר מותאמות להצגה בתוך אפליקציה בתוכן שנגלל:

לפני שמתחילים

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

כדי לראות דוגמה מלאה למודעת באנר מותאמת בתוך הטקסט, הורידו את האפליקציה לדוגמה הבאה:

• Java
• Kotlin

הטמעה של מודעות באנר מותאמות שמוצגות בתוך הטקסט

כדי להטמיע מודעות באנר מותאמות שמוצגות בתוך הטקסט, צריך להגדיר את גודל המודעה, ליצור בקשה להצגת מודעה ולטעון את המודעה.

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

• שימוש ברוחב המסך המלא.
• שימוש ברוחב של פריסת האם שמכילה את המודעה.
• התאמת הרוחב בהתאם לאזורים הבטוחים במכשיר.

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

בדוגמה הבאה מגדירים את גודל המודעה, יוצרים בקשה להצגת מודעה וטוענים את המודעה:

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

מחליפים את AD_UNIT_ID במזהה יחידת המודעות.

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

הגדרת הפריסה של מודעת הבאנר המותאמת שמוצגת בתוך הטקסט

כדי לטעון מראש מודעת באנר מותאמת ומוטבעת לפריסה ספציפית, משתמשים בשיטות הבאות:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

אם האפליקציה תומכת בתצוגה לאורך ולרוחב, ואתם רוצים לטעון מראש מודעת באנר מותאמת בפריסה הנוכחית, אתם יכולים להשתמש ב-method‏ AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width). השיטה הזו טוענת מודעה בפריסה הנוכחית.

הגבלת הגובה של מודעות באנר מותאמות שמוצגות בתוך הטקסט

כברירת מחדל, הגובה המקסימלי של מודעות באנר מותאמות שמוצגות בתוך הטקסט ונוצרו בלי ערך maxHeight שווה לגובה של המכשיר. כדי להגביל את הגובה של מודעת הבאנר המותאמת שמוצגת בתוך האפליקציה, משתמשים ב-method‏ AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).