使用一般動態饋給下拉式選單

一般動態饋給下拉式選單可將多種動態饋給類型上傳至單一環境單一 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 以找出動態饋給。

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