שנתחיל?

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

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

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

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

• קוראים את המדריך לתחילת העבודה.
• הפלאגין של Unity מגרסה 9.0.0 ואילך.

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

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

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

/21775744923/example/native

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

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

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

// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/example/native";



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;
    }
}