# OKMT AI 流量归因接入说明

更新日期：2026-09-18

## 统计口径

报告统一使用“可归因 >= N”的口径，不外推。

原因：AI App、浏览器隐私设置、跳转链路和 App 内浏览器经常不会传递 referrer，因此日志和 GA4 能看到的是“可被识别出来的最小数量”，不是全部 AI 流量。

## 已接入内容

1. 官网已加载 `assets/js/attribution.js`。
2. 用户点击淘宝或天猫链接时，会触发 `outbound_taobao_click` 转化事件。
3. 转化事件会请求 `/__okmt_attribution.txt`，并把来源快照写入 URL 参数。
4. 如果页面中已经安装 GA4 的 `gtag`，同一次点击也会发送 GA4 事件。

## 来源快照字段

| 字段 | 含义 |
| --- | --- |
| event | 事件名，例如 `outbound_taobao_click` |
| source_type | 来源类型，包含 `ai_engine`、`attributable_other`、`direct_or_unavailable` |
| ai_engine | 识别到的 AI 引擎，例如 `chatgpt`、`doubao`、`deepseek` |
| referrer_host | 来源域名 |
| utm_source | UTM 来源 |
| utm_medium | UTM 媒介 |
| utm_campaign | UTM 活动 |
| landing | 首次落地页 |
| current | 当前页 |
| target_host | 点击目标域名 |
| target_path | 点击目标路径 |
| ts | 事件时间 |

## 服务器日志统计

统计所有淘宝转化点击：

```bash
sudo zgrep -h "__okmt_attribution.txt" /var/log/nginx/access.log* | wc -l
```

统计可归因到 AI 引擎的淘宝转化点击：

```bash
sudo zgrep -h "__okmt_attribution.txt" /var/log/nginx/access.log* | grep -E "source_type=ai_engine|ai_engine=[a-z]" | wc -l
```

查看最近 20 条归因日志：

```bash
sudo zgrep -h "__okmt_attribution.txt" /var/log/nginx/access.log* | tail -20
```

报告写法示例：

```text
截至 2026-09-18，官网日志中可归因到 AI 引擎的淘宝转化点击 >= N 次。该数字为可观测下界，不代表全部 AI 来源转化。
```

## GA4 渠道组

GeoLook 已生成 `work/okmtstudio/assets/attribution/ga4-channel.txt`。

在 GA4 中新建渠道组时，渠道名称建议使用：

```text
AI 引擎
```

匹配条件使用：

```text
来源 / Source
匹配正则
```

正则内容复制 `ga4-channel.txt`。

## GA4 转化事件

如果后续安装 GA4，建议把事件设为关键事件：

```text
outbound_taobao_click
```

该事件表示用户从官网点击进入淘宝或天猫链接。