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

בחירת פלטפורמה: Android iOS Flutter Android (גרסה קודמת)

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

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

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

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

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

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

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

צריך להגדיר גודל מודעה שקטן מגודל המסך של המכשיר או שווה לו. כדי לקבוע את גודל המסך המקסימלי, משתמשים ב-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 שווה לגובה המכשיר. כדי להגביל את הגובה של מודעת באנר מותאמת שמוצגת בתוך השורה, משתמשים בשיטה AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).