Microsoft Advertising SDK のインストールInstall the Microsoft Advertising SDK

Windows 10 用の UWP アプリで広告を表示するには、Microsoft Advertising SDK をインストールします。To display ads in your UWP apps for Windows 10, install the Microsoft Advertising SDK. この SDK は、Visual Studio 2015 およびそれ以降のバージョンの拡張機能です。This SDK is an extension to Visual Studio 2015 and later versions.

注意

JavaScript と HTML の UWP アプリを開発しているともにインストールする必要があります、後ですることも Windows 10 SDK バージョン 10.0.14393 (Anniversary Update) がインストールされている場合、 WinJSライブラリ。If you are developing a JavaScript/HTML UWP app and you have installed Windows 10 SDK version 10.0.14393 (Anniversary Update) or later, you must also install the WinJS library. このライブラリは以前のバージョンの Windows 10 SDK に含まれていましたが、Windows 10 SDK バージョン 10.0.14393 (Anniversary Update) 以降ではこのライブラリを別個にインストールする必要があります。This library used to be included in previous versions of the Windows 10 SDK, but starting with the Windows 10 SDK version 10.0.14393 (Anniversary Update) this library must be installed separately.

MSI によるインストールInstall via MSI

MSI インストーラーを使って Microsoft Advertising SDK をインストールするにはTo install the Microsoft Advertising SDK via the MSI installer:

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

  2. Microsoft Advertising SDK、Universal Ad Client SDK、Ad Mediator 拡張、または Microsoft Store Engagement and Monetization SDK の以前のバージョンを以前にインストールしていた場合は、これらの SDK のバージョンをアンインストールします。If you previously installed any previous version of the Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension, or Microsoft Store Engagement and Monetization SDK, uninstall these SDK versions now. 必要に応じて、コマンド プロンプト ウィンドウを開き、次のコマンドを実行して、Visual Studio と共にインストールされている可能性があり、コンピューター上のインストールされているプログラムの一覧には表示されない可能性がある、古い広告 SDK のバージョンをすべて削除します。Optionally, open a Command Prompt window and run these commands to clean out any older advertising SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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 をダウンロードしてインストールします。Download and install the Microsoft Advertising SDK. インストールには数分かかることがあります。It may take a few minutes to install. 確実に処理が完了するまでお待ちください。Be sure and wait until the process has finished.

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

  5. 以前のバージョンの Microsoft Advertising SDK、Universal Ad Client SDK、Microsoft Store Engagement and Monetization SDK の Advertising ライブラリを参照する既存のプロジェクトがある場合には、Visual Studio でプロジェクトを開き、プロジェクトをクリーンしてリビルドすることをお勧めします (ソリューション エクスプ ローラーでプロジェクト ノードを右クリックして、[クリーン] を選択し、次にもう一度プロジェクト ノードを右クリックして、[リビルド] を選択します)。If you have an existing project that references advertising libraries from any earlier version of the Microsoft Advertising SDK, Universal Ad Client SDK, or Microsoft Store Engagement and Monetization SDK, we recommend that you open your project in Visual Studio and clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

または、プロジェクトで初めて Microsoft Advertising SDK を使う場合には、Microsoft Advertising SDK への参照を追加することができます。Otherwise, if you are using the Microsoft Advertising SDK for the first time in your project, you are now ready to add a reference to the Microsoft Advertising SDK.

NuGet によるインストールInstall via NuGet

NuGet を使って特定の UWP プロジェクトに Microsoft Advertising SDK をインストールするには:To install the Microsoft Advertising SDK in a specific UWP project via NuGet:

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

  2. Microsoft Advertising SDK、Universal Ad Client SDK、Ad Mediator 拡張、または Microsoft Store Engagement and Monetization SDK の以前のバージョンを以前にインストールしていた場合は、これらの SDK のバージョンをアンインストールします。If you previously installed any previous version of the Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension, or Microsoft Store Engagement and Monetization SDK, uninstall these SDK versions now. 必要に応じて、コマンド プロンプト ウィンドウを開き、次のコマンドを実行して、Visual Studio と共にインストールされている可能性があり、コンピューター上のインストールされているプログラムの一覧には表示されない可能性がある、古い広告 SDK のバージョンをすべて削除します。Optionally, open a Command Prompt window and run these commands to clean out any older advertising SDK versions that may have been installed with Visual Studio, but which may not appear in the list of installed programs on your computer:

    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 を使用するプロジェクトを開きます。Start Visual Studio and open the project in which you want to use the Microsoft Advertising SDK.

    注意

    プロジェクトに SDK の以前の MSI インストールからのライブラリの参照が既に含まれている場合は、これらの参照をプロジェクトから削除します。If your project already includes library references from an earlier MSI installation of the SDK, remove these references from your project. これらの参照は、参照先のライブラリが前の手順で削除されたため、その隣に警告アイコンが表示されます。These references will have warning icons next to them because the libraries they reference were removed in the previous steps.

  4. Visual Studio で、[プロジェクト][NuGet パッケージの管理] をクリックします。In Visual Studio, click Project and Manage NuGet Packages.

  5. 検索ボックスに、「Microsoft.Advertising.XAML」(XAML プロジェクト用) または「Microsoft.Advertising.JS」(JavaScript/HTML プロジェクト用) と入力し、対応するパッケージをインストールします。In the search box, type Microsoft.Advertising.XAML (for a XAML project) or Microsoft.Advertising.JS (for a JavaScript/HTML project) and install the corresponding package. パッケージのインストールが完了したら、ソリューションを保存します。When the package is done installing, save your solution.

    注意

    [出力] ウィンドウに、指定されたパスが長すぎることを示すインストール パッケージ エラーが表示されたとき、場合によっては、NuGet を構成して、既定の場所よりも短いパスで示される別の場所にパッケージを展開する必要があります。If the Output window reports an Install-Package error that indicates the specified path is too long, you may need to configure NuGet to extract packages to an alternate location with a shorter path than the default location. これを行うには、repositoryPath 値をコンピューターの nuget.config ファイルに追加し、それを短いフォルダーのパスに割り当て、そこに NuGet パッケージが展開されるようにします。To do this, add the repositoryPath value to a nuget.config file on your computer and assign it to a short folder path where NuGet packages can be extracted. 詳しくは、NuGet ドキュメントのこの記事をご覧ください。For more information, see this article in the NuGet documentation. または、Visual Studio プロジェクトを短いパスを持つ別のフォルダーに移動してみることができます。Alternatively, you can try moving your Visual Studio project to an alternate folder with a shorter path.

  6. ソリューションを閉じ、再度開きます。Close your solution and then reopen it.

  7. プロジェクトが NuGet によりインストールされた以前のバージョンの Microsoft Advertising SDK のライブラリを既に参照している場合で、プロジェクトを SDK の新しいリリースに更新する場合には、プロジェクトをクリーンしてリビルドすることをお勧めします (ソリューション エクスプローラーでプロジェクト ノードを右クリックして、[クリーン] を選択し、次にもう一度プロジェクト ノードを右クリックして、[リビルド] を選択します)。If your project already references libraries from an earlier version of the Microsoft Advertising SDK that was installed via NuGet and you have updated your project to a newer release of the SDK, we recommend that you clean and rebuild your project (in Solution Explorer, right-click your project node and choose Clean, and then right-click your project node again and choose Rebuild).

または、プロジェクトで初めて Microsoft Advertising SDK を使う場合には、Microsoft Advertising SDK への参照を追加することができます。Otherwise, if you are using the SDK for the first time in your project, you are now ready to add a reference to the Microsoft Advertising SDK.

Microsoft Advertising SDK への参照を追加するAdd a reference to the Microsoft Advertising SDK

Microsoft Advertising SDK をインストールした後、次の手順に従ってプロジェクト内の SDK を参照すると、アドバタイズ API を使用できます。After you install the Microsoft Advertising SDK, follow these instructions to reference the SDK in your project so you can use the advertising APIs.

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

    注意

    プロジェクトのターゲットが [Any CPU] (任意の CPU) になっている場合は、アーキテクチャ固有のビルド出力 (たとえば、[x86]) を使うようにプロジェクトを更新します。If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). プロジェクトのターゲットが [Any CPU] (任意の CPU) になっていると、次の手順で Microsoft Advertising SDK への参照を正常に追加できません。If your project targets Any CPU, you will not be able to successfully add a reference to the Microsoft Advertising SDK in the following steps. 詳しくは、「プロジェクトのターゲットを "Any CPU" に設定すると参照エラーが発生する」をご覧ください。For more information, see Reference errors caused by targeting Any CPU in your project.

  2. ソリューション エクスプローラーで、[参照設定] を右クリックし、[参照の追加] を選択します。In Solution Explorer, right click References and select Add Reference…

  3. [参照マネージャー][ユニバーサル Windows] を展開して [拡張機能] をクリックし、[Microsoft Advertising XAML for XAML] (XAML アプリの場合) または [Microsoft Advertising SDK for JavaScript] (JavaScript と HTML を使って構築されたアプリの場合) の横にあるチェック ボックスをオンにします。In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Advertising SDK for XAML (for XAML apps) or Microsoft Advertising SDK for JavaScript (for apps built using JavaScript and HTML).

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

アドバタイズ API を使い始める方法を示すチュートリアルでは、次の記事をご覧ください。For walkthroughs that show how to get started using the advertising APIs, see the following articles:

Microsoft Advertising SDK のフレームワーク パッケージについてUnderstanding framework packages in the Microsoft Advertising SDK

(UWP アプリ用) Microsoft Advertising SDK の Microsoft.Advertising.dll ライブラリは、フレームワーク パッケージとして構成されています。The Microsoft.Advertising.dll library in the Microsoft Advertising SDK (for UWP apps) is configured as a framework package. このライブラリには、Microsoft.Advertising のアドバタイズ API と Microsoft.Advertising.WinRT.UI 名前空間が含まれます。This library contains the advertising APIs in the Microsoft.Advertising and Microsoft.Advertising.WinRT.UI namespaces.

このライブラリはフレームワーク パッケージであるため、このライブラリを使用するバージョンのアプリをユーザーがインストールすると、このライブラリは、修正されてパフォーマンスが向上した新しいバージョンのライブラリが公開されるたびに、ユーザーのデバイスで Windows Update によって自動的に更新されます。Because this library is a framework package, this means that after a user installs a version of your app that uses this library, this library is automatically updated on their device through Windows Update whenever we publish a new version of the library with fixes and performance improvements. これにより、利用できる最新バージョンのライブラリがユーザーのデバイスに確実にインストールされます。This helps to ensure that your customers always have the latest available version of the library installed on their devices.

このライブラリに新しい API や機能が導入された新しいバージョンの SDK がリリースされた場合は、これらの機能を使用するために最新バージョンの SDK をインストールする必要があります。If we release a new version of the SDK that introduces new APIs or features in this library, you will need to install the latest version of the SDK to use those features. このシナリオでは、更新されたアプリをストアに公開する必要もあります。In this scenario, you would also need to publish your updated app to the Store.