使用通用的 Feed Dropbox

通用 Feed Dropbox 支持将多种类型的 Feed 上传到 每个环境只有一个 Dropbox。本指南将介绍如何使用 通用 Dropbox，并提供指向各个 您计划使用的 Feed

通用 Dropbox 依赖于两项单独的上传操作：

1. 描述符文件：说明您将要采用的 Feed 类型 正在上传
2. Feed 文件：实际 Feed 的内容

构建描述符字段

该描述符文件已上传，用于告知系统您属于哪种 Feed 类型 正在上传。这样，我们才能正确验证和处理 Feed。通过 描述符文件应在 Feed 内容之前上传，并且必须遵循 以下命名要求：

• 使用 .filesetdesc.json 文件扩展名
• 每个描述符文件名都必须是唯一的，并且不能在上传间重复使用。周三 建议在文件名中添加生成时间戳。
  • 示例：offers_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 字段的可取值包括：

下面是一个包含两个分片的优惠 Feed 的 JSON 描述符文件示例： 包括：

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

构建 Feed 内容

上传描述符文件后，还要上传所有 Feed 文件 对应 Feed 配置文件所对应的 Feed 数据类型， 描述符文件。文件名和路径位置（在 Dropbox）必须与 data_file 字段。如果缺少任何文件、文件名称不正确或 上传到其他位置，则整个 Feed 将无法 处理。

这些 Feed 数据文件的内容必须符合 在描述符文件中指定的 Feed。

每个 Feed 文件名都必须是唯一的，并且不能在不同上传中重复使用。我们建议 包括生成时间戳和文件名中的分片编号（增量 ID）。

• 示例：offers_1524606581_1.json

Feed 文件大小和上传频率

• 将 Feed 文件大小保持在 200 MB 以下（压缩后）。
• 大多数集成只需要使用一个分片。您应该使用 尽量减少分片数量。每个 Feed 最多包含 1000 个分片。
• 在一个分片中发送的各条记录不需要在同一分片中发送 分片数。
• 为了获得更好的性能，请在分片之间平均拆分数据， 大小相似的分片文件。
• 如有必要，请使用 gzip 压缩 Feed。不过，对于每个 单个 Feed 分片。

问题排查和调试

上传文件（描述符和 Feed 文件）后，请前往 “Feed 历史记录”信息中心 （文档） （依次转到历史记录 > Feed），以了解 Feed 提取的进度。

在“Feed 名称”中的描述符文件中查找 name列中查找您的 Feed。

提取 Feed 后（状态为 Success 或 Fail），您可以点击 以查看错误和警告的详细信息。