バナー広告を統合する

Vungle Agent

2024年09月17日 17:35

Vungle Banner は現在ベータ段階にあるため、バナー広告要求に対して広告レスポンスが制限される可能性があります。起動を成功させる方法については、アカウントマネージャーに直接お問い合わせください。

概要

Windows 用 Vungle SDK v6.5.2 以降、Vungle はバナー広告をサポートしています。MREC 広告とバナー広告の両方で API バージョン 16 以降が必要になります。

MREC 広告と同様に、バナー動画広告は、アプリのレイアウト内の任意の場所を占めるレクタングルの広告で、通常は画面の上部または下部に表示されるため、ユーザーは広告の再生中にアプリを引き続き操作できます。この広告フォーマットは全画面に表示する必要はありません。代わりに、パブリッシャー側のアプリケーションで、広告コンテナの位置を指定します。しかし、バナーコンテナのサイズは、320x50、300x50、または 728x90 (タブレットの場合) に設定できます。

バナー広告の要件

Windows 用 Vungle SDK v6.5.2
Windows 10 UWP

サポートされているバナーサイズ

バナー広告をレンダリングするためのコンテナサイズは、320x50、300x50、または 728x90 (タブレットの場合) にすることができます。画面のどこにでもバナー広告を設定でき、ユーザーは広告の再生中にアプリを使い続けることができます。

バナーサイズ	ディメンション
`VungleBannerSizes.Banner_320x50`	320x50
`VungleBannerSizes.BannerShort_300x50`	300x50
`VungleBannerSizes.BannerLeaderboard_728x90`	728x90

手順 1. 基本的な統合を完了する

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

手順 2. バナー広告を統合する

VungleAdControl を使用して、コンテナにバナー広告を読み込んで再生します。よりシンプルで簡単な統合のために、XAML のみを使用して VungleAdControl に制御を渡し、統合することができます。より詳細な制御を提供する統合の場合、XAML で広告コンテナーを指定し、プログラムでバナー広告を制御できます。

オプション 1. XAML を使用した簡単なバナー統合

バナー配置用の Vungle アプリ ID と広告配置 ID を使用して VungleAdControl を宣言する必要があります。この VungleAdControl は、isBannerAd を [True] に設定して渡すことでバナー広告用であることを指定し、AutoRun を [True] に設定して渡すことでバナー広告を自動的にロードして再生できます。

サンプルコード:

<UI:VungleAdControl x:Name="vungleBannerControl" AutomationProperties.AutomationId="vungleBannerControl"
    IsBannerAd="True"
    AutoRun="True"
    <!-- Specify dimensions: 320x50, 300x50, 728x90 -->
    Width="SIZE_OF_WIDTH" 
    Height="SIZE_OF_HEIGHT" 
    Margin="10" 
    HorizontalAlignment="Left"
    AppID="<YOUR_VUNGLE_APP_ID>"
    Placement="<YOUR_BANNER_PLACEMENT_ID>"
    <Border BorderBrush="Black" BorderThickness="1" Margin="10">
        <TextBlock Text="Banner Ads will show here..." VerticalAlignment="Center" HorizontalAlignment="Center"/>
    </Border>
</UI:VungleAdControl>

オプション 2. プログラム制御とのバナー統合

XAML をコードと組み合わせて使用すると、LoadBannerAd、PlayBannerAd、または LoadAndPlayBannerAd のタイミングをプログラムで制御し、アプリのライフサイクルの任意のタイミングでバナー広告を読み込んで再生することができます。

XAML で広告コンテナを指定します。 VungleAdControl は XAML で isBannerAd を True に設定して構成する必要があります。正しい Width と Height の値を渡して、表示するバナーサイズに合わせて広告コンテナのサイズを指定します。

XAML のサンプル:

<UI:VungleAdControl x:Name="vungleBannerControl" AutomationProperties.AutomationId="vungleBannerControl"
    IsBannerAd="True"
    Width="320" Height="50" Margin="10" HorizontalAlignment="Left">
    <Border BorderBrush="Black" BorderThickness="1" Margin="10">
        <TextBlock Text="Banner Ads will show here..." VerticalAlignment="Center" HorizontalAlignment="Center"/>
    </Border>
</UI:VungleAdControl>

VungleAdControl のアプリ ID を設定します。AppID API を使用して、VungleAdControl のアプリ ID を送信することから始めます。Vungle SDK はシングルトンクラスであり、一度に使用できるアプリ ID は 1 つだけであることに注意してください。フルスクリーン広告でバナー広告を再生している場合は、SDK を初期化する GetInstance 関数で使用するものと同じアプリ ID を渡します。

VungleAdControl のインスタンス化 :
```
VungleSDKConfig sdkConfig = new VungleSDKConfig();
sdkConfig.DisableBannerRefresh = true; // Default: false

sdkInstance = AdFactory.GetInstance(vungleAppID, sdkConfig);
this.vungleBannerControl.AppID = vungleAppID;
```

手順 3. バナー広告を読み込んで再生する

LoadAndPlayBannerAd API を使用して、バナー広告の読み込みと再生を同時に行うことができます。バナー広告をプリロードして後で再生する場合は、代わりに LoadBannerAd と PlayBannerAd を使用して、バナーの配置タイミングをより細かく制御できます。 UI スレッドで呼び出されるこれらの API を使用する場合は、バナー広告の広告配置 ID と、サポートされているバナーサイズを渡す必要があります。StopBannerAd を使用することで、いつでもバナー広告の表示を停止できます。

LoadAndPlayBannerAd:

await vungleBannerControl.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
    this.vungleBannerControl.LoadAndPlayBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);
});

LoadBannerAd:

this.vungleBannerControl.LoadBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);

PlayBannerAd:

this.vungleBannerControl.PlayBannerAd("YOUR_PLACEMENT_ID", VungleBannerSizes.Banner_320x50);

StopBannerAd:

this.vungleBannerControl.StopBannerAd();

概要