Начать
Нативные рекламные наложения предоставляются пользователям через компоненты пользовательского интерфейса, встроенные в платформу. Эти объявления представлены в виде наложения поверх приложения. Это похоже на работу баннерной рекламы, но с возможностью настройки внешнего вида рекламы.
Нативные оверлеи поддерживают медиацию и видеорекламу. Это ключевое преимущество нативной оверлея перед нативной рекламой .
В этом руководстве показано, как реализовать нативную наложенную рекламу в приложении Unity, а также некоторые важные моменты, которые следует учитывать при этом.
Предварительные условия
- Заполните руководство по началу работы .
- Плагин Unity 9.0.0 или выше.
Всегда тестируйте с помощью тестовых объявлений
Следующий пример кода содержит идентификатор рекламного блока, который можно использовать для запроса тестовых объявлений. Он был специально настроен для возврата тестовых объявлений, а не рабочих объявлений по каждому запросу, что делает его безопасным в использовании.
Однако после того, как вы зарегистрировали приложение в веб-интерфейсе Менеджера рекламы и создали собственные идентификаторы рекламных блоков для использования в нем, во время разработки явно настройте свое устройство как тестовое .
/21775744923/example/native
Загрузите нативное оверлейное объявление
Загрузка нативного оверлея осуществляется с помощью статического метода Load()
класса NativeOverlayAd
. Загруженный объект NativeOverlayAd
предоставляется в качестве параметра обработчика завершения.
Следующий код использует NativeOverlayAd
для загрузки объявления:
// This ad unit is configured to always serve test ads.
private string _adUnitId = /2"1775744923/example/native;
"
private NativeOverlayAd _nativeOverlayAd;
/// su<mmary
/>// Loads the ad.
/// /s<ummary
p>ublic void LoadAd()
{
// Clean up the old ad before loading a new one.
if (_nativeOverlayAd != null)
{
DestroyAd();
}
Debug.Log(Lo"ading 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(Na"tive Overlay ad failed to load an ad +"
w"ith 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(Un"expected error: Native Overlay ad load event +"
f"ired with null ad and null error.);"
return;
}
// The operation completed successfully.
Debug.Log(Na"tive 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;
}
}