MREC 広告を統合する

概要

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

VungleAdControl は、AdConfig.AdContainer プロパティを介してカスタム コンテナを Vungle SDK に渡し、ホスト アプリケーションの Container.Content のコンテンツを管理することによって、動画広告をネイティブ フォーマットで実現します。

MREC 広告の要件

• Windows SDK 5.1.0+
• Windows 10 UWP
• Vungle ダッシュボードで構成された MREC 広告配置
• VungleAdControl 幅 300、高さ 250

VungleAdControl

Vungle MREC クリエイティブは、300x250 のサイズでコンテナを表示し、再生するように最適化されています。VungleAdContrl の表示サイズが幅 300 以上、高さ 250 以上であることを確認してください。

.xaml

<UI:VungleAdControl x:Name="embeddedControl" 
                    Width="300"
                    Height="250" />

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

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

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

MREC 広告を読み込む

MREC 広告配置を使用して MREC 広告を読み込むことは、フルスクリーン広告を読み込むこととまったく同じです。

.cs

sdkInstance.LoadAd("MREC_PLACEMENT_REFERENCE_ID")

MREC 広告を再生する

VungleAdControl を使用して広告を再生するには、AppID、Placements、および Placement を渡す必要があります。SoundEnabled を false に設定して、ミュートとして再生を開始するように MREC 広告を設定することもできます。

.cs

embeddedControl.AppID = "VUNGLE_APP_ID";
embeddedControl.Placements = "MREC_PLACEMENT_REFERENCE_ID";
embeddedControl.Placement = "MREC_PLACEMENT_REFERENCE_ID";

embeddedControl.SoundEnabled = false; // Optional (default = true)

await embeddedControl.PlayAdAsync();

MREC 広告の表示を停止する

StopBannerAd を使用して MREC 広告の表示をいつでも停止することができます。

.cs

embeddedAdControl.StopBannerAd();

代替案: XAML を使用した簡単な MREC 統合

VungleAdControl は、イベント リスナーが必要ではない場合に MREC 広告を統合したり、広告の読み込みのタイミングを制御したりするためのより簡単な方法を提供します。SDK が初期化されると、MREC 広告が自動的に読み込まれ、広告アセットのダウンロードが完了した後、PlayAdAsync を発行できます。

.xaml

<UI:VungleAdControl x:Name="embeddedControl" 
                    Width="300"
                    Height="250"
                    Placement="MREC-5209003"
                    Placements="MREC-5209003"
                    SoundEnabled="False" />

.cs

await embeddedControl.PlayAdAsync();