借助测试账号,您可以在生产环境中实施更改之前,先试用新的 API 实现或账号配置。
生产账号会投放需要结算并向用户呈现的广告,而测试账号在 Google Ads 界面中显示为已撤销账号,因为它们没有有效的结算信息,也不会向用户呈现广告。
由于测试账号和生产账号无法以任何方式进行交互,因此您无法在现有生产经理账号下使用测试账号。如需使用测试账号,您需要一个新的账号层次结构,并以测试经理账号作为根账号。
您需要测试账号吗?
在创建单独的测试账号层次结构之前,请先验证哪种测试选项最符合您的应用场景:
- 首次进行 API 调用或针对真实账号进行测试(每天最多 2,880 次操作):您不需要测试账号,除非您要测试在 Explorer 访问权限下受限的功能(例如账号创建、用户管理、关键字规划工具或结算)。在 Google Cloud 控制台的 Google Ads API 概览页面上申请自动探索者访问权限级别,以便直接查询和管理生产账号。
- 在不更改数据的情况下验证请求语法和政策合规性:在
GoogleAdsService.Search或 mutate 请求中设置validate_only字段(针对生产账号时,至少需要探索者访问权限)。 - 使用测试访问权限项目进行开发,或在免费沙盒中测试完整的广告系列创建流程:按照本页中的步骤创建测试经理账号和测试客户账号。
为何要使用测试账号?
测试账号不会影响您正在投放的广告,也不会向您的账号收取费用。它们在积极开发期间具有以下优势:
- 可以像生产账号一样设置层级结构并进行整理。
- 可以像正式账号一样在 Google Ads 界面中查看和操作。
- 无需为 Google Cloud 项目申请正式版 API 访问权限,因此您可以在项目具有测试访问权限级别时立即开始试用该 API。(如果具有测试访问权限的 Google Cloud 项目尝试调用生产账号,则从
v25开始,API 会返回AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,在v24及更早版本中,API 会返回AuthorizationError.ACTION_NOT_PERMITTED。) - 无法投放广告,也无法以任何方式与您的生产账号互动。这样,您就可以在安全的环境中测试代码或配置更改,而不会影响广告投放账号。
- 与生产账号具有相同的限制,包括速率限制。
由于测试账号没有预算,因此在经理账号中创建测试子账号时,您可能会看到错误。您可以放心地忽略此错误。
创建测试账号和广告系列
以下说明将创建一个测试经理账号、一个测试客户账号以及一些用于填充测试客户账号的广告系列。如需这些账号类型的完整说明,请参阅账号类型。
点击创建测试经理账号,打开 Google Ads 账号选择页面。如果系统提示,请使用未与您的生产 Google Ads 经理账号关联的 Google 账号登录,或在登录提示中创建一个 Google 账号。
在账号选择页面上,点击新建 Google Ads 账号(如果出现完成账号设置?对话框,请点击创建新账号)。账号选择页面不会显示测试指示器,但从创建测试经理账号打开该页面会配置注册流程,以创建测试经理账号。
在确认您的商家信息页面上,输入账号显示名称,选择账号的主要用途选项,然后选择您所在的国家/地区、时区和币种。确认右上角有红色的测试账号账号标签,点击提交,然后点击探索您的账号,打开测试经理账号信息中心。
在测试经理账号中,创建一个测试客户账号:依次点击账号 > > 创建新账号。输入账号名称,选择您所在的国家/地区、时区和币种,然后保存账号。您通过测试经理账号创建的所有客户账号都会自动成为测试账号。
在测试客户账号下创建一个或多个测试广告系列,以便后续报告查询返回抽样数据。
从 Google Ads 界面中记录两个 10 位数的客户 ID(不带连字符),以便进行 API 配置:
customer_id(目标客户账号):使用您在其中创建了测试广告系列的新测试客户账号的 10 位数客户 ID(查询或更改广告系列的 API 调用必须以客户账号而非经理账号为目标)。login-customer-id(经理账号):如果您使用与测试经理账号关联的 Google 账号或服务账号进行身份验证,请将login-customer-id设置为测试经理账号的 10 位数客户 ID。
按照进行首次 API 调用中的说明配置客户端库或 REST 凭据,并针对新的测试客户账号执行测试查询。
查看测试账号
如需在 Google Ads 界面中查看测试经理账号下的测试客户账号,请选择查看已撤销的账号,以取消隐藏这些账号。
在经理账号设置期间以及在某些 Google Ads 界面视图中,测试账号会显示红色的测试账号标签:
如需通过 API 检查某个账号是否为测试账号,请使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法查询 customer.test_account 字段:
SELECT customer.id, customer.test_account
FROM customer
LIMIT 1
您可以针对测试经理账号或测试客户账号执行此查询。通过测试经理账号查询测试客户账号时,请在 login-customer-id 标头中添加经理账号 ID。测试经理账号和测试客户账号会针对 customer.test_account 返回 true,而生产账号会返回 false。
限制
使用测试账号时,请注意以下限制:
- 由于测试账号无法投放广告,也无法以任何方式与您的生产账号互动,因此投放指标(例如展示次数、转化次数或费用数据)为空。
- 您无法在测试账号中测试某些功能,包括出价模拟器、转化数据上传和结算。其他功能(包括建议)在测试账号中的功能有限,因为测试账号不会生成投放数据。
- 测试经理账号层次结构最多可包含 50 个测试账号。如果您需要更多测试账号,可以再创建一个测试经理账号。
- 如果测试账号生成大量持续请求,可能会在不另行通知的情况下受到限制。
如需了解如何解决这些限制,请参阅测试最佳实践。