Microsoft Advertising 沙盒

Microsoft Advertising 提供了一个 API 沙盒环境,可在其中测试应用程序,然后再将其部署到生产环境。 在沙盒中创建的广告不会提供。 沙盒中支持的服务因生产环境而异。 若要获取受支持服务的 Web 服务地址,请参阅 必应广告 API Web 服务地址

注意

沙盒可能会因维护而关闭,无论是否事先通知。

初始客户注册

沙盒和生产环境使用单独的凭据。

按照以下步骤获取新的沙盒客户。 如果你已有沙盒客户并且想要添加新用户(例如,使用 Microsoft 帐户凭据),则可以跳到 用户邀请 步骤。

  1. 打开浏览器,导航到 https://sandbox.bingads.microsoft.com?simpsp=true

  2. 单击“注册 Microsoft 广告”或“立即注册

  3. 选择“ 创建新电子邮件地址 ”以创建 MSA。 请勿使用现有电子邮件地址。

  4. 单击下一个

  5. 输入 MSA 电子邮件地址。 电子邮件服务器必须是 outlook-int.com (例如 someone@outlook-int.com ,) 。

    重要

    沙盒仅支持使用 outlook-int.com 电子邮件帐户创建的 MSA。 不得使用 outlook.com 电子邮件帐户。 此外,你不得使用来自其他电子邮件服务 (的电子邮件帐户,例如, @contoso.com) 即使该帐户已链接到 outlook.com 或 outlook-int.com 电子邮件帐户。

  6. 通过指定其余的用户和安全信息来完成 MSA 工作流。 然后,你将被重定向到 Microsoft Advertising,以继续沙盒客户和帐户注册。

  7. 填写 “创建帐户” 表单

  8. 对于“导入/创建市场活动”,请单击“跳过市场活动创建

  9. 对于“上线”,请单击“跳过付款信息

邀请更多用户

若要在沙盒中使用 OAuth 进行身份验证 ,需要一个沙盒 Microsoft 帐户 (MSA) 。 如果沙盒客户尚未通过 Microsoft 帐户获得用户凭据,则需要通过以下步骤邀请用户使用 沙盒 帐户。

  1. 在 Microsoft Advertising 沙盒中,单击右上角 (用户名)

  2. 单击“帐户 & 计费

  3. 单击“用户

  4. 单击“邀请用户

  5. 输入要邀请的用户的电子邮件地址。 电子邮件服务器必须 outlook.com (,例如, someone@outlook.com) 。

    重要

    只能向 outlook.com 电子邮件帐户发送邀请。 你不得向任何其他域发送邀请,即使该帐户已链接到 outlook.com 电子邮件帐户。 如果尝试将邀请发送到另一个域 (例如 someone@contoso.com) ,则 BingAds UI 会将邀请显示为无限期挂起, (邀请永远不会) 发送。

  6. 单击“发送

Microsoft Advertising 向用户发送电子邮件邀请。 如果邀请未显示在收件箱中,检查“垃圾邮件Email”文件夹。 接收邀请可能需要几分钟时间。 以下步骤演示如何接受邀请。

  1. 打开来自 Microsoft Advertising 的电子邮件,主题行为“Microsoft Advertising 邀请”

  2. 单击嵌入的链接

  3. 选择“ 创建新电子邮件地址 ”以创建 MSA。 请勿使用现有电子邮件地址。

  4. 单击下一个

  5. 输入 MSA 电子邮件地址。 电子邮件服务器必须是 outlook-int.com (例如 someone@outlook-int.com ,) 。

    重要

    沙盒仅支持使用 outlook-int.com 电子邮件帐户创建的 MSA。 不得使用 outlook.com 电子邮件帐户。 此外,你不得使用来自其他电子邮件服务 (的电子邮件帐户,例如, @contoso.com) 即使该帐户已链接到 outlook.com 或 outlook-int.com 电子邮件帐户。

  6. 通过指定剩余的用户信息来完成工作流

  7. 完成 MSA 过程后退出 Microsoft Advertising。

注意

MSA 注册过程会将你返回到 SI Microsoft Advertising 用户界面 (ui.si.bingads.microsoft.com) 。 完成 MSA 过程后,注销 SI 接口,然后使用新的 outlook-int.com 电子邮件地址 https://secure.sandbox.bingads.microsoft.com/登录。

获取 API 访问权限

沙盒和生产环境使用单独的凭据。

对于沙盒环境,请将 替换为 https://login.microsoftonline.com/commonhttps://login.windows-ppe.net/consumers

此表包含其他沙盒终结点。

说明 生产 沙盒
OAuth 请求的终结点 login.microsoftonline.com login.windows-ppe.net
获取 Microsoft 帐户时使用的电子邮件的域 任何电子邮件地址 outlook-int.com
用于更改 Microsoft 帐户密码的终结点 account.live.com/password/change account.live-int.com/password/change

尽管在生产环境中必须使用自己的开发人员令牌,但所有 Microsoft Advertising 客户都可以在沙盒中使用以下通用开发人员令牌。

BBD37VB98

尽管在生产环境中必须使用自己的应用程序 ID (客户端 ID) ,但所有 Microsoft Advertising 客户都可以在沙盒中使用以下公共应用程序 ID。 “教程示例应用”客户端 ID 仅限于桌面或控制台应用程序,不能与 Web 应用程序中的任何客户端密码一起使用。

4c0b021c-00c3-4508-838f-d3127e8167ff

现在,你可以获取 Microsoft Advertising 用户的访问权限和刷新令牌,并使用必应广告 API 进行首次服务调用,请参阅 快速入门 指南。

提示

有关如何使用必应广告 SDK 获取访问和刷新令牌的详细信息,请参阅 使用 SDK 进行身份验证

沙盒最佳做法

不应在与生产相同的容量中使用沙盒。

  • 确保在将应用程序部署到生产环境时,使用生产 WSDL 和生产凭据。
  • 沙盒包含当前生产版本,并将在事先通知或不事先通知的情况下使用功能预览进行更新。
  • 沙盒的容量小于生产容量,不应使用它来执行压力或容量测试。
  • 请不要使用多个线程。

Ad Insight Service

沙盒支持一组有限的关键字来测试 Ad Insight 服务操作。 不应使用测试数据来推断或期望对生产中的关键字进行类似的估计。 下表介绍了一些限制。

提示

在生产环境中使用 Ad Insight 服务,而不是沙盒。 沙盒仅提供一部分生产服务操作,见解数据落后于生产。 沙盒机会数据在每个周末刷新和更新,并在星期一之前可用。 沙盒中的关键字 (keyword) 创意数据可能落后于生产几个月。 如果操作由于日期范围无效而失败,请尝试使用较早的日期范围再次提交请求。

服务操作 沙盒限制
GetBidLandscapeByKeywordIds 不支持。 可以使用现有关键字 (keyword) 标识符调用操作,但不返回任何数据。
GetEstimatedBidByKeywordIds 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。
GetEstimatedBidByKeywords 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。
GetEstimatedPositionByKeywordIds 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

为了增加获得估算值的机会, MaxBid 元素应大于或等于 5 美元,或等值的其他货币。
GetEstimatedPositionByKeywords 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

为了增加获得估算值的机会, MaxBid 元素应大于或等于 5 美元,或等值的其他货币。
GetHistoricalKeywordPerformance 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

MatchTypeAdPosition 元素必须设置为 Aggregate

Devices 元素必须设置为“计算机”或保留为 nil。
GetHistoricalSearchCount 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

EndMonthAndYear 元素必须设置为上个月。 例如,如果今天的日期是 2020 年 4 月 1 日,则结束月份应为 2020 年 3 月。

Devices 元素必须设置为“计算机”或保留为 nil。
GetKeywordCategories 沙盒与生产中应该没有区别。
GetKeywordDemographics 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

Devices 元素必须设置为“计算机”或保留为 nil。
GetKeywordIdeas 沙盒测试数据每 3 个月刷新一次,因此需要设置较早的日期记录范围。
GetKeywordLocations 支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

Devices 元素必须设置为“计算机”或保留为 nil。
SuggestKeywordsForUrl 沙盒与生产中应该没有区别。
SuggestKeywordsFromExistingKeywords 如果 SuggestionType 设置为 1,则与生产环境相比,行为上应该没有差异。

对于建议类型值 2、3 和 4,支持一组有限的关键字:航空、汽车、最佳交易、预订、汽车信息、护理、当天交易、折扣、娱乐、财务、游戏、酒店评论、保险比较、体育、酒店。

批量服务

生产环境中上传的文件大小限制为 100MB 或 250 万行。 对于沙盒,限制为 20,000 行。 有关详细信息,请参阅 批量下载和上传

市场活动管理服务

编辑支持

沙盒支持有限的编辑评审和上诉。 在沙盒中无法像在生产环境中那样获得编辑问题的原因,例如通过 GetEditorialReasonsByIds 服务操作。

产品广告

美国沙盒中支持产品广告。 若要获得自动批准,必须创建以“沙盒”结尾的目录和 Microsoft 商家中心商店,如下所示。

  1. 在 Microsoft Advertising Web 应用程序中,单击“ 工具”。

  2. “管理工具”下,单击“ Microsoft 商家中心”。

  3. 单击“ 创建存储”,然后输入以“沙盒”结尾的应用商店名称, (不区分大小写) 。

  4. 添加商店信息,在“目录设置”下选择“产品广告”,然后单击“完成”。

  5. 在新商店中,单击“ 目录管理”,然后单击“ 创建目录”。

  6. 添加目录名称,在“目录源文件”下选择“稍后手动上传文件”,然后单击“保存”。

客户计费服务

沙盒不支持付款方式。

Reporting Service

创建关键字 (keyword) 时,应在几个小时内生成测试性能数据。 提供的数据用于测试在沙盒中生成、检索和分析报表。 不应使用测试数据来推断或期望在生产环境中为关键字提供类似的性能。

仅在添加或更新实体的同一天生成测试数据。 例如,如果立即添加关键字 (keyword) 并下载上周的关键字 (keyword) 性能报告,则不会有任何数据。 必须拉取一个报表,其中包含报表时间段中的今天。

以下报表可以在沙盒中返回性能数据。 所有其他报表类型都可以成功提交,尽管沙盒服务不会返回任何示例数据,即轮询结果时不会设置报表下载 URL。