使用一般動態饋給 dropbox

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

警告：本指南不適用於商家、服務、 或可用性 Dropbox這項設定僅適用於一般 Dropbox。

注意：凡是要申請的動態饋給類型，都必須經過核准 上傳。如果您上傳的動態饋給類型未獲核准 系統就不會處理動態饋給如果不確定哪項動態饋給 可採用適用於您的整合方案的類型，請與 Actions Center 聯絡 聯絡。

，瞭解如何調查及移除這項存取權。

警告：你可能需要重設 SSH 金鑰，才能將檔案上傳至一般動態饋給 Dropbox。請參閱 合作夥伴入口網站動態饋給設定 (說明文件)。

一般 Dropbox 需要兩個不同的上傳：

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

，瞭解如何調查及移除這項存取權。

注意：如果上傳資料至一般 Dropbox 時未看到任何 合作夥伴入口網站上的對應項目，這可能代表你的描述元 檔案未上傳或檔案名稱不正確。如需協助偵錯 問題，請聯絡 Actions Center 聯絡人。

建構描述元欄位

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

• 使用 .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 欄位可能的值包括：

• reservewithgoogle.conversion_data

如果是具有兩個資料分割的商品動態饋給，以下是 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)，即可按一下 來查看錯誤和警告的詳細資料。