最佳实践

本页详细介绍了使用 Display & Video 360 API 管理定位的限制和最佳实践。

在创建订单项时分配的定位条件

某些定位类型在创建订单项时会分配默认值。这些定位类型包括:

为避免出错,请了解在创建订单项时分配给订单项的完整定位条件套件。您可以使用 bulkListAssignedTargetingOptions 检索分配给订单项的所有定位条件。

如果未分配任何类型的定位,则表示系统会隐式应用某些设置。例如,如果某个订单项未分配 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 定位选项,则该订单项在投放广告时将使用“授权的直接卖家和经销商”。

定位选项可能已废弃

定位选项并非一成不变。少数选项可能会不时被弃用。已弃用的定位选项不会影响订单项的广告投放。弃用后,这些选项将处于未分配状态。尝试检索或分配这些选项的请求会导致错误。

为避免这些错误,请定期检查存储的定位选项 ID。为节省配额,我们建议缓存常用 ID。存储 ID 意味着您可能不会意识到某个定位选项已被弃用。定期使用 get 方法检索所有已存储的定位选项 ID,以确认 Display & Video 360 是否仍支持这些 ID。

对同一订单项的并发定位请求将失败

尝试使用并发请求更新订单项的设置或分配的定位条件会返回错误。

如需同时为单个订单项添加或移除多个已分配的定位选项,请使用单个 bulkEditAssignedTargetingOptions 请求。如果您想更新订单项的设置和定位条件,请将请求排队,以确保它们按顺序发送。

常见的定位错误

使用 Display & Video 360 API 管理定位时,出现错误通常有以下三种原因。

配置错误

定位受配置限制的约束。如果请求尝试更新定位条件,但更新后的定位条件违反了这些规则,则请求会返回错误。

配置错误通常是由现有定位条件引起的。为避免这种情况,请执行以下操作:

  1. 使用 list 请求获取指定类型的现有定位。
  2. 查看现有定位条件。评估需要添加或移除哪些定位条件才能获得所需的配置。
  3. 使用 bulkEditAssignedTargetingOptions 请求更新定位条件。

无法移除父资源继承的定位,但可能会导致这些错误。

YouTube 及合作伙伴错误

您无法使用 Display & Video 360 API 更新 YouTube 及合作伙伴定位。尝试更新此定位条件的请求将返回错误。

此定位的定义如下:

  • 分配给 YouTube 及合作伙伴订单项广告组的任何定位条件。
  • 广告客户对会话位置以及各个 YouTube 频道和视频的定位。

并发错误

同时更新同一订单项的设置或定位的请求可能会返回错误。

为避免出现这种情况,请执行以下操作:

  • 使用批量修改请求批量管理定位条件。
  • 更新同一订单项的请求加入队列。在上一个请求返回响应之前,请勿发送请求。