使用一般動態饋給 dropbox

一般動態饋給 Dropbox 可讓您將多個動態饋給類型上傳至 每個環境一個 Dropbox。本指南將逐步說明如何使用 通用 Dropbox,並提供相關指南的相應連結 要使用的動態饋給

(請參閱說明文件的「匯出動態饋給 (端對端)」或「動態饋給 (入門)」一節)。

一般動態饋給 dropbox 需要兩個獨立的上傳內容:

  1. 描述元檔案:說明動態饋給類型 上傳中
  2. 動態饋給檔案:實際動態饋給的內容

描述元欄位的結構

再上傳描述元檔案,讓系統知道您是哪一種動態饋給類型 正在上傳...這可讓我們正確驗證及處理動態饋給。 描述元檔案應在動態饋給內容之前上傳,且必須遵循 命名要求:

  • 您必須為描述元檔案使用 .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)。

  • 範例:offers_1524606581_1.json

動態饋給檔案大小和上傳頻率

  • 動態饋給檔案大小不超過 200 MB (壓縮後大小)。
  • 每個解壓縮資料檔案大小不得超過 2 GB。
  • 大多數整合作業只需要使用單一分片。您應盡可能少使用分割區。每個動態饋給最多傳送 1,000 個資料分片。
  • 透過單一資料分割傳送的個別記錄,不需要在同一筆資料中傳送 資料分割編號。
  • 為提升效能,請將資料平均分配給資料分片,讓所有資料分片檔案的大小都相似。
  • 如有需要,請使用 gzip 壓縮動態饋給。不過,請為每項 個別動態饋給資料分割

疑難排解與偵錯

上傳檔案 (描述元和動態饋給檔案) 後,請前往 動態饋給記錄資訊主頁 (說明文件) 的「訂單」頁面 (依序前往「記錄」>「動態饋給」),即可追蹤動態饋給擷取進度。

在「動態饋給名稱」的描述元檔案中尋找您輸入的 name以尋找動態饋給。

動態饋給擷取完成後 (狀態為 SuccessFail),您可以按一下該列,查看錯誤和警告的詳細資料。