一般動態饋給 dropbox 可讓您將多種動態饋給類型上傳到每個環境的單一 dropbox。本指南將逐步說明如何使用一般 Dropbox，並提供您打算使用的動態饋給對應指南的連結。
(請參閱說明文件的「匯出動態饋給 (端對端)」或「動態饋給 (入門)」一節)。一般動態饋給 dropbox 需要兩個獨立的上傳內容：
- 描述元檔案：說明要上傳的動態饋給類型
- 動態饋給檔案：實際動態饋給的內容
描述元欄位的結構
上傳描述元檔案，可讓系統瞭解你上傳的是哪種動態饋給類型。這可讓我們正確驗證及處理動態饋給。描述檔案應在上傳動態饋給內容之前，且必須遵守下列命名規定：
- 您必須使用
.filesetdesc.json副檔名為描述元檔案命名。 - 每個描述元檔案名稱都必須不重複，且不得在不同上傳作業中重複使用。建議您在檔案名稱中加入產生時間戳記和動態饋給名稱。
- 範例：offers_1524606581.filesetdesc.json
- 每個描述元檔案都必須列出最新動態饋給中與相關動態饋給名稱對應的所有資料檔案。
message FilesetDescriptor {
// The timestamp at which this feed was generated, in Unix time format
// (seconds since the epoch). (required)
int64 generation_timestamp = 1;
// Identifies the name of this feed. (required)
string name = 2;
// Paths (relative to the dropbox root) specifying data files included in this
// feed. (required)
repeated string data_file = 3;
}name 欄位的可能值包括：
以下是含有兩個切面的商品動態饋給 JSON 描述檔範例：
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}建構動態饋給內容
上傳描述元檔案後，請為描述元檔案所命名的動態饋給設定檔，上傳對應的動態饋給資料類型所需的所有動態饋給檔案。檔案名稱和路徑位置 (相對於 Dropbox 中的相對位置) 必須與 data_file 欄位中的內容完全一致。如果缺少任何檔案、檔案名稱不正確，或上傳至其他位置，系統就不會處理整個動態饋給。
這些動態饋給資料檔案的內容必須符合描述檔案中指定的動態饋給相關規格。
每個動態饋給檔案名稱不得重複，也無法重複用於多個上傳項目。建議您在檔案名稱中加入產生時間戳記和分割區編號 (遞增 ID)。
- 範例：offers_1524606581_1.json
動態饋給檔案大小和上傳頻率
- 動態饋給檔案大小不超過 200 MB (壓縮後大小)。
- 每個解壓縮資料檔案的大小不得超過 2 GB。
- 大多數整合作業只需要使用單一分割區。您應盡可能少用分割區。每個動態饋給最多傳送 1,000 個資料分片。
- 已透過單一資料分片傳送的個別記錄，在日後的動態饋給中不需要再透過同一個資料分片傳送。
- 為提升效能，請將資料平均分配給資料分片，讓所有資料分片檔案的大小都相似。
- 可視需要使用 gzip 壓縮動態饋給，但請為每個動態饋給資料分片分別進行這項作業。
疑難排解與偵錯
上傳檔案 (描述元和動態饋給檔案) 後，請前往合作夥伴入口網站的動態饋給記錄資訊主頁 (說明文件) (依序前往「記錄」>「動態饋給」)，查看動態饋給擷取進度。
在「動態饋給名稱」欄中，找出您在描述檔中輸入的 name，即可找到動態饋給。
動態饋給擷取完成後 (狀態為 Success 或 Fail)，您可以按一下該列，查看錯誤和警告的詳細資料。