本頁詳細說明透過 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 與合作夥伴的指定目標。嘗試更新這項指定目標的要求會傳回錯誤。
這項指定目標的定義如下:
並行錯誤
如果同時更新相同委刊項的設定或指定目標,可能會傳回錯誤。
如要避免這種情況,請採取下列做法: