מודעות מעברונים

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

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

במדריך הזה מוסבר איך לשלב מודעות מעברון באפליקציית Flutter.

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

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

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

  • /21775744923/example/interstitial

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

טעינת מודעה

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

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);

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

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

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

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);

הצגת מודעת מעברון

AdManagerInterstitialAd מוצגת בתור Overlay מעל כל התוכן של האפליקציה, והמיקום שלה סטטי. לכן אי אפשר להוסיף אותה לעץ הווידג'טים של Flutter. כדי לבחור מתי להציג את המודעה, אפשר להפעיל את show().

_interstitialAd?.show();

אחרי הקריאה ל-show(), אי אפשר לסגור את Ad שמוצג באופן הזה באמצעות קוד, ונדרשת פעולה של המשתמש. אפשר להציג AdManagerInterstitialAd רק פעם אחת. קריאות נוספות להצגה יפעילו את onAdFailedToShowFullScreenContent.

צריך להסיר מודעה כשכבר לא צריך גישה אליה. השיטה המומלצת היא להפעיל את dispose() בקריאות החוזרות (callbacks) של FullScreenContentCallback.onAdDismissedFullScreenContent ו-FullScreenContentCallback.onAdFailedToShowFullScreenContent.

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

השלבים הבאים