שנתחיל?
מודעות שכבת-על מותאמות מוצגות למשתמשים באמצעות רכיבים בממשק המשתמש לפלטפורמה. המודעות האלה מוצגות כשכבת-על מעל תרגום מכונה. אופן הפעולה הזה דומה לאופן הפעולה של מודעות באנר, אבל היכולת להתאים אישית את מראה המודעות.
מודעות שכבת-על מותאמות תומכות בתהליך בחירת הרשת ובמודעות וידאו. זה יתרון מרכזי יש מודעות שכבת-על מותאמות לעומת מודעות מותאמות.
במדריך הזה מוסבר איך להטמיע מודעות שכבת-על מותאמות באפליקציה ל-Unity כמה דברים שחשוב להביא בחשבון בדרך.
דרישות מוקדמות
- מבצעים את ההוראות במדריך לתחילת העבודה.
- פלאגין Unity מגרסה 9.0.0 ואילך.
ביצוע בדיקות באמצעות מודעות בדיקה תמיד
הקוד לדוגמה הבא מכיל מזהה של יחידת מודעות שאפשר להשתמש בו כדי לבקש מודעות לבדיקה. הוא הוגדר במיוחד להחזרת מודעות בדיקה במקום מודעות בסביבת הייצור לכל בקשה, כך שאפשר להשתמש בה בצורה בטוחה.
עם זאת, אחרי שרשמתם אפליקציה בממשק האינטרנט של AdMob ויחידת מודעות משלך מזהים לשימוש באפליקציה, צריך להגדיר את המכשיר כבדיקה באופן מפורש המכשיר במהלך ופיתוח.
Android
ca-app-pub-3940256099942544/2247696110
iOS
ca-app-pub-3940256099942544/3986624511
טעינת מודעת שכבת-העל המותאמת
הטעינה של מודעת שכבת-על מותאמת מתבצעת באמצעות שיטת ה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;
}
}
השלבים הבאים
- כדי לקבל מידע נוסף על מודעות מותאמות, אפשר לעיין במדריך בנושא מודעות מותאמות.
- כדאי לעיין במאמר מדיניות והנחיות בנושא מודעות מותאמות.