コンテンツにスキップ
Support Center | AppLovin

バナーおよびMREC広告

次のセクションでは、バナーまたはMREC広告をロードし、表示または非表示にする方法について説明します。

バナーまたはMRECのローディング

バナーまたはMRECをロードするには、広告ユニットIDと希望する広告表示位置を指定して、以下のようなコードを使用します。

#if UNITY_IOS
string bannerAdUnitId = "«iOS-ad-unit-ID»"; // Retrieve the ID from your account
#else // UNITY_ANDROID
string bannerAdUnitId = "«Android-ad-unit-ID»"; // Retrieve the ID from your account
#endif


public void InitializeBannerAds()
{
  // Banners are automatically sized to 320×50 on phones and 728×90 on tablets
  // You may call the utility method MaxSdkUtils.isTablet() to help with view sizing adjustments
  MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter);


  // Set background or background color for banners to be fully functional
  MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, «banner-background-color»);


  MaxSdkCallbacks.Banner.OnAdLoadedEvent      += OnBannerAdLoadedEvent;
  MaxSdkCallbacks.Banner.OnAdLoadFailedEvent  += OnBannerAdLoadFailedEvent;
  MaxSdkCallbacks.Banner.OnAdClickedEvent     += OnBannerAdClickedEvent;
  MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnBannerAdRevenuePaidEvent;
  MaxSdkCallbacks.Banner.OnAdExpandedEvent    += OnBannerAdExpandedEvent;
  MaxSdkCallbacks.Banner.OnAdCollapsedEvent   += OnBannerAdCollapsedEvent;
}


private void OnBannerAdLoadedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {}


private void OnBannerAdLoadFailedEvent(string adUnitId, MaxSdkBase.ErrorInfo errorInfo) {}


private void OnBannerAdClickedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {}


private void OnBannerAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {}


private void OnBannerAdExpandedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo)  {}


private void OnBannerAdCollapsedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {}

Set your banner background color to a #-prefixed hexadecimal RGB string, for example '#000000' (black) or '#fff200' (yellow).

位置オプションの完全なリストは以下のとおりです。

  • TopLeft
  • TopCenter
  • TopRight
  • Centered
  • CenterLeft
  • CenterRight
  • BottomLeft
  • BottomCenter
  • BottomRight

広告を画面の特定の座標 (x, y) に配置するには、MaxSdk.CreateBanner(«ad-unit-ID», «x», «y»); または MaxSdk.CreateMRec(«ad-unit-ID», «x», «y»); を呼び出してください。 これにより、広告の左上の位置が設定されます。 座標系は画面のセーフエリアの境界を表します。これらの座標を設定する際は、広告の幅と高さを考慮してください。 位置 (0, 0) はTopLeftに相当します。セーフエリアの右下は (safeAreaWidth, safeAreaHeight)です。 Unityの画面サイズやセーフエリアサイズが、AndroidやiOSの仕様と異なる場合がありますのでご注意ください。 Unityの画面サイズとAndroidやiOSで使用されるサイズを変換するには、次のようなコードを使用してください。

var density = MaxSdkUtils.GetScreenDensity();
var dp = «pixels» / density;

バナーまたはMRECを表示

バナーまたはMRECを表示するには、次の呼び出しを行います。

MaxSdk.ShowBanner(«ad-unit-ID»);

バナーまたはMRECを非表示に設定

バナーまたはMRECを非表示にするには、次の呼び出しを行います。

MaxSdk.HideBanner(«ad-unit-ID»);

バナーまたはMRECを破棄

広告インスタンスが不要になる場合があります（例えば、ユーザーが広告削除を購入した場合など）。 その際は、DestroyBanner() または DestroyMRec() メソッドを呼び出してリソースを解放してください。 同じ広告ユニットIDを持つ複数の広告インスタンスを使用する場合は、DestroyBanner()あるいはDestroyMRec()を呼びださないでください。

MaxSdk.DestroyBanner(«ad-unit-ID»);

バナー位置を取得

バナーの位置とサイズを取得するには、GetBannerLayout()を呼び出します。 これにはバナーまたはMRECをロードで説明しているものと同じUnityの座標系を使用します。

Rect bannerLayout = MaxSdk.GetBannerLayout(«ad-unit-ID»);

バナー幅を設定

バナーの幅を手動で設定するには、SetBannerwidth()を呼び出します。 幅を最小値より大きいサイズに設定してください（スマートフォンでは320、タブレットでは728）。 この幅以下のバナーは、広告主に閲覧可能と見なされない可能性があり、これが収益に影響を与えることがあります。

MaxSdk.SetBannerWidth(«ad-unit-ID», «width»);

バナーの幅を最小値よりも小さく設定すると、ログにエラーメッセージが表示されます。 例：

[AppLovinSdk] [MAUnityAdManager] The provided width: 300.000000 is smaller than the minimum required width: 320.000000 for ad format: [MAAdFormat: BANNER]. Please set the width higher than the minimum required.

アダプティブバナー

アダプティブバナーは、デバイスの種類やバナーの幅に基づいて高さが調整される、レスポンシブなバナーです。 アダプティブバナーを作成するには、AppLovin MAX Unityプラグインのバージョンに基づいて、以下の手順を参照してください。

AppLovin MAX Unityプラグイン < 3.2.2

アダプティブバナーは、3.2.2以前のバージョンのMAX Unityプラグインでは利用できません。

AppLovin MAX Unityプラグイン 3.2.2–4.3.0

アダプティブバナーを作成するには、バナーを作成する際にバナーの追加パラメーターであるadaptive_bannerをtrueに設定します。以下の例をご覧ください。

#if UNITY_IOS
string bannerAdUnitId = "«ios_ad-unit-ID»"; // Retrieve the ID from your account
#else // UNITY_ANDROID
string bannerAdUnitId = "«android_ad-unit-ID»"; // Retrieve the ID from your account
#endif


public void InitializeBannerAds()
{
  // Adaptive banners are sized based on device width for positions that stretch full width (TopCenter and BottomCenter).
  // You may use the utility method `MaxSdkUtils.GetAdaptiveBannerHeight()` to help with view sizing adjustments
  MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter);
  MaxSdk.SetBannerExtraParameter(bannerAdUnitId, "adaptive_banner", "true");


  // Set background or background color for banners to be fully functional
  MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, «background_color»);
}

MaxSdkUtils.GetAdaptiveBannerheight()を呼び出してバナーの高さを取得し、それに応じてコンテンツを調整します。

AppLovin MAX Unityプラグイン 4.3.1以降

アダプティブバナーをサポートしている広告ネットワークのバナーは、デフォルトで「アダプティブ」に設定されています。 アダプティブバナーを無効にする場合は、バナーに追加パラメーターであるadaptive_bannerをfalseに設定します。以下の例をご覧ください。

#if UNITY_IOS
string bannerAdUnitId = "«ios_ad-unit-ID»"; // Retrieve the ID from your account
#else // UNITY_ANDROID
string bannerAdUnitId = "«android_ad-unit-ID»"; // Retrieve the ID from your account
#endif


public void InitializeBannerAds()
{
  MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter);
  MaxSdk.SetBannerExtraParameter(bannerAdUnitId, "adaptive_banner", "false");


  // Set background or background color for banners to be fully functional
  MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, «background_color»);
}

MaxSdkUtils.GetAdaptiveBannerheight()を呼び出してバナーの高さを取得し、それに応じてコンテンツを調整します。

自動更新の停止と開始

広告の自動更新は停止することができます（例：バナー広告を手動で更新したい場合など）。 バナーまたはMREC広告の自動更新を停止するには、次のコードを使用します。

MaxSdk.StopBannerAutoRefresh(«ad-unit-ID»);

以下のコードで、バナーまたはMREC広告の自動更新を開始します。

MaxSdk.StartBannerAutoRefresh(«ad-unit-ID»);

次のコードを使用して、コンテンツを手動で更新してください。 LoadBanner()またはLoadMRec()を呼び出す前に、自動更新を停止する必要があります。

MaxSdk.LoadBanner(«ad-unit-ID»);
© 2024 AppLovin
ご利用規約 | プライバシー | EULA | DMCA | Cookie設定