大量檔案架構
大量架構會定義檔案的內容，以供大量 API 下載或上傳。 針對下載和上傳，大量服務支援 DownloadEntity 值集中的檔類型和對應的架構。
如需使用大量服務來管理行銷活動的詳細資訊，請參閱 大量下載和上傳。 如需了解數據文件內容的詳細資訊，請參閱下列各節。
檔案架構
您可以選擇下載索引標籤或逗號分隔的記錄集， (資料列) 和欄位 (資料列) 。 第一個數據行標頭的名稱為 Type。 其餘的數據行名稱會對應至內的屬性，或與對應的記錄類型相關聯的屬性。
重要事項
新的記錄類型 (數據列) 和欄位 (資料行) 可以隨時新增，而且您不應該依賴大量下載或大量上傳結果檔案中的記錄或欄位順序。 同樣地，除非參考檔中另有說明，否則您不應該相依於每個字段中傳回的固定值集。
同樣地，在上傳期間，您可以依任何順序提交字段。 建立新實體時，上傳記錄順序很重要，如下列 類型階層中所述。
格式化版本
大量格式版本與 Bing 廣告 API 版本不同。 格式版本可讓您有彈性的升級路徑採用最新支援的功能，而不會中斷您的應用程式。 最佳做法是一律升級至最新的格式版本。 目前唯一支援的格式版本是 6.0。
若要使用大量下載指定檔格式版本，請在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 要求中將 FormatVersion 設定為 6.0。
若要使用大量上傳指定版本，請將 [格式版本] 記錄的 [名稱] 字段設定為 6.0。
記錄類型
下表詳細說明使用格式 6.0 版 上傳和下載的記錄。
重要事項
新的記錄類型 (數據列) 和欄位 (資料行) 可以隨時新增，而且您不應該依賴大量下載或大量上傳結果檔案中的記錄或欄位順序。
類型階層
下載檔一律會包含 格式版本 和 帳戶 記錄類型的記錄。 若要上傳， 格式版本 是必要的，而且必須在大量檔案中的所有其他記錄類型之前。
如果父實體是在相同的檔案中建立，則應該在大量檔案中的任何相依子記錄之前。 例如，如下圖所示，將網站鏈接廣告延伸模組與營銷活動建立關聯時，活動 網站鏈接廣告擴 充功能記錄必須包含在檔案中，並同時包含在 Campaign 和 Sitelink Ad Extension 記錄之後。 營銷活動網站鏈接廣告延伸模組記錄的 [標識符] 和 [父標識符] 字段應該分別設定為 Sitelink Ad Extension 和 Campaign 記錄的識別碼。 如果 網站鏈接廣告延伸 模組和 行銷活動 記錄也是新的，而且尚未指派Microsoft廣告標識符，則您應該使用 參考密鑰。
不需要包含已獲指派有效Microsoft Advertising標識碼之父實體的記錄。
新增、更新和刪除大量檔案記錄時，支援部分成功。 例如，如果您嘗試新增三個營銷活動，但檔案中只正確指定兩個活動，則會新增兩個活動。 結果檔案會包含成功的 行銷活動 記錄、一個嘗試的 行銷活動 記錄，以及一個 行銷活動錯誤 記錄的詳細數據。
如果還不知道新的行銷活動標識碼，例如在同一個檔案中新增行銷活動、廣告群組、文字廣告和關鍵詞時，請將 行銷活動 名稱指定為任何子記錄的 邏輯參考密鑰 。 您不需要在上傳中指定現有的父系。
大量記錄支援部分更新，包括負關鍵詞、負數網站和目標準則。 例如，您可以更新單一位置準則的報價，而且不需要下載並上傳營銷活動或廣告群組的整組目標準則。
更新記錄時，需要更新記錄的 [ 標識 符] 欄位。 父記錄的 父標識碼 或 參考索引鍵 也是必要的。
更新行銷活動或廣告組名時，如果提供正確的 父 標識符，則選擇性地指定子記錄的新名稱。
如果您要將一組記錄取代為另一個集合，則必須指定新集合之前已刪除的記錄。 例如，若要取代指定行銷活動的所有現有營銷活動負關鍵詞，請先包含 [狀態] 設定為 [已刪除] 且 [父標識符] 設定為營銷活動標識碼的 [營銷活動負數關鍵詞]。 如果您未指定任何 標識 符，也就是不要嘗試刪除特定 camapaign negative 關鍵詞，這會有效地刪除該行銷活動的所有 Campaign Negative 關鍵詞 。 在「全部刪除」記錄下方，您可以包含一或多個新的 行銷活動負關鍵詞 記錄，以及上傳新增作業的所有必要屬性。
如果您要將現有的記錄取代為具有相同唯一屬性的新記錄，則必須在新記錄之前指定已刪除的記錄。 例如，若要取代指定廣告群組的現有廣告群組動態搜尋廣告目標，請先包含狀態設為 [已刪除] 的廣告群組動態搜尋廣告目標、將標識符設定為現有動態廣告目標 (網頁準則) 標識符，以及將 [父標識符] 設定為廣告群組標識符。 在已刪除的記錄下方，您可以包含新的 廣告群組動態搜尋廣告目標 記錄， (新的網頁條件) 。
注意事項
在大部分情況下，您可以更新現有的記錄，而不是提交個別的刪除和新增記錄，例如，您可以更新現有營銷活動性別準則的 [標定調整] 字段。
刪除記錄時，需要 [ 標識符 ] 字段。 父實體的參考，不論值是 Microsoft Advertising 指派的系統標識碼，還是父記錄 的參考密鑰 ，也是必要的。 例如，刪除廣告群組時，廣告群組記錄的 [父標識符] 字段應該符合 [營銷活動] 記錄中的 [標識符] 字段，或廣告群組記錄的 [營銷活動] 欄位應該符合營銷活動記錄中的 [營銷活動] 欄位。 如果同時提供這兩者，則會忽略廣告群組記錄 (參考密鑰) 的 [父標識符] 字段。
有幾個例外狀況，結果檔案只會包含您上傳的數據行。 例如，如果您上傳沒有標識符數據行標頭的新 Ad Group Negative 關鍵詞，則結果檔不會包含新負關鍵詞的指派標識碼。 大量檔案應該包含 [標識符] 數據行;不過，您應該為每個新的廣告群組負關鍵詞保留標識符空白。 此規則的例外是行銷活動、廣告群組、廣告和關鍵詞，在此情況下，結果檔案會包含所有數據行，而不論上傳的數據行為何。
使用 delete_value更新
若要移除現有的設定，您不應該將空字串 (“”) 寫入至大量檔案，因為大量服務會忽略這類字串串。 使用保留的 「delete_value」 字串來刪除或重設選擇性字段的值。
- 如果您在選擇性欄位中使用保留的 「delete_value」 字串，則會刪除先前的設定。 例如，如果您將廣告群組記錄的 [自定義參數] 字段設定為 [delete_value]，則會從廣告群組中刪除所有先前的自定義參數。 同樣地，如果您將廣告群組記錄的 [追蹤範本] 字段設定為 [delete_value]，則會從廣告群組中刪除先前的追蹤範本。
- 適用於 .NET、Java 和 Python 的 Bing 廣告 SDK 會在適用時自動撰寫「delete_value」。 如需詳細資訊 ，請參閱 Bulk Service Manager - 使用 delete_value 更新。
如果您在必要欄位中使用 「delete_value」，請注意下列事項。
- 如果您使用保留的 「delete_value」 字串來取代必要的基本值，則會忽略它。 雖然字段未更新，但 「delete_value」 字串會透過上傳結果檔案傳遞。 例如，如果您將 廣告群組 記錄 (廣告組名) 的 [ 廣告群組 ] 字段設定為 [delete_value]，則不會更新廣告群組的名稱。
- 如果您使用保留的 「delete_value」 字串來取代必要的值集，欄位將會更新為預設值，而結果檔案會反映該變更。 例如，如果您將廣告群組記錄的 [網络發佈] 字段設定為 [delete_value]，則廣告群組的網络發佈會設定為 OwnedAndOperatedAndSyndicatedSearch，而上傳結果檔案會反映相同的內容。
參考索引鍵
在大量檔案中參照尚未指派廣告標識碼Microsoft前一筆記錄時，您可以根據記錄類型使用邏輯參考索引鍵或負數參考索引鍵。
注意事項
如果父實體是在相同的檔案中建立，則應該在大量檔案中的任何相依子記錄之前。
負數參考索引鍵
參考大量檔案中尚未指派廣告標識碼Microsoft前一筆記錄時，您可以將延伸模組的 [ 標識 符] 字段設定為您選擇的負數。 此自定義標識碼稱為負數參考索引鍵。 然後，您可以在相依記錄的 [ 標識 符] 字段內使用負數參考索引鍵。
第一個範例示範如何為新的營銷活動建立廣告群組。 將廣告群組記錄中的 [父標識符] 字段設定為活動 (-111) 的負數參考索引鍵。 如果您要將其他記錄新增至應該讓廣告群組作為其父系的相同檔案 (例如關鍵詞或廣告群組註標廣告延伸模組) ，則您也應該將廣告群組中的 [標識符] 字段設定為負值，例如 -1111，可從子記錄參考。
| 類型 | 識別碼 | 父項識別碼 |
|---|---|---|
| 行銷活動 | -111 | |
| 廣告群組 | -1111 | -111 |
第二個範例示範如何為新的營銷活動和新的註標廣告延伸模組建立營銷活動註標廣告延伸模組。 此範例也會示範如何為新的廣告群組和另一個新的註標廣告延伸模組建立廣告群組註標廣告延伸模組。
- 將 Campaign Callout Ad Extension 記錄中的 [父標識符] 字段設定為 Campaign (-111) 的負參照索引鍵，並將 [行銷活動圖說文字廣告延伸模組] 記錄中的 [標識符] 字段設定為 [圖說文字廣告延伸模組] (-11) 的負參照索引鍵。
- 將廣告群組圖說文字廣告延伸模塊記錄中的 [父標識符] 字段設定為 ad Group (-1111) 的負數參考索引鍵，並將 [廣告群組圖說文字廣告延伸模組] 記錄中的 [標識符] 字段設定為 [圖說文字廣告延伸模組] (-12) 的負值參照密鑰。
| 類型 | 識別碼 | 父項識別碼 |
|---|---|---|
| 註標廣告延伸模組 | -11 | |
| 註標廣告延伸模組 | -12 | |
| 行銷活動 | -111 | |
| 廣告群組 | -1111 | -111 |
| 營銷活動註標廣告延伸模組 | -11 | -111 |
| 廣告群組註標廣告延伸模組 | -12 | -1111 |
邏輯參考索引鍵
參照新的 行銷活動 或 廣告群組 記錄時，您可以使用行銷活動和廣告組名，而不是將 [父標識 符] 字段設定為子記錄內的 負數參考索引鍵 。 例如，若要將新的廣告群組新增至新的行銷活動，並將新關鍵詞新增至新的廣告群組，請在子記錄中設定 [ 營銷活動 ] 和 [ 廣告群組 ] 字段，如下列範例所示。
| 類型 | 行銷活動 | 廣告群組 |
|---|---|---|
| 行銷活動 | 美製鞋 | |
| 廣告群組 | 美製鞋 | 女性紅鞋銷售 |
用戶端識別碼
用戶端標識碼可用來將大量上傳檔案中的輸入記錄與結果檔案中的輸出記錄產生關聯。 例如，新增記錄時，您可以將 [用戶端識別 符] 字段設定為您選擇的字串值。 Microsoft Advertising 系統不會修改您的用戶端識別碼，並將它們傳遞至對應記錄的結果檔案。
錯誤
大量下載檔或大量上傳結果檔案可能包含對應 的 Type 字段包含 [錯誤後綴] 的記錄。 例如， 產品廣告錯誤 記錄類型代表產品廣告錯誤。 [ 錯誤 ] 和 [ 錯誤號碼] 資料行會包含有關錯誤的詳細數據。
注意事項
上傳結果檔案可能包含對應至一筆上傳記錄的多個錯誤記錄。
與 [最終 URL] 等新功能相關的錯誤，會包含有關 欄位路徑資料行 中錯誤發生位置的其他詳細數據。 每個欄位路徑名稱都會對應至其中一個 「行銷活動管理服務 」數據物件的元素。 例如，如果行銷活動記錄的 [追蹤範本] 欄位開頭不是 http:// 或 https://、{lpurl} 或 {unescapedlpurl}，則此 [字段路徑] 值的值為 TrackingTemplate。 TrackingUrlTemplate 是活動管理服務可用之 Campaign 資料物件的元素。
| 類型 | 追蹤範本 | 錯誤 | Error Number | 欄位路徑 |
|---|---|---|---|---|
| 營銷活動錯誤 | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | InvalidUrlScheme | 4600 | TrackingTemplate |
| 營銷活動錯誤 | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | CampaignServiceInvalidUrl | 2611 | TrackingTemplate |
重要事項
[欄位路徑] 值可能會變更，因此您不應該相依於目前的字串格式。 所有錯誤都不支援 欄位路徑 。 其支援個別行銷活動、廣告群組、展開文字廣告、產品廣告、廣告群組產品分割區、關鍵詞和網站鏈接廣告延伸模塊記錄的 [行動最終 URL]、[最終 URL]、[追蹤範本] 和 [自定義參數] 字段。 此外，也支援 與註標廣告擴 充功能和檢 閱廣告擴 充功能記錄的所有字段相關的錯誤。
如果問題與編輯錯誤有關，則編輯 位置、 編輯字詞、 編輯原因代碼和 發行者國家/地區 數據行也可能包含有關錯誤的詳細資訊。