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

בחירת פלטפורמה: Android (בטא) חדש Android iOS Unity

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

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

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

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

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

לפני שממשיכים במדריך, צריך לבצע את הפעולות הבאות:

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

כדי להתחיל בטעינה מראש של מודעות, צריך להתקשר אל Preload(). צריך להפעיל את השיטה הזו רק פעם אחת בתחילת האפליקציה. אחרי שמפעילים את Preload(), המערכת Google Mobile Ads Unity Plugin טוענת מראש מודעות באופן אוטומטי ומנסה שוב בקשות שנכשלו להגדרות שנטענו מראש.

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

var preloadConfiguration = new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
};

// Start the preloading initialization process after MobileAds.Initialize().
InterstitialAdPreloader.Preload(
    // The Preload ID can be any unique string to identify this configuration.
    AD_UNIT_ID,
    preloadConfiguration);

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

כשמשתמשים בטעינה מראש של מודעות, Google Mobile Ads Unity Plugin שומר מודעות במטמון. כשרוצים להציג מודעה, קוראים ל-DequeueAd(). Google Mobile Ads Unity Plugin מאחזרת את המודעה הזמינה ומטעינה מראש באופן אוטומטי את המודעה הבאה ברקע.

מומלץ להימנע מהפעלת ה-method הזו עד שמוכנים להציג מודעה. שמירת מודעות במטמון מאפשרת ל-Google Mobile Ads Unity Plugin לרענן באופן אוטומטי מודעות שתוקפן פג ולבצע אופטימיזציה של המטמון.

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

// DequeueAd returns the next available ad and loads another ad in the background.
var ad = InterstitialAdPreloader.DequeueAd(AD_UNIT_ID);

if (ad != null)
{
    // [Optional] Interact with the ad object as needed.
    ad.OnAdPaid += (AdValue value) =>
    {
        Debug.Log($"Ad paid: {value.CurrencyCode} {value.Value}");
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
    };

    // Do not hold onto preloaded ads, always show a preloaded ad immediately.
    ad.Show();
}

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

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

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

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

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable(AD_UNIT_ID);

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

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

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

  • אל תתקשר אל Preload().
  • אל תפעילו את הפונקציה DequeueAd() אלא אם המודעה תוצג באופן מיידי.

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


void StartPreloadWithCallbacks()
{
    var preloadConfiguration = new PreloadConfiguration
    {
        AdUnitId = AD_UNIT_ID,
        Request = new AdRequest(),
    };

    // Start the preloading initialization process after MobileAds.Initialize().
    InterstitialAdPreloader.Preload(
        // The Preload ID can be any unique string to identify this configuration.
        AD_UNIT_ID,
        preloadConfiguration,
        onAdPreloaded,
        onAdFailedToPreload,
        onAdsExhausted);
}

void onAdPreloaded(string preloadId, ResponseInfo responseInfo)
{
    Debug.Log($"Preload ad configuration {preloadId} was preloaded.");
}

void onAdFailedToPreload(string preloadId, AdError adError)
{
    string errorMessage = $"Preload ad configuration {preloadId} failed to " +
                          $"preload with error : {adError.GetMessage()}.";
    Debug.Log(errorMessage);
}

void onAdsExhausted(string preloadId)
{
    Debug.Log($"Preload ad configuration {preloadId} was exhausted");
    // [Important] Don't call Preload() or DequeueAd() from onAdsExhausted.
}

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

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

InterstitialAdPreloader.Destroy(AD_UNIT_ID);
InterstitialAdPreloader.DestroyAll();

הגדרת גודל המאגר

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

new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
    BufferSize = 5
};