מעברון

בחירת פלטפורמה: Android iOS Unity Flutter

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

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

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

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

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

טעינת מודעה

בדוגמה הבאה מוצגת טעינה של מודעת מעברון:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  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, אפשר להאזין לאירועים במחזור החיים, כמו מתי המודעה מוצגת או נסגרת. מגדירים את הערך InterstitialAd.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.');
  },
);

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

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

_interstitialAd?.show();

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

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

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

השלבים הבאים

דוגמה מלאה ב-GitHub

Interstitial