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

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

שנתחיל?

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

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

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

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

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

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

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

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

/21775744923/example/native

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

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

הקוד הבא משתמש ב-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;
    }
}