入门 Feed(旧版)

您需要先创建自己的 Feed,然后由 Google 对其进行评估。

创建 Feed

  1. 生成 Feed。大多数商品目录数据都可通过 Feed 传输到 Google。请先创建两种 Feed:

    • 商家 Feed:商家 Feed 对商家进行介绍并提供商家级操作链接。
    • 服务 Feed(可选):服务 Feed 对服务进行介绍并提供商家向您的平台提供的服务级 action_link

    必填字段和建议填写的字段

    Feed 字段名称 说明 是否必填?
    商家 merchant_id 商家的唯一标识符
    商家 name 商家名称
    商家 geo 商家的地址和地理坐标
    商家 电话 商家的电话
    商家 类别 商家的地点类型 建议填写
    商家 action_link 商家专用深层链接的相关信息 如果提供了服务 Feed,则此参数为可选;否则为必需
    商家 brand_id 用于标识要使用的面向消费者的品牌的字符串 可选
    服务 service_id 商家所提供服务的唯一标识符 是(仅当提供服务 Feed 时)
    服务 merchant_id 指向提供此服务的商家的链接 是(仅当提供服务 Feed 时)
    服务 localized_service_name 所提供服务的名称 是(仅当提供服务 Feed 时)
    服务 localized_description 可供用户查看的服务说明 可选
    服务 action_link 提供与服务相关的深层链接的信息 是(仅当提供服务 Feed 时)
    服务 类型 深层链接的类型(例如 SERVICE_TYPE_DINING_RESERVATION) 是(仅当提供服务 Feed 时)

    首先,请查看示例 Feed

    如果提供多项服务的商家使用单个操作链接,则应在商家 Feed 中提供适用于所有服务的单个操作链接。

    如需详细了解如何在旧版入门集成 Feed 中指定操作链接,请点击此处

    在每个 Feed 中添加 Feed 元数据,以便 Google 知道如何解析相应 Feed。

    以下是一个 Feed 元数据代码段:

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
  2. 导出 Feed。使用 Protocol Buffer 3 语法描述 Feed 格式,但您可以参考上面提到的示例来查看 JSON 格式。 我们建议您以 JSON 格式上传 Feed。

    如果您真的想继续使用 pb3 格式,请参阅协议缓冲区基础知识:Java,了解如何使用协议缓冲区生成 pb3 文件的一般信息。

  3. 将 Feed 上传到 SFTP Dropbox。如需上传您的 Feed,请使用 Google 为您提供的 SFTP Dropbox 信息以及您在设置中创建的私钥。您可通过端口 19321 上的 sftp://partnerupload.google.com 访问 Google SFTP 服务器。

    请上传名称唯一的文件,例如包含时间戳的名称。使用唯一名称有助于排查问题以及查询 Feed 状态。

    如需确定 Feed 的大小和提交频率,请遵循以下指南:

    • Feed 文件和分片的大小:
      • 确保 Feed 文件小于 200MB(压缩后)。使用 gzip 压缩它们
      • 如果文件可能超过 200MB(压缩后),请按照 对 Feed 文件进行分片 教程将其拆分为多个分片。不过,仅旧版入门版集成不太可能达到 200MB 的上限。
    • 完整更新的频率:
      • 每天提供一次完整的商家 Feed。
      • (如果已实现)每天提供一次完整的服务 Feed。

Google 对 Feed 进行评估

Google 会在您上传 Feed 后对 Feed 进行处理并评估其质量和完整性。我们会考虑以下几个因素:

  • Feed 符合相关规范。
  • Feed 包含所有必填字段。
  • 每个商家至少定义了一项 action_link,或者至少定义了一项包含 action_link 的服务。
  • 您的大多数商家数据都与 Google 地图上的营业地点信息相匹配。