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

Установка пакета SDK Microsoft Advertising

  • Статья

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

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

Чтобы отобразить рекламу в приложениях UWP для Windows 10 и Windows 11, установите пакет SDK Microsoft Advertising. Этот пакет 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. Если вы ранее установили любую предыдущую версию пакета SDK Microsoft Advertising, универсальный пакет SDK ad Client, расширение Ad Mediator или пакет SDK для Microsoft Store Engagement и Монетизации, удалите эти версии пакета 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. Скачайте и установите пакет SDK Microsoft Advertising. Установка может занять несколько минут. Убедитесь, что дождитесь завершения процесса.

  4. Перезапустите Visual Studio.

  5. Если у вас есть существующий проект, который ссылается на рекламные библиотеки из любой более ранней версии пакета SDK Microsoft Advertising, универсального клиентского пакета SDK ad или Microsoft Store Engagement и Монетизации SDK, рекомендуется открыть проект в Visual Studio и очистить и перестроить проект (в Обозреватель решений щелкните правой кнопкой мыши узел проекта и выберите "Очистить", а затем снова щелкните узел проекта правой кнопкой мыши и выберите "Перестроить").

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

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

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

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

  2. Если вы ранее установили любую предыдущую версию пакета SDK Microsoft Advertising, универсальный пакет SDK ad Client, расширение Ad Mediator или пакет SDK для Microsoft Store Engagement и Монетизации, удалите эти версии пакета 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 щелкните "Проект" и "Управление пакетами 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.

Добавление ссылки на пакет SDK Для Microsoft Advertising

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

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

    Примечание.

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

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

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

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

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

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

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

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

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