次の方法で共有

Microsoft Advertising SDK をインストールする

Warnung

2020 年 6 月 1 日の時点で、Windows UWP アプリ用の Microsoft Ad 収益化プラットフォームがシャットダウンされます。 詳細情報

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

注

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 にインストールされている可能性がある古い広告 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 でプロジェクトを開き、プロジェクトをクリーンアップしてリビルドすることをお勧めします (ソリューション エクスプローラーで、プロジェクト ノードを右クリックし、[クリーン] 選択します。 をクリックし、プロジェクト ノードをもう一度右クリックし、[の再構築] 選択します。

それ以外の場合、プロジェクトで初めて 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 にインストールされている可能性がある古い広告 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 を使用するプロジェクトを開きます。

    注

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

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

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

    注

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

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

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

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

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

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

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

    注

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

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

  3. Reference Managerで、[ユニバーサル Windows] 展開し、[拡張機能] をクリックし、[MICROSOFT Advertising SDK for XAML (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 をインストールする必要があります。 このシナリオでは、更新されたアプリをストアに発行する必要もあります。