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

בחירת פלטפורמה: Android iOS Flutter Android (Legacy)

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

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

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

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

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

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

• Java
• Kotlin

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

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

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

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

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

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

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
      }
    }
  )
}

Java

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;
        }
      });
}

חשוב: אפשר להציג מודעות בגדלים של מודעות בהזמנה ב-Ad Manager באותו מיקום למודעות כמו מודעות באנר בגודל מותאם.

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

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

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

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

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

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