使用通用的 Feed Dropbox

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

<ph type="x-smartling-placeholder">

</ph> 警告：本指南不适用于商家、服务 或可用性 Dropbox。仅适用于通用 Dropbox。

。 （请参阅 在该文档的导出 Feed（端到端）或 Feed（入门版）部分）。

<ph type="x-smartling-placeholder">

</ph> 注意：对于要启用的每种 Feed 类型，您都必须获得批准 上传。如果您上传的 Feed 类型未获准用于您的 集成，系统将不会处理该 Feed。如果您不确定哪个 Feed 请与你的操作中心联系 联系。

。 <ph type="x-smartling-placeholder">

</ph> 警告：您可能需要重置 SSH 密钥才能上传到通用 Feed Dropbox。为此，请参阅 <ph type="x-smartling-placeholder"></ph> 合作伙伴门户 Feed 配置 （文档）。

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

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

。 <ph type="x-smartling-placeholder">

</ph> 注意：如果您向通用 Dropbox 上传了文件，但没有看到任何文件 相应条目，这可能表示您填写的 文件未上传或文件名称不正确。如需调试方面的帮助，请按以下步骤操作： 请与您的操作中心联系人联系。

构建描述符字段

该描述符文件已上传，用于告知系统您属于哪种 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），您可以点击 以查看错误和警告的详细信息。