Signup Tracking 用于在用户注册成功后通知 Affitor，使该注册能够被关联到引荐的联盟伙伴，从而完成联盟归因。
用途 该技能解决的是联盟营销中的注册归因问题：当用户通过某个联盟伙伴的链接进入并完成注册后，需要把这次注册与对应的联盟伙伴绑定。Signup Tracking 提供了浏览器端和服务端两种上报途径。
主要能力
- 浏览器端上报：在注册成功后调用 window.affitor.signup(user.id, user.email)，前提是页面已加载 tracker 脚本。
- npm SDK 方式：通过 @affitor/tracker 的 loadAffitor 加载后调用 signup()。
- 服务端上报：通过 Lead API 发送 POST 请求到 https://api.affitor.com/api/v1/track/lead，携带 customer_key、email 和 click_id。
- 提供 Node.js 与 Python 的调用示例。
- 提供测试命令：npx affitor test lead。
使用方式 浏览器端（需 tracker 脚本）： await window.affitor.signup(user.id, user.email);
使用 npm SDK： import { loadAffitor } from '@affitor/tracker'; const affitor = await loadAffitor('YOUR_PROGRAM_ID'); await affitor?.signup(user.id, user.email);
服务端 Lead API： POST https://api.affitor.com/api/v1/track/lead Authorization: Bearer YOUR_PROGRAM_API_KEY Content-Type: application/json
请求体： { "customer_key": "user_123", "email": "user@example.com", "click_id": "from_affitor_click_id_cookie" }
Node.js 示例：
await fetch('https://api.affitor.com/api/v1/track/lead', {
method: 'POST',
headers: {
'Authorization': Bearer ${process.env.AFFITOR_API_KEY},
'Content-Type': 'application/json',
},
body: JSON.stringify({
customer_key: newUser.id,
email: newUser.email,
click_id: req.cookies.affitor_click_id,
}),
});
Python 示例： requests.post( 'https://api.affitor.com/api/v1/track/lead', headers={ 'Authorization': f'Bearer {AFFITOR_API_KEY}', 'Content-Type': 'application/json', }, json={ 'customer_key': str(new_user.id), 'email': new_user.email, 'click_id': request.cookies.get('affitor_click_id'), }, )
规则
- 必须至少提供 click_id 或 customer_key 之一。
- customer_key 必须是你的内部用户 ID，并在后续的销售追踪中复用。
- 当页面已加载 tracker 时，浏览器端的 signup() 是最简单的方式。
测试 npx affitor test lead
适用场景 适用于需要将用户注册行为归因到联盟伙伴的网站或应用，尤其是已经接入 Affitor 联盟追踪体系的场景。
限制 资料未说明该技能的具体收费、价格、支持平台范围或效果数据，这些信息暂未提供。