Ingestion Viewer

通过操作中心内的数据提取 > 历史记录访问数据提取查看器，即可近乎实时地查看本地兴趣点 Feed 的状态、验证健康状况和处理历史记录。

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

概览

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

注入生命周期阶段

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

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

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

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

提取列表列

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

列 数据类型 说明
ID String 提取运行的唯一标识符。
提取时间 (UTC) Timestamp Google 开始处理 Feed 提取的日期和时间（采用世界协调时间 [UTC]）。
提取类型 Enum 数据采集类型（例如 Feed）。
名称 String Feed 提取类型的名称。此值将为 google.local_vss。
状态 State 提取的总体处理状态（例如“完成”“失败”）。请参阅状态定义。
提取行为 Enum 所有本地 POI Feed 均以 Batch 模式处理。
错误 Integer 检测到的阻塞性错误级验证问题的总数。
警告 Integer 检测到的非阻塞警告级问题的总数。
内容 Integer 相应提取流程中处理的本地房源总数。

状态定义

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

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

提取详情视图

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

“详细信息”面板

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

1. 基本信息

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

  • 提取时间 (UTC)：Google 开始提取的时间戳。
  • 注入类型： Feed。
  • 名称：google.local_vss
  • 提取行为： Batch
  • 状态：带有颜色编码的状态徽章（Done、Failed、Processing、Skipped）。

2. 验证

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

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

3. 内容

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

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

4. 文件

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

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

排查注入失败问题

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

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