10. 数据测量、GSC、诊断与实验 · 资料陈述 · 教学步骤 3
接好GSC与站内行为数据
GSC回答搜索侧，站内事件回答用户进入后做了什么。
原知识点：用 GA 观察访问和行为，用 GSC 观察查询、曝光、点击与索引，再按结果迭代。
执行步骤
- 在Search Console添加并验证正确域名资源，提交sitemap并记录生效日期。
- 为任务开始、成功、失败、注册、checkout开始与purchase定义互斥触发和必要参数。
- 用GA4推荐事件优先；自定义事件写清名称、URL、匿名用户/会话键和版本。
- 在开发环境与DebugView逐个触发，核对只触发一次、参数正确，过滤内部和自动测试流量。
- 记录GSC与站内数据的日期、URL规范化和时区差异，建立可连接的日级表。
可复制工作表
# 数据源与连接口径 GSC资源/验证方式：__ 生产协议/域名：__ sitemap URL/提交与生效日期：__ GSC完整日期/时区：__ 站内事件时区：__ canonical与重定向映射版本：__ 机器人/员工/测试过滤：__ # 事件字典（每个事件复制一行） |事件名/版本|页面/服务|唯一触发条件|成功结果|失败边界|必要参数与类型|去重/幂等键|最终事实来源|开发环境预期|DebugView/网络实际|状态| |---|---|---|---|---|---|---|---|---|---|---| |task_start/task_complete/task_fail/sign_up/begin_checkout/purchase/refund|__|__|__|__|__|__|浏览器/服务端/支付后台__|__|__|通过/失败__| # 搜索—行为连接 GSC原始粒度：date + query + page + country + device 查询诊断表（不得连接站内事件）：__ GSC连接表：先将page归一为canonical URL，再按canonical URL+完整日期+country+device分组并SUM impressions/clicks；视图/SQL：__ 站内连接表：先按canonical URL+event_date+country+device聚合事件；视图/SQL：__ 最终连接粒度：canonical URL + 完整日期 + country + device 日期维表与UTC半开窗口（含DST）：__ 未匹配行处理：__ 禁止事项：query不得携带或回填站内指标；不得把GSC推断到anonymous_id/cohort_id 测试记录/截图/查询路径：__ 负责人/复查日：__
完整示例
示例（数字非通用阈值）：
GSC资源：域名资源example.test，以DNS TXT验证；生产为https://example.test；sitemap=https://example.test/sitemap.xml，2026-07-01提交并记录首次读取日。GSC按America/Los_Angeles完整日期导出，站内仓库使用UTC；canonical映射版本url-map-v4。过滤employee=true、test_account=true、已知监控UA与重复request_id。
列较多时可左右滚动；首列会固定，便于逐行比较。
| 事件名/版本 | 页面/服务 | 唯一触发条件 | 成功结果 | 失败边界 | 必要参数与类型 | 去重键 | 最终事实来源 | 开发预期 | 实际 | 状态 |
|---|---|---|---|---|---|---|---|---|---|---|
| task_start/v2 | /tool | 服务端接受生成请求 | 创建job | 前端点击但请求被拒不记 | request_id:string, canonical_url:string, cohort_id:string | request_id | 应用后端 | 一次请求记一次 | 重复点击仅1条 | 通过 |
| task_complete/v2 | worker | 文件生成且可下载 | artifact状态ready | 超时或空文件记task_fail | request_id, duration_ms:number, artifact_id:string | request_id+event | 应用后端 | ready后一次 | DebugView参数/次数正确 | 通过 |
| task_fail/v1 | worker | job进入终态failed | 保存error_code | 可重试中间态不记终态失败 | request_id, error_code:string | request_id+terminal_state | 应用后端 | 失败一次 | 注入超时后一次 | 通过 |
| begin_checkout/v1 | /pricing | 后端创建checkout session | 返回provider_session_id | 按钮点击但创建失败不记 | anonymous_id, plan_id, provider_session_id | provider_session_id | 应用后端 | 创建成功一次 | 网络请求一次 | 通过 |
| purchase/v1 | webhook | 签名有效且订单paid | 权益已写入 | 前端success页、测试事件或未结算订单不记 | order_id, amount:number, currency:string, cohort_id | order_id | 支付后台Webhook | 重放三次仍一单 | 数据表仅1条 | 通过 |
| refund/v1 | webhook | 退款进入succeeded | 订单净入账回冲 | 申请中不记最终退款 | order_id, refund_amount:number | refund_id | 支付后台Webhook | 成功退款一次 | 回冲金额正确 | 通过 |
GSC原始导出gsc_query_raw保留date/query/page/country/device/impressions/clicks，只用于查询诊断；它绝不直接连接站内事件。先将page经url-map-v4归一为canonical_url，再生成gsc_page_day：按date+canonical_url+country+device分组并SUM(impressions)、SUM(clicks)，确保同一页面当天的多个query只剩一行。站内事件另生成onsite_page_day：按event_date+canonical_url+country+device聚合。最终只在这两个聚合视图上LEFT JOIN；例如同页同日10条query先合成1行，再连接1行站内完成数，不会把完成数复制10次。
GSC不提供anonymous_id或cohort_id，绝不把查询/点击归到个人或内部cohort；内部cohort只在站内漏斗另表分析，也不回填到query。日期维表date_dim将America/Los_Angeles当地[00:00,次日00:00)转换为对应UTC半开窗口并处理夏令时；维度不兼容或未匹配行保留并进入url-map/口径队列。测试证据在qa/events-v2/join-reconciliation.sql与join-10-query-fixture.csv；负责人=数据负责人，2026-08-08复查。
完成清单
- GSC资源覆盖生产协议和域名，sitemap与发布日期有记录。
- 每个核心事件有触发、成功/失败边界和去重规则。
- DebugView或网络请求证明事件与参数按预期发送一次。
- 测试、机器人和内部流量有明确过滤；支付以后端确认事件为准。
当前官方依据
平台规则会变化，行动前以打开后的当前官方页面为准。
适用条件
需正确埋点、足够观察期并过滤测试流量。
来源：idoubi：独立出海，如何提升单兵作战能力