转化追踪

每次记录的点击都会获得一个简短且唯一的点击 ID。将其传给你的网站，在有人转化时回报，Letlink 就会把潜在客户、销售或注册归因到确切的链接、营销活动、国家和设备。

1. 将点击 ID 发送到你的网站

在链接上开启附加点击 ID。访问者到达目标网址时会带上 ?lk_click=…。你可以在转化设置中重命名该参数——许多联盟网络要求使用 subid 或 clickid。

或者自行在目标网址中放置令牌。{click_id} 会被替换为点击 ID（且不会额外附加参数），以下令牌同样可用：{slug}、{country}、{device}、{utm_source}、{utm_medium}、{utm_campaign}、{utm_term}、{utm_content}。

https://shop.example.com/offer?subid={click_id}&src={utm_source}&geo={country}

2a. 从浏览器上报转化

将代码片段添加到你网站的每个页面。它会把点击 ID 保存在第一方 Cookie 和本地存储中，并在你调用 letlink() 时上报转化。

<script>window.letlink=window.letlink||function(){(letlink.q=letlink.q||[]).push(arguments)};</script>
<script async src="https://letl.ink/t.js" data-param="lk_click"></script>

<!-- on the thank-you page -->
<script>
  letlink('sale', { value: 49.90, currency: 'USD', order_id: 'ORDER-123' });
</script>

事件包括 lead、sale、signup 和 custom（需带 event_name）。可选字段：value、currency（ISO 代码）、order_id、email（供 SendGrid 和 Mailchimp 集成使用）以及 metadata（包含少量额外字段的对象）。

2b. 服务器到服务器上报转化

商店、CRM 和联盟网络可以通过 GET 或 POST 调用回传 URL：

https://letl.ink/postback?click_id={click_id}&event=sale&amount=49.90&currency=USD&txid=ORDER-123

• 点击 ID：click_id、clickid、cid、subid、sub_id、aff_sub。
• 金额：amount、payout、value、revenue。负数金额表示退款。
• 交易：txid、transaction_id、order_id。
• 状态：approved（默认）、pending、declined 或 refunded。可先上报一笔待确认的销售，之后用相同的交易 ID 将其批准。
• 回传密钥：在转化设置中生成一个，并在每次回传中添加 key=…；未携带密钥的回传将被拒绝。

或使用你的 API 令牌调用 POST /api/v1/conversions（Growth 和 Ultimate）。

响应

回传和 API 始终返回 200，并附带 X-Letlink-Result 响应头：created、updated（已知交易的新状态）、duplicate、unknown_click、bad_key、outside_window、not_allowed（套餐限制）或 invalid。重试永远无济于事，因此联盟网络不应重试。

去重与归因

• 同一点击 ID、事件和交易 ID 的转化只计一次，以最先上报的渠道为准。
• 归因方式为最后点击：代码片段始终保留最近一次点击 ID。
• 转化只有在点击后的归因窗口内才会计入——默认 30 天，可在 1 到 365 天之间调整。

将转化发送到你的广告平台

在 Growth 和 Ultimate 上开启转发已批准的转化，即可将其作为购买、潜在客户和注册事件发送到 Meta、TikTok、LinkedIn、Pinterest、Snapchat 和 Reddit 的 Conversions API 以及你的分析集成，并与原始广告点击匹配。Google Tag Manager、Adobe Analytics、SendGrid 和 Mailchimp 始终会接收转化。