Поделиться через

Установите Microsoft Advertising SDK

Предупреждение

С 1 июня 2020 года платформа монетизации рекламы Microsoft для приложения Windows UWP будет закрыта. Подробнее

Чтобы отобразить рекламу в приложениях UWP для Windows 10 и Windows 11, установите Microsoft Advertising SDK. Этот пакет SDK является расширением для Visual Studio 2015 и более поздних версий.

Замечание

Если вы разрабатываете приложение JavaScript/HTML UWP и установили пакет SDK для Windows 10 версии 10.0.14393 (юбилейное обновление) или более поздней версии, необходимо также установить библиотеку WinJS . Эта библиотека использовалась для включения в предыдущие версии пакета SDK для Windows 10, но начиная с пакета SDK для Windows 10 версии 10.0.14393 (юбилейное обновление) эта библиотека должна быть установлена отдельно.

Установка с помощью MSI

Чтобы установить пакет SDK Для Microsoft Advertising с помощью установщика MSI, выполните указанные ниже действия.

  1. Закройте все экземпляры Visual Studio.

  2. Если вы ранее установили любую предыдущую версию Microsoft Advertising SDK, Universal Ad Client SDK, расширение Ad Mediator или пакет SDK Microsoft Store Engagement and Monetization, удалите эти версии пакетов SDK. При необходимости откройте окно командной строки и выполните эти команды, чтобы очистить все старые версии пакета SDK для рекламы, которые могли быть установлены с помощью Visual Studio, но которые могут не отображаться в списке установленных программ на компьютере:

    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. Если у вас есть существующий проект, который ссылается на рекламные библиотеки из любой более ранней версии пакета SDK Microsoft Advertising, универсального клиентского SDK рекламы или SDK вовлеченности и монетизации Microsoft Store, рекомендуется открыть проект в Visual Studio и очистить и перестроить проект (в обозревателе решений, щелкните правой кнопкой мыши узел проекта и выберите Очистить, затем снова щелкните узел проекта правой кнопкой мыши и выберите Перестроить).

В противном случае, если вы впервые используете пакет SDK Microsoft Advertising в проекте, теперь вы готовы добавить ссылку на пакет SDK.

Установка с помощью NuGet

Чтобы установить пакет SDK Microsoft Advertising в определенном проекте UWP с помощью NuGet:

  1. Закройте все экземпляры Visual Studio.

  2. Если вы ранее установили любую предыдущую версию Microsoft Advertising SDK, Universal Ad Client SDK, расширение Ad Mediator или пакет SDK Microsoft Store Engagement and Monetization, удалите эти версии пакетов SDK. При необходимости откройте окно командной строки и выполните эти команды, чтобы очистить все старые версии пакета SDK для рекламы, которые могли быть установлены с помощью Visual Studio, но которые могут не отображаться в списке установленных программ на компьютере:

    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 и откройте проект, в котором вы хотите использовать пакет SDK Microsoft Advertising.

    Замечание

    Если проект уже содержит ссылки на библиотеки из более ранней установки MSI пакета SDK, удалите эти ссылки из проекта. Эти ссылки будут иметь значки предупреждения рядом с ними, так как библиотеки, на которые они ссылаются, были удалены на предыдущих шагах.

  4. В Visual Studio щелкните Project и Управление пакетами NuGet.

  5. В поле поиска введите Microsoft.Advertising.XAML (для проекта XAML) или Microsoft.Advertising.JS (для проекта JavaScript/HTML) и установите соответствующий пакет. После установки пакета сохраните решение.

    Замечание

    Если окно вывода сообщает об ошибке Install-Package, указывающей, что указанный путь слишком длинный, может понадобиться настроить NuGet таким образом, чтобы извлечь пакеты в альтернативное расположение с более коротким путем, чем в расположении по умолчанию. Для этого добавьте repositoryPath значение в файл nuget.config на компьютере и назначьте его короткому пути к папке, в которой можно извлечь пакеты NuGet. Дополнительные сведения см. в этой статье документации NuGet. Кроме того, можно попробовать переместить проект Visual Studio в альтернативную папку с более коротким путем.

  6. Закройте решение и откройте его снова.

  7. Если проект уже ссылается на библиотеки из более ранней версии пакета SDK Microsoft Advertising, установленного с помощью NuGet, и вы обновили проект до более нового выпуска пакета SDK, рекомендуем очистить и перестроить проект (в обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите "Очистить", а затем снова щелкните узел проекта правой кнопкой мыши и выберите "Перестроить").

В противном случае, если вы используете пакет SDK впервые в проекте, теперь вы готовы добавить ссылку на пакет SDK Microsoft Advertising.

Добавьте ссылку на Microsoft Advertising SDK

После установки пакета SDK Microsoft Advertising следуйте этим инструкциям, чтобы ссылаться на пакет SDK в проекте, чтобы использовать API рекламы.

  1. Откройте проект в Visual Studio.

    Замечание

    Если ваш проект нацелен на Any CPU, обновите его, чтобы использовать результаты сборки, соответствующие определённой архитектуре (например, x86). Если ваш проект нацелен на Any CPU, вы не сможете успешно добавить ссылку на Microsoft Advertising SDK на следующих шагах. Дополнительные сведения см. в разделе Ошибки справочника, вызванные целевым использованием параметра Any CPU в вашем проекте.

  2. В Обозревателе решений щелкните правой кнопкой мыши Ссылки и выберите Добавить ссылку...

  3. В Диспетчер ссылокразверните Universal Windows, щелкните Extensions, а затем установите флажок рядом с Microsoft Advertising SDK для XAML (для приложений XAML) или Microsoft Advertising SDK для JavaScript (для приложений, созданных с помощью JavaScript и HTML).

  4. В диспетчере ссылокнажмите кнопку "ОК".

Пошаговые руководства, показывающие, как приступить к работе с API рекламы, см. в следующих статьях:

Основные сведения о пакетах фреймворка в SDK для Microsoft Advertising

Библиотека Microsoft.Advertising.dll в Microsoft Advertising SDK (для приложений UWP) настраивается как пакет фреймворка. Эта библиотека содержит API-интерфейсы рекламы в пространствах имен Microsoft.Advertising и Microsoft.Advertising.WinRT.UI.

Так как эта библиотека является пакетом платформы, это означает, что после установки пользователем версии приложения, использующего эту библиотеку, эта библиотека автоматически обновляется на своем устройстве с помощью Центра обновления Windows при публикации новой версии библиотеки с исправлениями и улучшениями производительности. Это помогает гарантировать, что клиенты всегда имеют последнюю доступную версию библиотеки, установленной на своих устройствах.

Если мы выпускаем новую версию пакета SDK, включающую новые API или компоненты этой библиотеки, необходимо установить последнюю версию пакета SDK для использования этих функций. В этом сценарии также потребуется опубликовать обновленное приложение в Магазине.