一般動態饋給 Dropbox 可讓你將多種動態饋給類型上傳至每個環境的單一 Dropbox。本指南將逐步說明如何使用一般 Dropbox,並提供各自動態饋給適用的連結。
(請參閱說明文件的匯出動態饋給 (端對端) 或動態饋給 (入門) 一節)。一般 Dropbox 仰賴兩種不同的上傳項目:
- 描述元檔案:說明您要上傳的動態饋給類型
- 動態饋給檔案:實際動態饋給的內容
建構描述元欄位
上傳描述元檔案,讓系統瞭解您上傳的動態饋給類型。這樣我們就能正確驗證和處理動態饋給。描述元檔案則應在動態饋給內容之前上傳,且必須遵守下列命名規定:
- 使用 .filesetdesc.json 副檔名
- 每個描述元檔案名稱不得重複,且不得在不同上傳作業中重複使用。建議您在檔案名稱中加入產生時間戳記。
- 範例:offer_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)。
- 範例:offer_1524606581_1.json
動態饋給檔案大小和上傳頻率
- 動態饋給檔案大小不得超過 200 MB (壓縮後)。
- 大多數整合都只需要使用一個資料分割。資料分割數量應越少使用越好。每個動態饋給最多只能有 1,000 個資料分割。
- 透過單一資料分割傳送的個別記錄,在日後的動態饋給中不需要傳送同一個資料分割編號。
- 為提升效能,請將資料平均分配給資料分割,讓所有資料分割檔案的大小都相似。
- 如有需要,請使用 gzip 壓縮動態饋給。但請分別為每個動態饋給資料分割完成這項操作。
疑難排解與偵錯
上傳檔案 (描述元和動態饋給檔案) 之後,請前往合作夥伴入口網站的「動態饋給記錄」資訊主頁 (說明文件),方法是依序前往「記錄」>「動態饋給」,追蹤動態饋給擷取進度。
在「動態饋給名稱」欄的描述元檔案中尋找已輸入的 name
,以便找出動態饋給。
擷取動態饋給後 (狀態為 Success
或 Fail
),只要按一下其列,即可查看錯誤和警告的詳細資料。