归因转化和销售

转化是指 LinkHarbor 能归因到你页面上某次点击的销售或支持者付款。这样你不仅能看到某个链接被点击了多少次，还能看到带来了什么结果。本文面向拥有自己网店的创作者，以及负责对接网店的开发者。转化分析和创建回调密钥自 Creator Pro 起提供。

#转化从哪里来

• 你的网店或服务器通过销售回调上报的销售
• 通过 Stripe 收到的支持者付款；退款会再次移除该转化，参见通过 Stripe 收取支持者付款

每个转化都会继承所属点击的数据：页面、链接、国家、设备、来源网站和 UTM 参数。因此它在统计中出现的位置，正是那次点击的来源。

#归因如何运作

1. 访客点击你页面上的一个链接
2. LinkHarbor 记录这次点击，并在跳转时把带唯一点击 ID 的 lt_click_id 参数附加到目标网址
3. 你的目标页面（例如网店）从地址中读取 lt_click_id，并保存到购买完成
4. 购买完成后，你的服务器带着这个点击 ID 向 LinkHarbor 发送销售回调
5. 转化会出现在控制台和页面统计中

只有以 http:// 或 https:// 开头的目标才会附加点击 ID。指向 mailto: 或 tel: 的链接不会附加，因为参数会破坏邮件主题或电话号码。来自机器人的点击也不会获得点击 ID。

#创建回调密钥

销售回调必须用回调密钥来证明身份。所有者和管理员自 Creator Pro 起可以在菜单账户部分的“回调与 API”下管理密钥。

1. 打开“回调与 API”
2. 在“回调密钥”卡片中点击“+ 创建新密钥”
3. 可选：输入名称，例如“网店回调”
4. 点击“创建密钥”
5. 立即复制密钥：它只显示一次

“编辑”

修改名称和状态（已启用或未启用）。未启用的密钥会被拒绝。

“↺ 轮换”

创建一个新密钥。旧密钥会立即失效，所以请马上把新密钥填入你的网店。

“删除”

确认后删除该密钥。

“最后回调：”

显示该密钥最后一次被使用的时间，否则显示“尚未使用”。

每个工作区最多可以创建 5 个回调密钥。

#发送销售回调

你的服务器向 LinkHarbor API 发送 POST 请求。密钥放在 X-Callback-Secret 请求头中。

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

必填。来自 lt_click_id 的点击 ID（10–36 个字符）。

order_id

必填。你的订单号（1–128 个字符）。每个订单号只计一次转化，所以重复的回调不会产生第二个转化。

amount

必填。以小数表示的金额。

currency

必填。3 个字母的货币代码，例如 EUR。

occurred_at, meta

可选。购买时间，以及最多 50 个自定义键（每个 1–64 个字符），用于附加信息。值可以是最多 500 个字符的文本、数字、true/false 或 null；API 会拒绝嵌套对象。

响应

面向开发者的全部字段和错误代码见向 LinkHarbor 发送销售和自有数据。

#分析转化

• 控制台：“转化”和“转化率”卡片，以及按 UTM 来源和媒介显示的“转化”卡片
• 页面统计：带“总转化率”“独立转化率”和“细分”的“转化”卡片
• 总转化率 = 转化除以点击量；独立转化率 = 转化除以独立点击量