DEVELOPER DOCUMENTATION

接入 GEO 驾驶舱

根据事件可信度选择浏览器 Tag 或服务端 Webhook;内容 Agent 使用短链 API。三种入口最终都按项目进入同一套来源分析。

三步开始

管理员先在项目下配置固定跳转规则,然后创建带归因维度的短链。

  1. 1

    选择项目在驾驶舱进入 wdcloud 或 demo。

  2. 2

    配置规则保存允许域名下的固定目标 URL。

  3. 3

    选择接入安装 Tag、接收 Webhook,或让 Agent 创建短链。

CLIENT-SIDE

GEO Tag

全站安装一段 JavaScript,验证短链归因、写入第一方 Cookie,并采集页面和交互事件。

  • 无需客户保存密钥
  • 精确 Origin 白名单
  • 自动更新、源码可审查
接入文档查看源码
SERVER-SIDE

Webhook

客户后端使用共享密钥生成 HMAC 签名,回传注册、充值和支付等业务事件。

  • 通过 click_id 关联来源
  • 时间戳防重放
  • 事件 ID 幂等
接入文档OpenAPI 3.1
AGENT API

短链 API

自动写作或发布 Agent 使用独立 Bearer 密钥,在已有项目规则下生成静态归因短链。

  • Idempotency-Key 防重复
  • 内部维度不传给目标
  • 可指定或自动生成 slug
接口文档OpenAPI 3.1

TRUST BOUNDARY

Tag 与 Webhook 如何选择

页面浏览、按钮点击使用 GEO Tag

接入轻、自动更新,但浏览器事件可能被拦截或客户端伪造。

注册、支付、退款使用 Webhook

由客户后端签名发送,适合可信业务状态和分润核对。

更多参考

管理后台Tag 交互测试站统一事件目录服务发现 JSON