使用通用的 Feed Dropbox

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

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

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

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

  1. 描述符文件:说明您将要采用的 Feed 类型 正在上传
  2. Feed 文件:实际 Feed 的内容
。 <ph type="x-smartling-placeholder">

构建描述符字段

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