טעינה מראש של מודעות (בטא)

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

טעינת מודעות מראש היא תכונה לטעינת מודעות שמנוהלת על ידי Google ב-Google Mobile Ads SDK (Legacy). התכונה הזו מנהלת את הטעינה והשמירה במטמון של המודעות בשבילכם. כדי לטעון מודעות מראש, צריך לשנות את האופן שבו מנהלים את טעינת המודעות. כדי לבצע אופטימיזציה של הביצועים באמצעות טעינת מודעות מראש, צריך להשבית את השמירה המותאמת אישית במטמון ולהעביר את האחריות הזו אל Google Mobile Ads SDK (Legacy).

לטעינת מודעות מראש יש כמה יתרונות על פני טעינת מודעות ידנית:

• ניהול קובצי עזר: שומר מודעות שנטענו כדי שלא תצטרכו לתחזק קובצי עזר עד שתהיו מוכנים להציג אותן.
• טעינה מחדש אוטומטית: טעינה אוטומטית של מודעה חדשה כששולפים מודעה מהמטמון.
• ניסיונות חוזרים מנוהלים: ניסיונות חוזרים אוטומטיים של בקשות שנכשלו באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff).
• טיפול בתפוגה: המערכת מרעננת את המודעות באופן אוטומטי לפני שהתוקף שלהן פג (בדרך כלל אחרי שעה).
• אופטימיזציה של המטמון: אם אתם משתמשים במטמון בגודל שגדול מ-1, Google Mobile Ads SDK (Legacy) מבצע אופטימיזציה של סדר המטמון כדי להציג את המודעה הכי טובה.

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

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

לפני שממשיכים במדריך, צריך להגדיר את Google Mobile Ads SDK (Legacy).

התחלת הטעינה מראש של מודעות

כשהאפליקציה מופעלת, קוראים ל-method‏ start פעם אחת. אחרי שמפעילים את השיטה start, ‏Google Mobile Ads SDK (Legacy) טוען מראש מודעות באופן אוטומטי ומנסה שוב לשלוח בקשות שנכשלו להגדרות שנטענו מראש.

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

Kotlin

// Define a PreloadConfiguration.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").build()
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration)
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration.
PreloadConfiguration configuration = new PreloadConfiguration.Builder("AD_UNIT_ID").build();
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration);
InterstitialAdPreloaderSnippets.java

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

אחזור והצגה של המודעה שנטענה מראש

כשמשתמשים בטעינת מודעות מראש, Google Mobile Ads SDK (Legacy) שומר מודעות במטמון. כדי להציג מודעה, מפעילים את ה-method‏ pollAd. ‫Google Mobile Ads SDK (Legacy) מאחזר מודעה זמינה וטוען מראש באופן אוטומטי את המודעה הבאה ברקע.

אל תפעילו את השיטה pollAd עד שתהיו מוכנים להציג מודעה. שמירת מודעות במטמון מאפשרת ל-Google Mobile Ads SDK (Legacy) לרענן באופן אוטומטי מודעות שפג תוקפן ולבצע אופטימיזציה של המטמון.

בדוגמה הבאה מוצג אחזור והצגה של מודעה שנטענה מראש:

Kotlin

// pollAd() returns the next available ad and loads another ad in the background.
val ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID")

// [Optional] Interact with the ad as needed.
ad?.onPaidEventListener = OnPaidEventListener {
  // [Optional] Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.
}

// Show the ad immediately.
ad?.show(activity)
InterstitialAdPreloaderSnippets.kt

Java

// pollAd() returns the next available ad and loads another ad in the background.
InterstitialAd ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID");

if (ad != null) {
  // [Optional] Interact with the ad object as needed.
  ad.setOnPaidEventListener(
      adValue -> {
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
      });

  // Show the ad immediately.
  ad.show(activity);
}
InterstitialAdPreloaderSnippets.java

איך בודקים אם יש מודעות זמינות לטעינה מראש

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

• איך בודקים אם יש מודעות שנטענו מראש
• האזנה לזמינות של מודעות שנטענות מראש

בדיקת הזמינות של מודעות שנטענו מראש

בדוגמה הבאה נבדקת הזמינות של המודעות:

Kotlin

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.kt

Java

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.java

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

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

אירועי טעינה מראש מיועדים למטרות ניתוח נתונים. בתוך פונקציות ה-callback של אירועי הטעינה מראש:

• אין צורך להתקשר אל start.
• אל תפעילו את pollAd אלא אם המודעה תוצג מיד.

בדוגמה הבאה מתבצע רישום לאירועי מודעות:

Kotlin

// Define a callback to receive preload events.
val callback =
  object : PreloadCallbackV2() {
    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo?) {
      // Called when preloaded ads are available.
    }

    override fun onAdsExhausted(preloadId: String) {
      // Called when no preloaded ads are available.
    }

    override fun onAdFailedToPreload(preloadId: String, adError: AdError) {
      // Called when preloaded ads failed to load.
    }
  }
InterstitialAdPreloaderSnippets.kt

Java

// Define a callback to receive preload events.
PreloadCallbackV2 callback =
    new PreloadCallbackV2() {
      @Override
      public void onAdPreloaded(
          @NonNull String preloadId, @Nullable ResponseInfo responseInfo) {
        // Called when preloaded ads are available.
      }

      @Override
      public void onAdsExhausted(@NonNull String preloadId) {
        // Called when no preloaded ads are available.
      }

      @Override
      public void onAdFailedToPreload(@NonNull String preloadId, @NonNull AdError adError) {
        // Called when preloaded ads failed to load.
      }
    };
InterstitialAdPreloaderSnippets.java

הפסקת הטעינה מראש של מודעות

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

Kotlin

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID")
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll()
InterstitialAdPreloaderSnippets.kt

Java

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID");
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll();
InterstitialAdPreloaderSnippets.java

הגדרת שטח האחסון הזמני

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

Kotlin

// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(2).build()
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
PreloadConfiguration configuration =
    new PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(2).build();
InterstitialAdPreloaderSnippets.java

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

‫Google Mobile Ads SDK (Legacy) אוכפת מגבלה על המספר הכולל של מודעות שנטענות מראש בכל האפליקציה, בכל יחידות המודעות ומזהי הטעינה מראש:

• מגבלת ברירת המחדל: ב-Google Mobile Ads SDK (Legacy) אפשר לשמור בזיכרון עד 6 מודעות שנטענו מראש. המגבלה הזו משותפת לכל הפורמטים ולכל המזהים של הטעינה מראש.
• מומלץ להגדיר שטח אחסון זמני של שני פריטים לכל מזהה טעינה מראש.

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