提取历史记录

通过操作中心内的数据提取 > 历史记录访问的数据提取查看器可近乎实时地显示住宿地点信息源的状态、验证健康状况和处理历史记录。

使用 Feed 注入查看器跟踪每日 Feed 上传情况、监控注入健康状况、检查商品级验证错误统计信息，以及验证 Feed 文件是否已到达。

概览

主“Feed 提取查看器”页面会按时间倒序显示 Google 收到的每个 POI Feed 的日志。

注入生命周期阶段

每次提交 Feed 都会按顺序经历以下处理阶段：

  1. 文件获取：Google 通过 SFTP 接收 Feed 文件。
  2. 文件验证：系统会验证文件完整性、解压缩和整体架构格式。
  3. 实体提取和验证：此流水线会解析各个住宿记录（poi_id、地址、坐标、本地化信息），并检查其语法、完整性和政策合规性。
  4. 对账和匹配：有效实体会传递到 Google 的匹配引擎，以与规范的 Google 地点 ID 相关联，从而用于投放。
  5. 报告生成：系统会将汇总指标和分组问题诊断信息发布到注入查看器。

如需查看 Feed 提取历史记录，请完成以下步骤：

  1. 登录操作中心。
  2. 打开提取 > 历史记录页面。
  3. 使用列控件过滤、排序和查看提取表。

提取列表列

主摘要表针对每次提取运行提供以下列：

列 数据类型 说明
ID 字符串 提取运行的唯一标识符。
提取时间（世界协调时间） 时间戳 Google 开始处理 Feed 提取的日期和时间（采用世界协调时间 [UTC]）。
提取类型 枚举 数据获取类型（例如 Feed）。
名称 字符串 Feed 提取类型的名称。这将是 google.lodging_vss。
状态 州 提取的总体处理状态（例如“完成”“失败”）。请参阅状态定义。
提取行为 枚举 所有住宿地点 POI Feed 均以“批处理”模式处理。
错误 整数 检测到的阻塞性错误级验证问题的总数。
警告 整数 检测到的非阻塞警告级问题的总数。
内容 整数 相应提取流程中处理的住宿房源总数。

状态定义

状态列会显示 Feed 提交的当前运行状态：

  • 完成：Feed 已成功提取、验证和处理，未出现严重错误。
  • 失败：提取过程中遇到严重的架构、文件损坏或流水线错误，无法完成。
  • 处理中：Google 正在积极验证、匹配和存储 Feed 数据。
  • 已跳过：Feed 上传已跳过（例如，如果生成时间戳早于之前经过处理的 Feed）。

提取详情视图

点击“提取查看器”表格中的任意行，即可打开提取详情视图。此视图提供全面的诊断卡片和展开面板，用于调试问题。

“详细信息”面板

“提取详细信息”页面分为四个可展开的部分：

1. 基本信息

显示有关执行运行的核心元数据：

  • 提取时间 (UTC)：Google 开始提取时的时间戳。
  • 注入类型：Feed。
  • 名称：google.lodging_vss
  • 注入行为：批量。
  • 状态：带颜色标识的状态标记（完成、失败、处理中、已跳过）。
  • 生成时间（世界协调时间 [UTC]）：合作伙伴生成 Feed 载荷时的时间戳（如果在 Feed 标头中声明）。

2. 验证

列出在注入期间遇到的所有验证结果：

  • 文件错误（标注框）：如果整个 Feed 文件失败（例如，由于归档文件无法读取或 JSON 语法格式错误），系统会显示一个醒目的警告标注，其中包含根本原因消息。
  • 实体问题（手风琴式折叠表）：按严重程度和错误代码分组的商品级验证问题。
    • 问题代码：特定错误标识符（例如 MISSING_REQUIRED_FIELD、INVALID_LATLNG 或 SAFE_SEARCH_POLICY_VIOLATION_IMAGE）。
    • 问题信息：说明根本原因和受影响字段的诊断说明。
    • 记录：受此问题影响的媒体资源实体的总数。
    • 点击任意问题行，即可展开示例实体 ID (poi_id)，其中包含可直接链接到商品目录视图以检查属性的链接。

3. 内容

为注入运行提供商品级媒体文件目录增量数据透视表：

  • 总数：处理的住宿房源总数。
  • 已添加：已添加到目录中的新发现的酒店房源数量。
  • 已更改：属性（例如名称、地址、坐标或图片）已更新的现有房源的数量。
  • 已移除：与上一个 Feed 基准相比，已舍弃或省略的房源数量。

4. 文件

显示已上传 Feed 文件的名称：

  • 文件名：Feed 文件的名称（例如 lodging_feed.json.gz）。

排查注入失败问题

在提取查看器中排查 Feed 问题时，请遵循以下准则：

问题 可能的原因 推荐措施
状态为“失败”，并显示“文件错误” ZIP/GZIP 归档文件损坏、JSON 语法格式有误或文件编码不受支持。 使用Feed 打包指南验证您的 Feed 是否已正确打包。
验证中的错误数量较多 记录中缺少必需的架构字段（例如 poi_id、结构化 location.address 或 WGS84 坐标）。 查看展开的验证手风琴式折叠，找出违规的 poi_id，更正地图注点 Feed 流水线，然后重新导入 Feed。在库存视图中检查各个实体的问题。
处理的商品数量为零 Feed 文件为空，或记录未能通过根级 JSON 数组解析。 检查您的 Feed 封装容器结构是否符合 VssPoi 消息规范。请参阅 Feed 打包指南。