Microsoft Advertising SDK のインストール

警告

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

Windows 10 および Windows 11 用の UWP アプリに広告を表示するには、 Microsoft Advertising SDKをインストールします。 この SDK は、Visual Studio 2015 以降のバージョンの拡張機能です。

Note

JavaScript/HTML UWP アプリを開発していて、Windows 10 SDK バージョン 10.0.14393 (Anniversary Update) 以降をインストールしている場合、WinJS ライブラリもインストールする必要があります。 このライブラリは以前のバージョンの Windows 10 SDK に含まれていましたが、Windows 10 SDK バージョン 10.0.14393 (Anniversary Update) 以降では、このライブラリを個別にインストールする必要があります。

MSI 経由でインストールする

MSI インストーラーを使用して Microsoft Advertising SDK をインストールするには:

1. Visual Studio すべてのインスタンスを閉じます。

2. 以前のバージョンの Microsoft Advertising SDK、Universal Ad Client SDK、Ad Mediator 拡張機能、または Microsoft Store Engagement and Monetization SDK を以前にインストールした場合は、ここでこれらの SDK バージョンをアンインストールします。 必要に応じて、 コマンド プロンプト ウィンドウを開き、次のコマンドを実行して、Visual Studio にインストールされている可能性がありますが、コンピューターにインストールされているプログラムの一覧には表示されない古い Advertising SDK バージョンをクリーンアップします。

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. Microsoft Advertising SDK をダウンロードしてインストールします。 インストールには数分かかる場合があります。 プロセスが完了するまで、必ず待ってください。

4. Visual Studio を再起動します。

5. 以前のバージョンの Microsoft Advertising SDK、Universal Ad Client SDK、または Microsoft Store Engagement and Monetization SDK の広告ライブラリを参照する既存のプロジェクトがある場合は、Visual Studio でプロジェクトを開き、プロジェクトをクリーンアップしてリビルドすることをお勧めします (ソリューション エクスプローラーで、プロジェクト ノードを右クリックして Clean を選択してから、もう一度プロジェクト ノードを右クリックしてリビルド)。

それ以外の場合、プロジェクトで初めて Microsoft Advertising SDK を使用する場合は、Microsoft Advertising SDK への参照を 追加する準備ができました。

NuGet によるインストール

NuGet を使用して特定の UWP プロジェクトに Microsoft Advertising SDK をインストールするには:

1. Visual Studio すべてのインスタンスを閉じます。

2. 以前のバージョンの Microsoft Advertising SDK、Universal Ad Client SDK、Ad Mediator 拡張機能、または Microsoft Store Engagement and Monetization SDK を以前にインストールした場合は、ここでこれらの SDK バージョンをアンインストールします。 必要に応じて、 コマンド プロンプト ウィンドウを開き、次のコマンドを実行して、Visual Studio にインストールされている可能性がありますが、コンピューターにインストールされているプログラムの一覧には表示されない古い Advertising SDK バージョンをクリーンアップします。

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. Visual Studio を起動し、Microsoft Advertising SDK を使用するプロジェクトを開きます。

   Note

   プロジェクトに SDK の以前の MSI インストールからのライブラリ参照が既に含まれている場合は、プロジェクトからこれらの参照を削除します。 これらの参照は、前の手順で参照するライブラリが削除されたため、その横に警告アイコンが表示されます。

4. Visual Studio で、[プロジェクト] と [NuGet パッケージの管理] をクリックします。

5. 検索ボックスに「 Microsoft.Advertising.XAML (XAML プロジェクトの場合)、または Microsoft.Advertising.JS (JavaScript/HTML プロジェクトの場合) と入力し、対応するパッケージをインストールします。 パッケージのインストールが完了したら、ソリューションを保存します。

   Note

   Output ウィンドウで、指定したパスが長すぎることを示す Install-Package エラーが報告される場合は、既定の場所よりもパスが短い別の場所にパッケージを抽出するように NuGet を構成する必要があります。 これを行うには、 repositoryPath 値をコンピューター上の nuget.config ファイルに追加し、NuGet パッケージを抽出できる短いフォルダー パスに割り当てます。 詳細については、NuGet ドキュメント この記事 を参照してください。 または、パスが短い別のフォルダーに Visual Studio プロジェクトを移動することもできます。

6. ソリューションを閉じてから、もう一度開きます。

7. プロジェクトが既に NuGet 経由でインストールされた以前のバージョンの Microsoft Advertising SDK のライブラリを参照していて、プロジェクトを SDK の新しいリリースに更新している場合は、プロジェクトをクリーンアップしてリビルドすることをお勧めします (ソリューション エクスプローラーでプロジェクト ノードを右クリックし、Clean を選択してから、プロジェクト ノードをもう一度右クリックして Rebuild を選択します)。

それ以外の場合、プロジェクトで初めて SDK を使用する場合は、Microsoft Advertising SDK への参照 追加する準備ができました。

Microsoft Advertising SDK への参照を追加する

Microsoft Advertising SDK をインストールしたら、次の手順に従ってプロジェクト内の SDK を参照し、広告 API を使用できるようにします。

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

   Note

   プロジェクトのターゲットが [Any CPU] (任意の CPU) になっている場合は、アーキテクチャ固有のビルド出力 (たとえば、[x86]) を使うようにプロジェクトを更新します。 プロジェクトのターゲットが Any CPU の場合、次の手順で Microsoft Advertising SDK への参照を正常に追加することはできません。 詳しくは、「プロジェクトのターゲットを "Any CPU" に設定すると参照エラーが発生する」をご覧ください。

2. ソリューション エクスプローラーで、Referencesを右クリックし、[参照の追加]選択します。

3. Reference Managerで、Universal Windows を展開し、Extensions をクリックし、次に [XAML 用 Microsoft Advertising SDK (XAML アプリの場合) または Microsoft Advertising SDK for JavaScript (JavaScript と HTML を使用してビルドされたアプリの場合) の横にあるチェック ボックスをオンにします。

4. [参照マネージャー] で、[OK] をクリックします。

Advertising API の使用を開始する方法を示すチュートリアルについては、次の記事を参照してください。

• スポット広告
• ネイティブ広告
• XAML および .NET の AdControl
• HTML 5 および JavaScript の AdControl

Microsoft Advertising SDK のフレームワーク パッケージについて

Microsoft Advertising SDK (UWP アプリ用) のMicrosoft.Advertising.dll ライブラリは、フレーム パッケージとして構成。 このライブラリには、 Microsoft.Advertising および Microsoft.Advertising.WinRT.UI 名前空間のアドバタイズ API が含まれています。

このライブラリはフレームワーク パッケージであるため、これは、ユーザーがこのライブラリを使用するアプリのバージョンをインストールした後、修正プログラムとパフォーマンスの向上を備えた新しいバージョンのライブラリを公開するたびに、このライブラリが Windows Update を介してデバイスに自動的に更新されることを意味します。 これにより、お客様は常に最新バージョンのライブラリがデバイスにインストールされます。

このライブラリに新しい API または機能を導入する新しいバージョンの SDK をリリースする場合は、これらの機能を使用するために最新バージョンの SDK をインストールする必要があります。 このシナリオでは、更新されたアプリをストアに発行する必要もあります。