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

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

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

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

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

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

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

• Java
• Kotlin

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

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

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

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

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

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

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

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

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

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

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

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

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

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