将最新的广告库用于横幅广告 - UWP applications

2025-06-10

警告

截至 2020 年 6 月 1 日，Windows UWP 应用的Microsoft广告盈利平台将关闭。了解详细信息

从 2017 年 4 月 1 日开始，我们不再向使用不受支持的广告 SDK 版本的应用提供横幅广告。如果使用 AdControl 在通用 Windows 平台（UWP）应用中显示横幅广告，请使用本文中的信息来确定你是否使用不受支持的广告 SDK 并将应用迁移到受支持的 SDK。

概述

显示横幅广告的 UWP 应用必须使用广告库中 Microsoft 广告 SDK分发的 AdControl 。此 SDK 支持一组基本广告功能，包括根据互动广告局（IAB）提供的移动富媒体广告接口定义（MRAID）1.0 规范提供 HTML5 富媒体服务的能力。我们的许多广告商都寻求这些功能，我们要求应用开发人员使用这些 SDK 版本之一来帮助我们的应用生态系统对广告商更具吸引力，并最终为你提供更多的收入。

在发布此 SDK 之前，我们以前在多个较旧的广告 SDK 版本中提供了 AdControl 类。这些较旧的广告 SDK 版本不再受支持，因为它们不支持上述最低广告功能。从 2017 年 4 月 1 日开始，我们不再向使用不受支持的广告 SDK 版本的应用提供横幅广告。如果你的应用仍然使用不受支持的广告 SDK 版本，你将看到以下行为：

横幅广告将不再投放到应用中的任何 AdControl，你将不再从这些广告控件中赚取广告收入。
当您的应用中的 AdControl 请求新广告时，控件的 ErrorOccurred 事件将会被触发，事件参数的 ErrorCode 属性将具有 NoAdAvailable的值。
将停用与应用关联的任何广告单元。无法从 DePartnerv 中心帐户中删除这些已停用的广告单元。如果你更新应用以使用 Microsoft广告 SDK，请忽略这些广告单元，并创建新的广告单元。
横幅广告将不再展示在任何用于多个应用的广告单元中。确保每一个广告单元仅在一个应用中使用。

如果你有一个现有应用（已在应用商店中或仍在开发中），它使用 AdControl 显示横幅广告，并且你不确定你的应用正在使用哪个广告 SDK，请按照本文中的说明来确定是否需要将应用更新到受支持的 SDK。如果遇到任何问题或需要帮助，请联系客服。

注释

如果你的应用已使用 Microsoft广告 SDK（适用于 UWP 应用的），则无需对应用进行任何进一步更改。

先决条件

使用 AdControl的应用程序的完整源代码和 Visual Studio 项目文件。
您的应用的 .appx 包。

注释

如果不再具有应用的.appx包，但仍具有具有 Visual Studio 版本和用于生成应用的广告 SDK 的开发计算机，则可以在 Visual Studio 中重新生成.appx包。

第 1 部分：确定是否需要更新 UWP 应用

按照以下部分中的说明确定是否需要更新应用。

为应用创建.appx包的副本，这样就不会打扰原始包，重命名副本，使其具有 .zip 扩展名，并提取文件的内容。
检查您的应用程序包的提取内容：

如果看到 Microsoft.Advertising.dll 文件，应用使用旧 SDK，并且必须按照以下部分中的说明更新项目。继续第 2 部分。
如果未看到 Microsoft.Advertising.dll 文件，UWP 应用已使用最新的可用广告 SDK，并且无需对项目进行任何更改。

第 2 部分：安装最新的 SDK

如果应用使用旧版 SDK，请按照以下说明作，确保开发计算机上具有最新的 SDK。

确保开发计算机已安装 Visual Studio 2015 或更高版本。

注释

如果 Visual Studio 在开发计算机上打开，请在执行以下步骤之前将其关闭。
从开发计算机中卸载 Microsoft Advertising SDK 和 Ad Mediator 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}
```
安装 Microsoft Advertising SDK。

第 3 部分：更新项目

从项目中删除对Microsoft广告库的所有现有引用，并按照这些说明添加所需的引用。这将确保项目使用正确的库。可以保留现有标记和代码。

第 4 部分：测试和重新发布应用

测试应用，确保应用按预期显示横幅广告。

如果应用商店中已有旧版应用，请在合作伙伴中心为更新的应用创建新的提交，以便重新发布你的应用。