最佳做法

本頁詳細說明透過 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 頻道和影片。

並行錯誤

如果同時更新相同委刊項的設定或指定目標,可能會傳回錯誤。

如要避免這種情況,請採取下列做法:

  • 使用大量編輯要求大量管理指定目標。
  • 更新相同委刊項的佇列要求。請勿傳送要求,直到先前的要求傳回回應為止。