結構化資料檔案 (SDF) 可協助您達成下列目標:
- 快速建立多個廣告活動、廣告訂單或委刊項。
- 同時大量編輯多個廣告活動、廣告訂單或委刊項。
本文概述如何運用 Display & Video 360 的結構化資料檔案 (SDF) 執行一些常見工作。如要進一步瞭解各種版本的結構化資料檔案及相關功能,請參閱這篇文章。
編輯或建立 SDF 時,建議您使用 CSV 格式。
請避免使用 Excel、Python、TextEditor 或其他工具編輯或建立 SDF。
使用其他格式或工具可能會使指定目標設定失效、以非預期的方式更改指定目標設定,或者讓您無法成功上傳檔案。進一步瞭解如何下載、編輯及上傳 SDF。
建立新的廣告活動、廣告訂單和委刊項
您可以單單使用 SDF 建立新的廣告訂單和委刊項,也可以在現有廣告訂單中新增委刊項。
- 首先請詳閱 SDF 規格。
- 在 Display & Video 360 中前往廣告主的廣告訂單頁面,依序點選「其他選項」圖示 和「上傳」,並上傳 SDF 檔案 (用於廣告訂單、委刊項、YouTube 廣告群組和 YouTube 廣告)。
使用暫時 ID 連結檔案
如果想同時在新的廣告訂單中新建委刊項 (或是在新的 YouTube 廣告群組中新建 YouTube 廣告),請上傳內含暫時自訂 ID (暫時 ID) 的 SDF 檔案,以便連結檔案。
暫時 ID 的格式為「
ext<自訂 ID>
」(例如:ext123
)。這個 ID 要填入「廣告訂單 ID」欄位 (用於連結委刊項和廣告訂單) 和「廣告群組 ID」欄位 (用於連結 YouTube 廣告和 YouTube 廣告群組)。檔案上傳並處理完畢之後,系統就會將所有暫時 ID 替換成 Display & Video 360 產生的專屬 ID,不過所有項目仍會依據暫時 ID 保有適當關聯。
請記得同時上傳所有相依檔案。
注意:如果您使用 5.3 版之前的 SDF,系統不會在傳回的檔案中替換與上傳成功的項目相對應的暫時 ID。在重新上傳實體之前,請將
SDF-{EntityName}-Failed-ResultFile.csv
和SDF-{EntityName}-Unprocessed-ResultFile.csv
檔案中的暫時 ID 替換成新產生的 ID。 - 選擇所需的 CSV 檔案,然後點選「上傳」。
- Display & Video 360 會隨即驗證檔案,並顯示每個檔案的狀態 (系統還會傳送電子郵件給您,確認廣告訂單、委刊項、YouTube 廣告和 YouTube 廣告群組已建立完成,也可能通知您建立廣告活動時發生的錯誤)。
-
已套用更新:系統已成功套用您對 SDF 所做的任何更新。如要確認更新,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後在該檔案中確認更新。 -
已成功套用部分更新:系統已成功套用一或多個檔案的部分更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後開啟SDF-{EntityName}-Failed-ResultFile.csv
檔案,即可找出並修正錯誤。修正完成後,請再次上傳檔案。 -
套用失敗:系統無法順利套用您對 SDF 所做的更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Failed-ResultFile.csv
檔案,開啟該檔案即可找出並修正錯誤。修正完成後,請再次上傳檔案。
-
- 完成後,點選「關閉」即可完成變更。
在現有廣告訂單中新增委刊項
- 在 Display & Video 360 中,確認您已建立要用於委刊項的廣告訂單。
如果您能夠自行建立格式正確的結構化資料檔案,可以直接跳到下方的步驟 4。
- 前往廣告主頁面中的委刊項清單,然後依序點選「動作」和「下載 SDF」。
- 在隨即開啟的視窗中,選取要建立的項目類型 (委刊項、YouTube 廣告群組和/或 YouTube 廣告),然後點選「下載」按鈕下載適當的 SDF。
您也可以同時使用這些 SDF 編輯現有項目。 - 根據想要建立的委刊項,在 SDF 中填入所有詳細資料 (如需 SDF 的規格說明,請造訪這個網頁)。
- 在 Display & Video 360 中前往廣告主的廣告訂單頁面,然後依序點選「動作」和「上傳」並上傳 SDF。
- 選擇所需的 CSV 檔案,然後點選「上傳」。
- Display & Video 360 會隨即驗證檔案,並顯示每個檔案的狀態 (系統還會傳送電子郵件給您,用於確認您的項目已建立完成,也可能通知您發生的錯誤)。
-
已套用更新:系統已成功套用您對 SDF 所做的任何更新。如要確認更新,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後在該檔案中確認更新。 -
已成功套用部分更新:系統已成功套用一或多個檔案的部分更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後開啟SDF-{EntityName}-Failed-ResultFile.csv
檔案,即可找出並修正錯誤。修正完成後,請再次上傳檔案。 -
套用失敗:系統無法順利套用您對 SDF 所做的更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Failed-ResultFile.csv
檔案,開啟該檔案即可找出並修正錯誤。修正完成後,請再次上傳檔案。
-
- 完成後,點選「關閉」即可完成變更。
編輯現有的廣告活動、廣告訂單和委刊項
利用 Display & Video 360 API 節省寶貴時間
下載廣告訂單和委刊項的方式有兩種:使用 Display & Video 360 API,以及透過 Display & Video 360 使用者介面。想瞭解如何使用 Display & Video 360 API 下載,請參閱 SDF Create Task API 規格。
如要使用 Display & Video 360 API 下載現有的委刊項,請跳至下方的步驟 3。
- 在 Display & Video 360 中,前往廣告主頁面中的廣告訂單清單、委刊項清單,或個別廣告訂單中的委刊項清單。
- 選擇下列其中一個選項,瞭解下載現有委刊項的各種方式:一或多個廣告訂單中的所有委刊項
- 首先,依序前往以下任一位置:
- 「廣告主」>「廣告訂單」
- 「廣告主」>「委刊項」
- 「廣告主」>「廣告訂單」>「委刊項」
- 在右側依序點選「其他選項」圖示 和「下載」,然後按照步驟將委刊項下載到 SDF。
- (選用) 您也可以點選「儲存至 Google 試算表」,將委刊項匯出至 Google 試算表。
- 前往廣告主頁面中的委刊項清單 (或個別廣告訂單中的委刊項清單),找出想編輯的委刊項,並勾選旁邊的核取方塊。
- 在委刊項清單頂端的選單列中,依序點選「動作」和「下載」。系統會隨即將委刊項下載到 SDF。
- (選用) 您也可以點選「儲存至 Google 試算表」,將委刊項匯出至 Google 試算表。
- 首先,依序前往以下任一位置:
- 在下載的 SDF 中修改委刊項,然後儲存檔案。請務必將 SDF 儲存為 CSV 檔案。請注意,如果您使用 Excel 進行變更,請勿編輯 SDF 中的任何時間戳記,否則時間戳記可能會損毀,導致 Display & Video 360 無法匯入檔案。
- 在 Display & Video 360 中前往廣告主的廣告訂單頁面,依序點選「動作」和「上傳試算表」,然後上傳 SDF。
- 選擇所需的 CSV 檔案,然後點選「上傳」。
- Display & Video 360 會隨即驗證檔案,並顯示每個檔案的狀態 系統也會透過電子郵件將每個檔案的詳細資料傳送給您 (確認委刊項已建立完成,或是建立委刊項的過程中發生錯誤)。
-
已套用更新:系統已成功套用您對 SDF 所做的任何更新。如要確認更新,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後在該檔案中確認更新。 -
已成功套用部分更新:系統已成功套用一或多個檔案的部分更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後開啟SDF-{EntityName}-Failed-ResultFile.csv
檔案,即可找出並修正錯誤。修正完成後,請再次上傳檔案。 -
套用失敗:系統無法順利套用您對 SDF 所做的更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Failed-ResultFile.csv
檔案,開啟該檔案即可找出並修正錯誤。修正完成後,請再次上傳檔案。
-
- 完成後,點選「關閉」即可完成變更。
下載廣告空間來源
- 前往「我的廣告空間」頁面中的廣告空間來源清單。
- 選擇下列其中一個選項,瞭解如何將廣告空間來源下載到 SDF:所有廣告空間來源
- 依序點選「其他選項」圖示 和「下載 SDF」,系統會隨即將完整的廣告空間來源清單下載到 SDF。
- 找到想下載的廣告空間來源,並勾選旁邊的核取方塊。
- 在廣告空間來源清單頂端的藍色橫列中點選「下載 SDF」,系統隨即會將您的廣告空間來源下載到 SDF。
建立、修改及上傳廣告空間來源
進一步瞭解 SDF 中的不同資料列,包括何時可使用哪些欄位、不同的類型,以及上傳時是否可以寫入值。
- 將廣告空間來源下載成 SDF 之後,選用一種應用程式開啟這個 CSV 檔案,然後進行變更。如果您使用 Excel 進行變更,請勿編輯 SDF 中的任何時間戳記,否則時間戳記可能會損毀,進而導致 Display & Video 360 無法匯入檔案。
- 選擇下列其中一個選項,瞭解如何建立及修改廣告空間來源:修改現有廣告空間來源
- 找到您想修改的廣告空間來源資料列,然後視需要變更廣告空間來源相關欄位的內容。
注意:預訂交易必須等到交易結束日期過後才能封存。暫停現有廣告空間來源 (僅適用於預訂交易)- 找到您要封存的廣告空間來源資料列。
- 在「Status」(狀態) 欄位中輸入「Archived」(已封存)。
- 找到您想暫停的廣告空間來源資料列。
- 在「Status」(狀態) 欄位中輸入「Paused」(已暫停)。
- 在「Pause Reason」(暫停原因) 欄位中,輸入您要暫停該廣告空間來源的原因。
- 找到您想取消暫停的廣告空間來源資料列。
- 在「Status」(狀態) 欄位中輸入「Active」(有效)。
- (選用) 取消暫停之前,在「Pause Reason」(暫停原因) 欄位中,刪除您暫停該廣告空間來源的原因。
- 為每個新的廣告空間來源新增一列。
- 為每個新的廣告空間來源填寫下列欄位:
- Exchange (廣告交易平台。注意:儲存後即無法更新)
- Deal ID (交易 ID。注意:儲存後即無法更新)
- Name (名稱)
- Deal Type (交易類型)
- (選填) Seller Name (賣方名稱)
- Floor CPM (千次曝光出價底價;格式為:$X.XX)
- Currency Code (貨幣代碼)
- Start Date (開始日期)
- End Date (結束日期)
- Permissioned Advertiser (擁有權限的廣告主)
- 完成後,儲存您的 CSV 檔案。
- 返回 Display & Video 360 的「我的廣告空間」頁面 (也就是您下載廣告空間來源的頁面),依序點選「其他選項」圖示 和「上傳 SDF」,接著選擇所需的 CSV 檔案,然後按一下「上傳」(提醒您,視您之前從哪個夥伴下載 SDF 而定,您必須將 SDF 上傳至同一個夥伴)。
- Display & Video 360 會隨即驗證檔案,並顯示每個檔案的狀態:
-
已套用更新:系統已成功套用您對 SDF 所做的任何更新。如要確認更新,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後在該檔案中確認更新。 -
已成功套用部分更新:系統已成功套用一或多個檔案的部分更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Updated-ResultFile.csv
檔案,然後開啟SDF-{EntityName}-Failed-ResultFile.csv
檔案,即可找出並修正錯誤。修正完成後,請再次上傳檔案。 -
套用失敗:系統無法順利套用您對 SDF 所做的更新。如要判斷在套用過程中發生了哪些錯誤,請點選「下載檔案」下載
SDF-ResultFile.zip
檔案,將該檔案解壓縮並找到SDF-{EntityName}-Failed-ResultFile.csv
檔案,開啟該檔案即可找出並修正錯誤。修正完成後,請再次上傳檔案。
-
- 完成後,點選「關閉」即可完成變更。
下載中繼資料
- 依序點選「廣告主」、「廣告活動」、「其他選項」圖示 和「下載中繼資料」下載檔案,名稱為 SDF 所使用的各種實體 ID 對應。
- 視您的廣告主設定而定,中繼資料檔案可能會相當龐大。
- 點選頁面頂端的「大量操作狀態」圖示 ,即可追蹤中繼資料下載進度。想進一步瞭解如何追蹤大量操作的編輯記錄,請參閱這篇文章。
限制
SDF 不支援下列功能:
- 已安裝的應用程式指定類別
- 設有地理圍欄的商家目標
- 針對熱門精選委刊項的總收視點數採購
- 數位戶外廣告 (DOOH) 委刊項
建議您定期比較 Display & Video 360 中的廣告活動設定與 developers.google.com 所列的可用 SDF 欄位。
常見問題
Display & Video 360 可以在 SDF 處理完畢之後傳送電子郵件通知其他人嗎?可以。所有 SDF 電子郵件都可以傳送給管理員的電子郵件地址。如果您希望小組通訊清單中的成員都能查看 SDF 處理狀態郵件,或是想透過系統剖析這些電子郵件,這項功能就相當實用。您可以前往夥伴或廣告主頁面的「基本詳細資料」,在「結構化資料檔案」部分設定「管理員」電子郵件。
可以。如要根據屬於同一夥伴的多個廣告客戶下載及上傳檔案,請前往該夥伴的廣告客戶清單,選取所需廣告客戶,然後利用「動作」選單下載 SDF。SDF 編輯完成後,請返回廣告客戶清單上傳您的檔案。
可以。您可以在夥伴層級和廣告主層級變更 SDF 版本。
- 夥伴層級:如要在夥伴層級變更 SDF 版本,請依序點選「<夥伴名稱>」、「設定」和「基本詳細資料」。接著,在頁面的「結構化資料檔案」部分中點選下拉式選單,並選取所需 SDF 版本。
- 廣告主層級:如要在廣告主層級變更 SDF 版本,請依序點選「<廣告主名稱>」、「設定」和「基本詳細資料」。接著,在頁面的「結構化資料檔案」部分中點選下拉式選單,並選取所需 SDF 版本。此外,您也可以選擇覆寫夥伴層級設定。
我們建議您盡可能採用最新版本的 SDF。
下載委刊項的方式有兩種:透過 Display & Video 360 API,以及在 Display & Video 360 中手動下載。
- 使用 API:如要使用 API 下載 SDF,請前往 developers.google.com 參閱結構化資料相關文章。
- 透過使用者介面:如要透過 Display & Video 360 使用者介面手動下載委刊項,請在 Display & Video 360 中依序前往以下任一位置:
- 「廣告主」>「廣告訂單」>「動作」>「下載」
- 「廣告主」>「委刊項」>「動作」>「下載」
- 「廣告主」>「廣告訂單」>「委刊項」>「下載」
請參閱上方的「建立新的廣告訂單和委刊項」或「編輯現有的廣告訂單和委刊項」一節。
可以。Display & Video 360 會按照上傳順序處理 SDF 檔案。請務必事先瞭解如何使用暫時 ID 連結檔案。
不過,為避免發生錯誤,如果多個檔案中含有相同的委刊項,請避免同時上傳這些檔案。
請下載您要複製的委刊項 SDF,然後移除 SDF 中的委刊項 ID
。假如有 SDF 資料列缺少委刊項 ID
,Display & Video 360 就會知道要建立新的委刊項。請將這些委刊項的名稱變更為新名稱。
如要在不同廣告訂單之間複製委刊項,請務必更新「廣告訂單 ID
」欄位。
實體讀取檔案是 Google Cloud Storage 中的平面檔,包含 Display & Video 360 實體 (例如地理區域、廣告素材、目標對象名單等) 的查詢值。這些查詢值可用於依 ID 為委刊項指派廣告素材和指定目標。
可以,但部分指定目標設定是廣告主的專屬設定,例如管道、目標對象名單,以及特定廣告主的廣告空間來源 (如交易)。
因此,如果您從「廣告主 A」下載委刊項的 SDF 檔案,然後將委刊項上傳至「廣告主 B」,請務必先從 SDF 中移除任何管道或第一方目標對象名單,因為其他廣告主用不到這些資料。
請前往 developers.google.com,參閱 Display & Video 360 結構化資料檔案相關文章,瞭解支援的指定目標選項。