スポット広告

[アーティクル]
07/05/2024

警告

2020 年 6 月 1 日以降、Windows UWP アプリ用の Microsoft の広告の収益化プラットフォームはシャットダウンされます。詳細情報

このチュートリアルでは、Windows 10 および Windows 11 のユニバーサル Windows プラットフォーム (UWP) アプリとゲームにスポット広告を含める方法について説明します。 C# と C++ を使用して JavaScript/HTML アプリと XAML アプリにスポット広告を追加する方法を示す完全なサンプルプロジェクトについては、GitHub のサンプルを参照してください。

スポット広告とは

アプリやゲームの UI の一部に限定されている標準のバナー広告とは異なり、スポット広告は画面全体に表示されます。ゲームでは、2 つの基本的なフォームが頻繁に使用されます。

Paywall広告では、ユーザーは一定の間隔で広告を視聴する必要があります。たとえば、ゲームレベル間では次のようになります。
Rewards Based ではユーザーはレベルを完了するためのヒントや余分な時間など、何らかの利点を明示的に求め、アプリのユーザーインターフェイスを使用して広告を初期化します。

アプリとゲームで使用するスポット広告には、インタースティシャル動画広告インタースティシャルバナー広告の 2 種類があります。

Note

スポット広告用 API は、ビデオ再生時を除き、ユーザーインターフェイスを処理しません。アプリにスポット広告を統合する方法を検討する場合は、のベストプラクティスに関するガイドラインを参照してください。

前提条件

Visual Studio 2015 以降のリリースの Visual Studio でMicrosoft Advertising SDK をインストールします。インストール手順については、この記事参照してください。

スポット広告をアプリに統合する

アプリにスポット広告を表示するには、プロジェクトの種類の指示に従います。

XAML/.NET
HTML/JavaScript
C++ (DirectX 相互運用)

XAML/.NET

このセクションでは C# の例を示しますが、VISUAL Basic と C++ は XAML/.NET プロジェクトでもサポートされています。完全な C# コード例については、C# の Interstitial ad サンプルコードを参照してください。

Visual Studio でプロジェクトを開きます。

Note

既存のプロジェクトを使用している場合は、プロジェクトで Package.appxmanifest ファイルを開き、 Internet (クライアント) 機能が選択されていることを確認します。アプリでは、テスト広告とライブ広告を受け取るためにこの機能が必要です。
プロジェクトのターゲットが [Any CPU] (任意の CPU) になっている場合は、アーキテクチャ固有のビルド出力 (たとえば、[x86]) を使うようにプロジェクトを更新します。プロジェクトのターゲットが [Any CPU] (任意の CPU) になっていると、次の手順で Microsoft Advertising ライブラリへの参照を正常に追加できません。詳しくは、「プロジェクトのターゲットを "Any CPU" に設定すると参照エラーが発生する」をご覧ください。
プロジェクトで Microsoft Advertising SDK への参照を追加します。
1. [ソリューションエクスプローラー] ウィンドウで、[参照設定] を右クリックし、[参照の追加] を選択します。
2. Reference Managerで、Universal Windowsを展開し、Extensionsをクリックし、XAML 用 Microsoft Advertising SDK (バージョン 10.0) の横にあるチェックボックス選択します。
3. [参照マネージャー] で、[OK] をクリックします。
アプリの適切なコードファイル (たとえば、MainPage.xaml.csまたは他のページのコードファイル) に、次の名前空間参照を追加します。
```
using Microsoft.Advertising.WinRT.UI;
```
アプリ内の適切な場所 (たとえば、 MainPage やその他のページ) で、 InterstitialAd オブジェクトと、スポット広告のアプリケーション ID と広告ユニット ID を表す複数の文字列フィールドを宣言します。次のコード例では、スポット広告の myAppId フィールドと myAdUnitId フィールドをテスト値に割り当てます。

Note

すべての InterstitialAd には対応する adユニットがあり コントロールに広告を配信するために使用され、すべての広告ユニットは adユニットID と アプリケーションIDで構成されています。これらの手順では、テスト広告ユニット ID とアプリケーション ID の値をコントロールに割り当てます。これらのテスト値は、テストバージョンのアプリでのみ使用できます。ストアにアプリを公開する前に、これらのテスト値をパートナーセンターから取得した実際の値に置き換える必要があります。
```
InterstitialAd myInterstitialAd = null;
string myAppId = "d25517cb-12d4-4699-8bdc-52040c712cab";
string myAdUnitId = "test";
```

起動時に実行されるコード (ページのコンストラクターなど) で、 InterstitialAd オブジェクトをインスタンス化し、オブジェクトのイベントのイベントハンドラーを接続します。

myInterstitialAd = new InterstitialAd();
myInterstitialAd.AdReady += MyInterstitialAd_AdReady;
myInterstitialAd.ErrorOccurred += MyInterstitialAd_ErrorOccurred;
myInterstitialAd.Completed += MyInterstitialAd_Completed;
myInterstitialAd.Cancelled += MyInterstitialAd_Cancelled;

インタースティシャルビデオ広告を表示する場合: 広告が必要になるまでに約 30 ~ 60 秒後に、RequestAd メソッドを使用して広告をプリフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類 AdType.Video を指定してください。
```
myInterstitialAd.RequestAd(AdType.Video, myAppId, myAdUnitId);
```
バナー広告を表示する場合: 広告が必要になるまでに約 5 ~ 8 秒後に、RequestAd メソッドを使用して広告を事前にフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類 AdType.Display を指定してください。
```
myInterstitialAd.RequestAd(AdType.Display, myAppId, myAdUnitId);
```
スポットビデオまたはスポットバナー広告を表示するコード内のポイントで、 InterstitialAd を表示する準備ができていることを確認し、 Show メソッドを使用して表示します。
```
if (InterstitialAdState.Ready == myInterstitialAd.State)
{
    myInterstitialAd.Show();
}
```

InterstitialAd オブジェクトのイベントハンドラーを定義します。

void MyInterstitialAd_AdReady(object sender, object e)
{
    // Your code goes here.
}

void MyInterstitialAd_ErrorOccurred(object sender, AdErrorEventArgs e)
{
    // Your code goes here.
}

void MyInterstitialAd_Completed(object sender, object e)
{
    // Your code goes here.
}

void MyInterstitialAd_Cancelled(object sender, object e)
{
    // Your code goes here.
}

アプリをビルドしてテストし、テスト広告が表示されていることを確認します。

HTML/JavaScript

次の手順では、Visual Studio で JavaScript 用のユニバーサル Windows プロジェクトを作成し、特定の CPU を対象としていることを前提としています。完全なコードサンプルについては、JavaScript の Interstitial ad サンプルコードを参照してください。

Visual Studio でプロジェクトを開きます。
プロジェクトのターゲットが [Any CPU] (任意の CPU) になっている場合は、アーキテクチャ固有のビルド出力 (たとえば、[x86]) を使うようにプロジェクトを更新します。プロジェクトのターゲットが [Any CPU] (任意の CPU) になっていると、次の手順で Microsoft Advertising ライブラリへの参照を正常に追加できません。詳しくは、「プロジェクトのターゲットを "Any CPU" に設定すると参照エラーが発生する」をご覧ください。
プロジェクトで Microsoft Advertising SDK への参照を追加します。
1. [ソリューションエクスプローラー] ウィンドウで、[参照設定] を右クリックし、[参照の追加] を選択します。
2. [参照マネージャー] で、[ユニバーサル Windows] を展開し、[拡張] をクリックして、[Microsoft Advertising SDK for JavaScript] (バージョン 10.0) の横にあるチェックボックスをオンにします。
3. [参照マネージャー] で、[OK] をクリックします。
プロジェクトの HTML ファイルの <head> セクションで、default.cssとdefault.jsのプロジェクトの JavaScript 参照の後に、ad.jsへの参照を追加します。
```
<script src="//Microsoft.Advertising.JavaScript/ad.js"></script>
```
プロジェクトの.js ファイルで、 InterstitialAd オブジェクトと、スポット広告のアプリケーション ID と広告ユニット ID を含む複数のフィールドを宣言します。次のコード例では、スポット広告の applicationId フィールドと adUnitId フィールドをテスト値に割り当てます。

Note

すべての InterstitialAd には対応する adユニットがあり コントロールに広告を配信するために使用され、すべての広告ユニットは adユニットID と アプリケーションIDで構成されています。これらの手順では、テスト広告ユニット ID とアプリケーション ID の値をコントロールに割り当てます。これらのテスト値は、テストバージョンのアプリでのみ使用できます。ストアにアプリを公開する前に、これらのテスト値をパートナーセンターから取得した実際の値に置き換える必要があります。
```
var interstitialAd = null;
var applicationId = "d25517cb-12d4-4699-8bdc-52040c712cab";
var adUnitId = "test";
```

起動時に実行されるコード (ページのコンストラクターなど) で、 InterstitialAd オブジェクトをインスタンス化し、オブジェクトのイベントハンドラーを接続します。

interstitialAd = new MicrosoftNSJS.Advertising.InterstitialAd();
interstitialAd.onErrorOccurred = errorOccurredHandler;
interstitialAd.onAdReady = adReadyHandler;
interstitialAd.onCancelled = cancelledHandler;
interstitialAd.onCompleted = completedHandler;

インタースティシャルビデオ広告を表示する場合: 広告が必要になるまでに約 30 ~ 60 秒後に、RequestAd メソッドを使用して広告をプリフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類には必ず InterstitialAdType.video を指定してください。
```
if (interstitialAd) {
    interstitialAd.requestAd(MicrosoftNSJS.Advertising.InterstitialAdType.video, applicationId, adUnitId);
}
```
バナー広告を表示する場合: 広告が必要になるまでに約 5 ~ 8 秒後に、RequestAd メソッドを使用して広告を事前にフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類には必ず InterstitialAdType.display を指定してください。
```
if (interstitialAd) {
    interstitialAd.requestAd(MicrosoftNSJS.Advertising.InterstitialAdType.display, applicationId, adUnitId);
}
```
広告を表示するコード内のポイントで、 InterstitialAd を表示する準備ができていることを確認し、 Show メソッドを使用して表示します。
```
if (interstitialAd && interstitialAd.state === MicrosoftNSJS.Advertising.InterstitialAdState.ready) {
    interstitialAd.show();
}
```

InterstitialAd オブジェクトのイベントハンドラーを定義します。

function adReadyHandler(sender) {
  // Your code goes here.
}

function errorOccurredHandler(sender, args) {
  // Your code goes here.
}

function completedHandler(sender) {
  // Your code goes here.
}

function cancelledHandler(sender) {
  // Your code goes here.
}

アプリをビルドしてテストし、テスト広告が表示されていることを確認します。

C++ (DirectX 相互運用)

このサンプルでは、Visual Studio で C++ DirectX および XAML アプリ (ユニバーサル Windows) プロジェクトを作成し、特定の CPU アーキテクチャを対象としていることを前提としています。

Visual Studio でプロジェクトを開きます。
プロジェクトで Microsoft Advertising SDK への参照を追加します。
1. [ソリューションエクスプローラー] ウィンドウで、[参照設定] を右クリックし、[参照の追加] を選択します。
2. Reference Managerで、Universal Windowsを展開し、Extensionsをクリックし、XAML 用 Microsoft Advertising SDK (バージョン 10.0) の横にあるチェックボックス選択します。
3. [参照マネージャー] で、[OK] をクリックします。

アプリの適切なヘッダーファイル (DirectXPage.xaml.h など) で、 InterstitialAd オブジェクトと関連するイベントハンドラーメソッドを宣言します。

Microsoft::Advertising::WinRT::UI::InterstitialAd^ m_interstitialAd;
void OnAdReady(Object^ sender, Object^ args);
void OnAdCompleted(Object^ sender, Object^ args);
void OnAdCancelled(Object^ sender, Object^ args);
void OnAdError(Object^ sender, Microsoft::Advertising::WinRT::UI::AdErrorEventArgs^ args);

同じヘッダーファイルで、スポット広告のアプリケーション ID と広告ユニット ID を表す複数の文字列フィールドを宣言します。次のコード例では、スポット広告の myAppId フィールドと myAdUnitId フィールドをテスト値に割り当てます。

Note

すべての InterstitialAd には対応する adユニットがあり コントロールに広告を配信するために使用され、すべての広告ユニットは adユニットID と アプリケーションIDで構成されています。これらの手順では、テスト広告ユニット ID とアプリケーション ID の値をコントロールに割り当てます。これらのテスト値は、テストバージョンのアプリでのみ使用できます。ストアにアプリを公開する前に、これらのテスト値をパートナーセンターから取得した実際の値に置き換える必要があります。
```
Platform::String^ myAppId = L"d25517cb-12d4-4699-8bdc-52040c712cab";
Platform::String^ myAdUnitId = L"test";
```
スポット広告を表示するコードを追加する.cpp ファイルに、次の名前空間参照を追加します。次の例では、アプリ内のDirectXPage.xaml.cpp ファイルにコードを追加することを前提としています。
```
using namespace Microsoft::Advertising::WinRT::UI;
```

起動時に実行されるコード (ページのコンストラクターなど) で、 InterstitialAd オブジェクトをインスタンス化し、オブジェクトのイベントのイベントハンドラーを接続します。次の例では、 InterstitialAdSamplesCpp はプロジェクトの名前空間です。コードに必要に応じてこの名前を変更します。

m_interstitialAd = ref new InterstitialAd();         
m_interstitialAd->AdReady += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdReady);
m_interstitialAd->Completed += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdCompleted);
m_interstitialAd->Cancelled += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdCancelled);
m_interstitialAd->ErrorOccurred += ref new
    Windows::Foundation::EventHandler<Microsoft::Advertising::WinRT::UI::AdErrorEventArgs ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdError);

インタースティシャルビデオ広告を表示する場合: スポット広告が必要になるまでに約 30 ~ 60 秒後に、RequestAd メソッドを使用して広告をプリフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類 AdType::Video を指定してください。
```
m_interstitialAd->RequestAd(AdType::Video, myAppId, myAdUnitId);
```
バナー広告を表示する場合: 広告が必要になるまでに約 5 ~ 8 秒後に、RequestAd メソッドを使用して広告を事前にフェッチします。これにより、広告を表示する前に広告を要求して準備するのに十分な時間が必要になります。広告の種類に AdType::D isplay を指定してください。
```
m_interstitialAd->RequestAd(AdType::Display, myAppId, myAdUnitId);
```
広告を表示するコード内のポイントで、 InterstitialAd を表示する準備ができていることを確認し、 Show メソッドを使用して表示します。
```
if ((InterstitialAdState::Ready == m_interstitialAd->State))
{
    m_interstitialAd->Show();
}
```

InterstitialAd オブジェクトのイベントハンドラーを定義します。

void DirectXPage::OnAdReady(Object^ sender, Object^ args)
{
    // Your code goes here.
}


void DirectXPage::OnAdCompleted(Object^ sender, Object^ args)
{
    // Your code goes here.
}

void DirectXPage::OnAdCancelled(Object^ sender, Object^ args)
{
    // Your code goes here.
}

void DirectXPage::OnAdError(Object^ sender, Microsoft::Advertising::WinRT::UI::AdErrorEventArgs^ args)
{
    // Your code goes here.
}

アプリをビルドしてテストし、テスト広告が表示されていることを確認します。

ライブ広告でアプリをリリースする

アプリでスポット広告を使用するには、スポット広告のガイドに従ってください。
パートナーセンターで [アプリ内広告] に進み、広告ユニットを作成します。広告ユニットの種類として、表示 スポット広告の種類に応じて ビデオスポットまたは スポット広告を選択を選択します。広告ユニット ID とアプリケーション ID の両方をメモしておきます。

Note

テスト広告ユニットとライブ UWP 広告ユニットでは、アプリケーション ID の値の形式が異なります。テストアプリケーション ID の値は GUID です。パートナーセンターでライブ UWP 広告ユニットを作成する場合、広告ユニットのアプリケーション ID の値は、アプリのストア ID と常に一致します (9NBLGGH4R315 はストア ID の例です)。
必要に応じて、In-app ads ページの Mediation 設定セクションの設定を構成することで、InterstitialAd の広告仲介を有効にすることができます。広告仲介を使用すると、複数の広告ネットワークからの広告を表示することで、広告の収益とアプリのプロモーション機能を最大化できます。これには、タブーラや Smaato などの他の有料広告ネットワークからの広告や、Microsoft アプリプロモーションキャンペーン用の広告が含まれます。
コードで、広告ユニットのテスト値を、パートナーセンターで生成した実際の値に置き換えます。
パートナーセンターを使用してストアにアプリを申請します。
パートナーセンターで広告パフォーマンスレポートを確認します。

アプリで複数のスポット広告コントロールの広告ユニットを管理する

1 つのアプリで複数の InterstitialAd コントロールを使用できます。このシナリオでは、各コントロールに異なる広告ユニットを割り当てることをお勧めします。各コントロールに異なる広告ユニットを使用することで、別々に仲介の設定を構成して、個別の報告データを取得することが可能です。また、これにより、Microsoft のサービスはアプリに提供する広告を最適化できます。

重要

各広告ユニットは 1 つのアプリのみで使用できます。同じ広告ユニットを複数のアプリで使うと、その広告ユニットには広告が配信されません。

次の方法で共有

スポット広告

スポット広告とは

前提条件

スポット広告をアプリに統合する

XAML/.NET

HTML/JavaScript

C++ (DirectX 相互運用)

ライブ広告でアプリをリリースする

アプリで複数のスポット広告コントロールの広告ユニットを管理する

フィードバック

その他のリソース

次の方法で共有

スポット広告

スポット広告とは

前提条件

スポット広告をアプリに統合する

XAML/.NET

HTML/JavaScript

C++ (DirectX 相互運用)

ライブ広告でアプリをリリースする

アプリで複数のスポット広告コントロールの広告ユニットを管理する

関連トピック

フィードバック

その他のリソース