通用 Feed Dropbox 支持将多种类型的 Feed 上传到 每个环境只有一个 Dropbox。本指南将介绍如何使用 通用 Dropbox,并提供指向各个 您计划使用的 Feed
<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">。 <ph type="x-smartling-placeholder">通用 Dropbox 依赖于两项单独的上传操作:
- 描述符文件:说明您将要采用的 Feed 类型 正在上传
- 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
字段的可取值包括:
- reservewithgoogle.conversion_data
下面是一个包含两个分片的优惠 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
),您可以点击
以查看错误和警告的详细信息。