מודעות מעברון מתגמלות

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

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

דרישות מוקדמות

לפני שממשיכים, צריך:

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

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

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

Android

ca-app-pub-3940256099942544/5354046379

iOS

ca-app-pub-3940256099942544/6978759866

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

טעינת מודעה

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

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

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

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

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

מודעה ברשת המדיה

RewardedInterstitialAd מוצג כשכבת-על מעל כל תוכן האפליקציה, והמיקום שלו קבוע. לכן, אי אפשר להוסיף אותו לעץ הווידג'טים של Flutter. אפשר לבחור מתי להציג את המודעה באמצעות קריאה ל-show(). ‫RewardedInterstitialAd.show() מקבלת OnUserEarnedRewardCallback, שמופעלת כשהמשתמש מרוויח תגמול. חשוב להטמיע את התכונה הזו ולתגמל את המשתמש על הצפייה במודעה.

_rewardedInterstitialAd?.show(
  onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
    debugPrint('Reward amount: ${rewardItem.amount}');
  },
);

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

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

[אופציונלי] אימות קריאות חוזרות של אימות בצד השרת (SSV)

באפליקציות שנדרשים בהן נתונים נוספים בקריאות חוזרות (callback) של אימות בצד השרת (SSV), צריך להשתמש בתכונה "נתונים מותאמים אישית" של מודעות מתגמלות. כל ערך מחרוזת שמוגדר באובייקט של מודעה מתגמלת מועבר לפרמטר השאילתה custom_data של הקריאה החוזרת ל-SSV. אם לא מוגדר ערך של נתונים מותאמים אישית, הערך של פרמטר השאילתה custom_data לא יופיע בקריאה החוזרת ל-SSV.

בדוגמת הקוד הבאה אפשר לראות איך מגדירים אפשרויות של SSV אחרי שמודעת המעברון המתגמלת נטענת:

RewardedInterstitialAd.load(
  adUnitId: "_adUnitId",
  request: AdRequest(),
  rewardedInterstitialAdLoadCallback: RewardedInterstitialAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
            customData: 'SAMPLE_CUSTOM_DATA_STRING',
          );
      ad.setServerSideOptions(_options);
      _rewardedInterstitialAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);

מחליפים את SAMPLE_CUSTOM_DATA_STRING בנתונים המותאמים אישית.

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

דוגמה מלאה זמינה בהדגמה של API.