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

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

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

מודעות באנר מותאמות ומעוגנות הן מודעות עם יחס גובה-רוחב קבוע, ולא מודעות עם גודל קבוע. יחס הגובה-רוחב דומה ל-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. אם לא הפעלתם את הרענון, שלחו בקשה חדשה. במאמר קצב הרענון של מודעות באפליקציות לנייד מוסבר איך להגדיר את קצב הרענון של יחידות המודעות.

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

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

‫AdWidget הוא נגזר ממחלקת הווידג'טים של 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 מוסר מעץ הווידג'טים או בפונקציית הקריאה החוזרת AdManagerBannerAdListener.onAdFailedToLoad().

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

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

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

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

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

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

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

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

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