通用動態饋給安全檔案傳輸通訊協定伺服器可讓您將多種動態饋給類型上傳至每個環境的單一安全檔案傳輸通訊協定伺服器。本指南將逐步說明如何使用一般安全檔案傳輸通訊協定伺服器，並提供相關指南的連結，方便您瞭解如何使用計畫中的動態饋給。
(請參閱說明文件的「匯出動態饋給 (端對端)」或「動態饋給 (入門)」一節)。通用安全檔案傳輸通訊協定伺服器需要分別上傳兩項內容：
- 描述元檔案：說明要上傳的動態饋給類型
- 動態饋給檔案：實際動態饋給的內容
描述元欄位的結構
上傳描述元檔案可讓系統瞭解你要上傳的動態饋給類型。這樣我們才能正確驗證及處理動態饋給。描述元檔案應先於動態饋給內容上傳，且必須符合下列命名規定：
- 描述元檔案必須使用
.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"
]
}建構動態饋給內容
上傳描述元檔案後，請上傳所有動態饋給檔案，這些檔案的動態饋給資料類型應與描述元檔案命名的動態饋給設定檔相符。檔案名稱和路徑位置 (SFTP 伺服器內的相對位置) 必須與 data_file 欄位中包含的內容完全一致。如果缺少任何檔案、檔案名稱不正確，或是上傳至其他位置，系統就不會處理整個動態消息。
這些動態饋給資料檔案的內容必須符合描述元檔案中指定動態饋給的相關規格。
每個動態饋給檔案名稱不得重複，且無法重複用於多個上傳作業。建議在檔案名稱中加入生成時間戳記和分片編號 (流水號)。
- 範例：offers_1524606581_1.json
動態饋給檔案大小和上傳頻率
- 動態饋給檔案大小不超過 200 MB (壓縮後大小)。
- 每個解壓縮後的資料檔案大小不得超過 2 GB。
- 大多數整合功能只需要使用單一分片。您應盡可能使用最少的分片。每個動態饋給最多只能有 1000 個資料分片。
- 已透過單一資料分片傳送的個別記錄，在日後的動態饋給中不需要再透過同一個資料分片傳送。
- 為提升效能，請將資料平均分配給資料分片，讓所有資料分片檔案的大小都相似。
- 可視需要使用 gzip 壓縮動態饋給，但請為每個動態饋給資料分片分別進行這項作業。
疑難排解與偵錯
上傳檔案 (描述元和動態饋給檔案) 後，請前往合作夥伴入口網站的擷取檢視器 (說明文件) (依序前往「擷取」>「記錄」)，追蹤動態饋給擷取進度。
在「動態饋給名稱」欄中，尋找您在描述元檔案中輸入的 name，找出動態饋給。
動態饋給擷取完畢 (狀態為 Success 或 Fail) 後，按一下該列即可查看錯誤和警告的詳細資料。