本页详细介绍了使用 Display & Video 360 API 管理定位的限制和最佳实践。
在创建订单项时分配的定位条件
某些定位类型在创建订单项时会分配默认值。这些定位类型包括:
为避免出错,请了解在创建订单项时分配给订单项的完整定位条件套件。您可以使用 bulkListAssignedTargetingOptions 检索分配给订单项的所有定位条件。
如果未分配任何类型的定位,则表示系统会隐式应用某些设置。例如,如果某个订单项未分配 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 定位选项,则该订单项在投放广告时将使用“授权的直接卖家和经销商”。
定位选项可能已废弃
定位选项并非一成不变。少数选项可能会不时被弃用。已弃用的定位选项不会影响订单项的广告投放。弃用后,这些选项将处于未分配状态。尝试检索或分配这些选项的请求会导致错误。
为避免这些错误,请定期检查存储的定位选项 ID。为节省配额,我们建议缓存常用 ID。存储 ID 意味着您可能不会意识到某个定位选项已被弃用。定期使用 get 方法检索所有已存储的定位选项 ID,以确认 Display & Video 360 是否仍支持这些 ID。
对同一订单项的并发定位请求将失败
尝试使用并发请求更新订单项的设置或分配的定位条件会返回错误。
如需同时为单个订单项添加或移除多个已分配的定位选项,请使用单个 bulkEditAssignedTargetingOptions 请求。如果您想更新订单项的设置和定位条件,请将请求排队,以确保它们按顺序发送。
常见的定位错误
使用 Display & Video 360 API 管理定位时,出现错误通常有以下三种原因。
配置错误
定位受配置限制的约束。如果请求尝试更新定位条件,但更新后的定位条件违反了这些规则,则请求会返回错误。
配置错误通常是由现有定位条件引起的。为避免这种情况,请执行以下操作:
- 使用
list请求获取指定类型的现有定位。 - 查看现有定位条件。评估需要添加或移除哪些定位条件才能获得所需的配置。
- 使用
bulkEditAssignedTargetingOptions请求更新定位条件。
无法移除父资源继承的定位,但可能会导致这些错误。
YouTube 及合作伙伴错误
您无法使用 Display & Video 360 API 更新 YouTube 及合作伙伴定位。尝试更新此定位条件的请求将返回错误。
此定位的定义如下:
并发错误
同时更新同一订单项的设置或定位的请求可能会返回错误。
为避免出现这种情况,请执行以下操作: