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

בחירת פלטפורמה: 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;
        }
      });
}

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

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

• 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).