使用一般動態饋給 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)。

• 例如：offer_1524606581_1.json

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

• 動態饋給檔案大小不得超過 200 MB (壓縮後大小)。
• 多數整合只需要使用一個資料分割。如果 資料數量越多越好每個動態饋給最多只能有 1000 個資料分割。
• 透過單一資料分割傳送的個別記錄，不需要在同一筆資料中傳送 資料分割編號。
• 為提高效能，請將資料平均分配給資料分割， 大小相近的資料分割檔案
• 如有需要，請使用 gzip 壓縮動態饋給。不過，請為每項 個別動態饋給資料分割

疑難排解與偵錯

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

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

動態饋給擷取後 (狀態為 Success 或 Fail)，即可按一下 來查看錯誤和警告的詳細資料。