您可以使用 Display & Video 360 API 擷取 YouTube 與合作夥伴委刊項、其廣告群組和廣告資源,以及與 YouTube 與合作夥伴廣告放送相關的指定目標。YouTube 與合作夥伴資源和指定目標只能 透過 UI 建立或更新。
本頁將說明如何使用 Display & Video 360 API 找出 YouTube 與合作夥伴資源及擷取相關指定目標,以及如何透過使用者介面中的結構化資料檔案 (SDF),大量建立及更新 YouTube 與合作夥伴資源。
找出 YouTube 與合作夥伴資源
YouTube 與合作夥伴資源包括特定類型的委刊項、廣告群組和廣告。
明細項目
下列 LineItemType
值的委刊項是 YouTube 與合作夥伴委刊項,無法建立或更新:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
您可以從 LineItem
資源的 youtubeAndPartnersSettings
欄位擷取 YouTube 與合作夥伴委刊項專屬的設定。
YouTube 廣告群組和廣告
YouTube 廣告群組和廣告是 YouTube 與合作夥伴委刊項下的子資源,可供進一步指定。
一個 YouTube 與合作夥伴委刊項之下可以有多個 AdGroup
資源,每個資源都有專屬的其他指定目標和出價策略。每個 AdGroup
資源底下可以有多個相同廣告格式的 AdGroupAd
資源,每個資源都有專屬的廣告素材資訊和其他追蹤網址清單。
擷取指定目標
用於放送 YouTube 與合作夥伴廣告的指定目標是在廣告客戶層級、委刊項層級和廣告群組層級指定。
從父項資源繼承的 YouTube 與合作夥伴指定目標不會反映在子項資源的指定目標設定中,非 YouTube 與合作夥伴資源的標準。
為了擷取與 YouTube 與合作夥伴廣告放送相關的所有指定目標,您必須:
- 使用
advertisers.listAssignedTargetingOptions
擷取指派給上層廣告主的指定目標, - 使用
advertisers.lineItems.bulkListAssignedTargetingOptions
擷取指派給上層委刊項的指定目標, - 並使用
advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions
擷取指派給其上層廣告群組的指定目標。
正在嘗試修改 YouTube 指定目標
就像使用 YouTube 與合作夥伴資源一樣,您無法 使用 Display & Video 360 API 修改 YouTube 與合作夥伴指定目標。任何嘗試修改下列指定目標時,都會傳回錯誤:
- 可在下列指定類型中指派的任何層級指定目標:
TARGETING_TYPE_SESSION_POSITION
、TARGETING_TYPE_YOUTUBE_CHANNEL
和TARGETING_TYPE_YOUTUBE_VIDEO
。 - 指派給 YouTube 與合作夥伴委刊項資源的指定目標。
- 已指派給
AdGroup
資源的指定目標。
透過 SDF UI 上傳功能建立及更新
雖然您無法使用 Display & Video 360 API 建立或更新 YouTube 與合作夥伴資源,但可以透過 Display & Video 360 UI 上傳結構化資料檔案 (SDF),大量建立或更新 YouTube 與合作夥伴委刊項、廣告群組和廣告。
這些資源會以委刊項、YouTube 廣告群組和 YouTube 廣告檔案格式在 SDF 中表示。
您可以使用 Display & Video 360 API 產生及下載結構化資料檔案。您可以編輯現有資料列,對現有資源進行變更,或是新增資料列來建立新資源,然後透過 Display & Video 360 UI 上傳更新的檔案。