טעינה של מודעה אחת בפתיחת אפליקציה

SDK עם API לטעינה יחידה.

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

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

במדריך הזה מוסבר איך לשלב מודעות לפתיחת אפליקציות באפליקציה ל-Android.

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

הגדרה של GMA Next-Gen SDK

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

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

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

ca-app-pub-3940256099942544/9257395921

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

פרטים על GMA Next-Gen SDK מודעות בדיקה זמינים במאמר הפעלת מודעות בדיקה.

טעינת מודעה

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

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

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

במהלך הבדיקה, צריך להשתמש במזהה של יחידת המודעות לבדיקה: ca-app-pub-3940256099942544/9257395921.

הצגת המודעה

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

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

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

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

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

הפעלות במצב התחלתי (cold start) ומסכי טעינה

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

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

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

שיטות מומלצות

כדאי לפעול לפי השיטות המומלצות הבאות לגבי מודעות בפתיחת אפליקציה:

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