시작하기
네이티브 오버레이 광고는 네이티브인 UI 구성요소를 통해 사용자에게 표시됩니다. 있습니다. 이러한 광고는 페이지 상단에 오버레이로 표시되며, 애플리케이션입니다. 이는 배너 광고의 작동 방식과 유사하지만 광고의 모양을 맞춤설정할 수 있습니다.
네이티브 오버레이 광고는 미디에이션 및 동영상 광고를 지원합니다. 이것이야말로 네이티브 오버레이 광고가 네이티브 광고보다 우선합니다.
이 가이드에서는 Unity 앱에서 네이티브 오버레이 광고를 구현하는 방법과 이 과정에서 고려해야 할 몇 가지 중요한 사항으로 소개하겠습니다.
기본 요건
- 시작 가이드를 모두 읽어보세요.
- Unity 플러그인 9.0.0 이상
항상 테스트 광고로 테스트
다음 샘플 코드에는 요청에 사용할 수 있는 광고 단위 ID가 포함되어 있습니다. 테스트 광고 테스트 광고를 반환하도록 특별히 구성된 경우 만들기 때문에 안전하게 사용할 수 있습니다.
하지만 광고 단위를 직접 만들었으며 앱에서 사용할 ID를 확인하고 기기를 테스트로 명시적으로 구성하세요. 기기에서 살펴봤습니다
/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;
}
}