バナー広告と MREC 広告を統合する

Vungle Agent

2024年09月17日 17:36

概要

Vungle は、次の 3 つのバナーサイズと標準の MREC サイズをサポートしています。

`VungleBannerSize`	ディメンション
`VungleAdSizeBanner`	320.0f x 50.0f
`VungleAdSizeBannerShort`	300.0f x 50.0f
`VungleAdSizeBannerLeaderboard`	728.0f x 90.0f (タブレットの場合)
`VungleAdSizeBannerMedium`	300.0f x 250.0f (MREC)

バナー広告について

Vungle Banner は現在ベータ段階にあります。起動を成功させる方法については、アカウントマネージャーに直接お問い合わせください。

Vungle Unity プラグインは、Unity 用 Vungle SDK v6.7.0.0 以降のバナー広告と MREC 広告をサポートしています。この広告形式はフルスクリーンを必要としない代わりに、パブリッシャーがアプリ内の広告コンテナの場所を決定します。ただし、バナーコンテナのサイズは、320x50、300x50、または 728x90 (タブレットの場合) のいずれかである必要があります。画面のどこにでもバナー広告を設定でき、ユーザーは広告の再生中にアプリを使い続けることができます。さまざまなバナーサイズを一覧表示する列挙型は、VungleSDK.h ファイルにあります (以下の表にも記載されています)。

いずれの場合もフルスクリーン以外の広告数に制限はありませんが、プラグインは複数の広告が同じ位置に表示されているかどうかをチェックしません。プラグインによって提供される任意の位置に対して単一の広告を呼び出していることを確認し、複数の広告を表示している場合は、互いに重複しないようにしてください。

`VungleBannerPosition`	表示上の広告の位置
`TopLeft`	左上隅
`TopCenter`	中央上部
`TopRight`	右上隅
`Centered`	中央
`BottomLeft`	左下隅
`BottomCenter`	中央下部
`BottomRight`	右下隅

バナー広告の広告配置タイプは、Vungle ダッシュボードで「バナー」タイプである必要があります。ダッシュボードでのバナーの配置を有効にするには、アカウントマネージャーに連絡してください。

MREC 広告について

Vungle SDK v.6.4.3 以降、Vungle は MREC 動画広告をサポートしています。MREC とは、「medium rectangle (中程度のレクタングル)」広告の略称です。インタースティシャル広告とは異なり、MREC 広告はフルスクリーン表示を必要としません。バナー広告と同様に、MREC 動画広告は、アプリのレイアウト内の任意の場所を占めるレクタングルの広告で、通常は画面の上部または下部に表示されるため、ユーザーは広告の再生中にアプリを引き続き操作できます。MREC 広告をレンダリングするためのコンテナサイズは、業界標準の 300x250 です。

手順 1. 基本的なプラグイン統合を完了する

バナー広告と MREC 広告を Unity アプリに統合するには、基本的なプラグイン統合の記事の手順に従って開始します。この記事には補足情報が含まれており、基本的な統合が完了していることを前提としています。

手順 2. イベントハンドラー (オプション) を実装する

イベントハンドラーは、広告の提示に関連する 5 つすべての Vungle SDK イベントについて設定できます。

SDK によって動画広告の再生が開始されると、以下のイベントが起動します。ゲームプレイ、音響効果、アニメーションなどを一時停止する場合は、このイベントを使用すると便利です。
```
public static event Action onAdStartedEvent;
```
SDK によって広告が終了すると、以下のイベントが起動します。ユーザーに報酬を与える場合や、ゲームプレイ、音響効果、アニメーションなどを再開する場合は、このイベントを使用すると便利です。
```
public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;
```
AdFinishedEventArgs クラスは、以下のプロパティから構成されています。これらのプロパティにより、広告の再生結果を確認することができます。
```
public class AdFinishedEventArgs : EventArgs
{
  //Represents a BOOL whether or not the user clicked the download button.
  public bool WasCallToActionClicked{ get; set;}

  //Represents a bool whether or not the video can be considered a completed view.
  public bool IsCompletedView{ get; set;}
}
```
SDK によって広告の可用性ステータスが変更されると、以下のイベントが起動します。ブール値の isAdPlayable は、placementID で指定された ID を持つ広告が再生可能かどうかを示します。
```
public static event Action<string, bool> adPlayableEvent;
```
SDK が正常に初期化されると、以下のイベントが起動します。
```
public static event Action onInitializeEvent;
```

サンプルコード:

void initializeEventHandlers()
{
    Vungle.onAdStartedEvent += (placementID) => {
        DebugLog ("Ad " + placementID + " is starting!  Pause your game  animation or sound here.");
    };

    Vungle.onAdFinishedEvent += (placementID, args) => {
        DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked +  ", is completed view:"
                  + args.IsCompletedView);
    };

    Vungle.adPlayableEvent += (placementID, adPlayable) => {
        DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
    };

    Vungle.onInitializeEvent += () => {
        adInited = true;
        DebugLog ("SDK initialized");
    };
}

手順 3. 広告を読み込み、再生し、閉じる

広告を読み込む

フルスクリーン以外の広告の読み込みはフルスクリーン広告とは動作が異なり、読み込みに使用する特定のloadBanner API があります。フルスクリーン以外の広告を読み込む際にはサイズと位置を指定する必要があります。SDK は、ダッシュボードで構成した時間間隔で広告を自動的に更新します。バナー広告または MREC 広告用に作成された広告配置を使用する必要があります。

loadBanner メソッドを呼び出してフルスクリーン以外の広告を読み込みます。

Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);

広告を表示する

フルスクリーン以外の広告は、showBanner を呼び出すと、loadBanner を呼び出したときに指定したサイズの位置に表示されます。

Vungle.showBanner("PLACEMENT_ID");

広告を再生する前に広告の可用性を確認し、isAdvertAvailable がフルスクリーンの広告と同じように使用可能であることを確認することをお勧めします。ただし、フルスクリーン以外の広告の場合は、表示する広告の広告配置 ID に加えて VungleBannerSize を渡す必要があります。

Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);

広告を閉じる

フルスクリーン以外の広告を取り下げたい場合は、closeBanner を呼び出します。

Vungle.closeBanner("PLACEMENT_ID");

概要