הגדרת מודעות באנר

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

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

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

מודעות באנר מותאמות ומעוגנות הן מודעות עם יחס גובה-רוחב קבוע, ולא מודעות עם גודל קבוע. יחס הגובה-רוחב דומה ל-320x50. אחרי שמציינים את הרוחב המלא שזמין, Google Mobile Ads Flutter Plugin מחזיר מודעה עם הגובה האופטימלי לרוחב הזה. הגובה האופטימלי של המודעה נשאר קבוע בבקשות שונות להצגת מודעות, והתוכן שמסביב למודעה נשאר במקום כשהמודעה מתרעננת.

תמיד צריך לבדוק באמצעות מודעות בדיקה

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

הדרך הכי קלה לטעון מודעות לבדיקה היא להשתמש במזהה יחידת המודעות הייעודית לבדיקה של מודעות באנר:

/21775744923/example/adaptive-banner

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

איך מקבלים את גודל המודעה

מודעות באנר מותאמות גדולות הן פורמט גדול יותר שמיועד לפריסות ללא גלילה. בהשוואה למודעות באנר מותאמות ומעוגנות רגילות, במודעות האלה הגובה המקסימלי יכול להיות גדול יותר (עד 20% מגובה המסך, בין 50 ל-150dp). השטח המוגדל הזה מותאם לקטע וידאו.

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

1. כדי לקבל את רוחב המסך של המכשיר בפיקסלים שלא תלויים בדחיסות (dp), משתמשים ב-MediaQuery.of(context). אם אתם לא רוצים להשתמש ברוחב המסך המלא, אתם יכולים להגדיר רוחב משלכם.

2. משתמשים בשיטה הסטטית המתאימה במחלקה AdSize כדי לקבל אובייקט AdSize. לדוגמה, אפשר להשתמש ב-AdSize.getLargeAnchoredAdaptiveBannerAdSize(int width) כדי לקבל את גודל המודעה בהתאם לכיוון הנוכחי.

// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getLargeAnchoredAdaptiveBannerAdSize(
  MediaQuery.sizeOf(context).width.truncate(),
);
banner_ad_snippets.dart

טעינת מודעה

בדוגמה הבאה נטענת מודעת באנר:

void _loadAdManagerBannerAd() async {
  // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
  final size = await AdSize.getLargeAnchoredAdaptiveBannerAdSize(
    MediaQuery.sizeOf(context).width.truncate(),
  );

  if (size == null) {
    // Unable to get width of anchored banner.
    return;
  }

  unawaited(
    BannerAd(
      adUnitId: "_adUnitId",
      request: const AdManagerAdRequest(),
      size: size,
      listener: BannerAdListener(
        onAdLoaded: (ad) {
          // Called when an ad is successfully received.
          debugPrint('Ad was loaded.');
          setState(() {
            _bannerAd = ad as BannerAd;
          });
        },
        onAdFailedToLoad: (ad, err) {
          // Called when an ad request failed.
          debugPrint('Ad failed to load with error: $err');
          ad.dispose();
        },
      ),
    ).load(),
  );
}
banner_ad_snippets.dart

מחליפים את הקטע _adUnitId במזהה יחידת המודעות.

אירועים של מודעות באנר

בעזרת AdManagerBannerAdListener, אתם יכולים להאזין לאירועים במחזור החיים, כמו טעינה של מודעה. בדוגמה הזו, כל שיטה מיושמת ומתבצע רישום של הודעה ביומן במסוף:

onAdOpened: (Ad ad) {
  // Called when an ad opens an overlay that covers the screen.
  debugPrint('Ad was opened.');
},
onAdClosed: (Ad ad) {
  // Called when an ad removes an overlay that covers the screen.
  debugPrint('Ad was closed.');
},
onAdImpression: (Ad ad) {
  // Called when an impression occurs on the ad.
  debugPrint('Ad recorded an impression.');
},
onAdClicked: (Ad ad) {
  // Called when a click event occurs on the ad.
  debugPrint('Ad was clicked.');
},
onAdWillDismissScreen: (Ad ad) {
  // iOS only. Called before dismissing a full screen view.
  debugPrint('Ad will be dismissed.');
},
banner_ad_snippets.dart

רענון מודעה

אם הגדרתם את יחידת המודעות לרענון, אתם לא צריכים לבקש מודעה אחרת כשהמודעה לא נטענת. ‫Google Mobile Ads Flutter Plugin מכבד את קצב הרענון שציינתם בממשק המשתמש של Ad Manager. אם לא הפעלתם את הרענון, שלחו בקשה חדשה. במאמר קצב הרענון של מודעות באפליקציות לנייד מוסבר איך להגדיר את קצב הרענון של יחידות המודעות.

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

הצגת מודעת באנר

כדי להציג AdManagerBannerAd כווידג'ט, צריך ליצור מופע של AdWidget עם מודעה נתמכת אחרי הקריאה ל-load(). אפשר ליצור את הווידג'ט לפני שקוראים ל-load(), אבל צריך לקרוא ל-load() לפני שמוסיפים אותו לעץ הווידג'טים.

‫AdWidget עובר בירושה מהמחלקה Widget של Flutter, ואפשר להשתמש בו כמו בכל ווידג'ט אחר. ב-iOS, חשוב לוודא שהווידג'ט ממוקם בווידג'ט עם רוחב וגובה מוגדרים. אחרת, יכול להיות שהמודעה לא תוצג. אפשר להציב AdManagerBannerAd במאגר בגודל שתואם למודעה:

if (_bannerAd != null)
  Align(
    alignment: Alignment.bottomCenter,
    child: SafeArea(
      child: SizedBox(
        width: _bannerAd!.size.width.toDouble(),
        height: _bannerAd!.size.height.toDouble(),
        child: AdWidget(ad: _bannerAd!),
      ),
    ),
  ),
banner_ad_snippets.dart

צריך להסיר מודעה כשכבר לא צריך גישה אליה. השיטה המומלצת היא להפעיל את dispose() אחרי ש-AdWidget מוסר מעץ הווידג'טים או בקריאה החוזרת (callback) של AdManagerBannerAdListener.onAdFailedToLoad().

זהו! האפליקציה מוכנה להצגת מודעות באנר.

מגבלת גלילה ב-Android 9 ומטה

אנחנו מודעים לכך שבמכשירים ישנים או חלשים יותר עם Android 9 או גרסה קודמת, הביצועים עשויים להיות פחות טובים כשמציגים מודעות באנר מותאמות לתצוגה בתצוגות נגללות. מומלץ להשתמש בסוגים האלה של מודעות באנר רק ב-Android מגרסה 10 ואילך. מודעות באנר במיקום קבוע, כמו מודעות באנר מעוגנות, לא מושפעות מהשינוי הזה, ואפשר להשתמש בהן עם ביצועים אופטימליים בכל רמות ה-API של Android.

מידע על סוגים אחרים של מודעות באנר

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

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

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

מודעות באנר שאפשר לכווץ

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