מודעות שכבת-על מותאמות

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

שנתחיל?

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

מודעות שכבת-על מותאמות תומכות בתהליך בחירת הרשת ובמודעות וידאו. זהו יתרון משמעותי של מודעות שכבת-על מותאמות על פני מודעות מותאמות.

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

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

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

• מגדירים את Google Mobile Ads Unity Plugin.
• מתקינים את הפלאגין של Unity בגרסה 9.0.0 ואילך.

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

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

טעינת מודעת שכבת-העל המותאמת

כדי לטעון מודעת שכבת-על מותאמת, משתמשים ב-method הסטטי Load() במחלקה NativeOverlayAd. אובייקט NativeOverlayAd שנטען מסופק כפרמטר ב-handler של ההשלמה.

הקוד הבא משתמש ב-NativeOverlayAd כדי לטעון מודעה:

  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/2247696110";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/3986624511";
#else
  private string _adUnitId = "unused";
#endif


private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

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

מודעות שכבת-על מותאמות מוצגות באמצעות NativeTemplateStyle. המחלקה הזו מגדירה שדות שמאפשרים להתאים אישית את מראה המודעה.

הפרמטר TemplateID הוא מחרוזת חובה שמגדירה את התבנית המותאמת שמשמשת לעיבוד של מודעת שכבת-העל המותאמת. משתמשים בקבוע NativeTemplateID כדי לבחור תבנית מותאמת שמתאימה למודעה.

הקוד הבא מציג את מודעת שכבת-העל המותאמת עם תבנית בינונית וסגנון אישי.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

הצגה והסתרה של מודעת שכבת-העל המותאמת

הקוד הבא מדגים איך להציג מודעת שכבת-על מותאמת שנטענה.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

הסתרת מודעת שכבת-העל המותאמת

הקוד הבא מדגים איך להסתיר מודעת שכבת-על מותאמת.

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

השמדת מודעת שכבת-העל המותאמת

כשמסיימים להשתמש במודעת שכבת-העל המותאמת, חשוב להפעיל את Destroy() כדי לשחרר משאבים.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}

השלבים הבאים

• מידע נוסף על מודעות מותאמות זמין במדריך למודעות מותאמות.
• מדיניות והנחיות בנושא מודעות מותאמות