1.创建产品 #
进入品牌主管理后台，点击【创建第一个产品】
2.创建产品 #
2.1完成基础配置 #
上传产品logo、名称，行业等基础信息进入下一步
- LOGO：上传产品logo
- 产品名称：输入产品名称
- 所属行业：选择产品所在行业
- 结算币种：目前仅支持美元结算
- 主题色：选择产品主题色，建议跟产品内保持一致，以确保内嵌效果
- 官方网址：输入官网
- 推广URL：推广地址是访客通过 “推荐链接” 访问的地址，比如用户A在产品内看到的专属推荐链接为：https://www.partnershare.net/12345，这里的www.partnershare.net就是推广地址
- 产品描述：输入产品描述
2.2完成奖励规则设置 #
目前我们支持配置三种类型
- 注册奖励：被推广者注册产品后，推广者获得奖励
- 交易分成：被推广者注册产品且完成付费后（如购买产品、充值），推广者完成奖励
- 自定义事件：自定义回传事件，实现个性化的奖励玩法
2.3设置追踪集成 #
1.将追踪代码放到用于推广的网页html代码<header>中，代码会自动跟踪通过推荐链接访问的访客，并自动上报点击事件
- 当访客通过推荐链接打开你的网站的时候，跟踪脚本会自动上报你的网站的点击事件
- 同时会自动在你的网站下添加如下两个Cookie
- ps_click_id (受邀用户点击ID): 当受邀人点击推荐链接的时候会根据一定算法生成唯一的访客ID
- ps_ref（邀请码）：推荐人邀请码
这些Cookie的值可用于未来的注册事件和付费事件进行跟踪
2.点击验证代码安装按钮，我们会检测是否设置成功
2.4API对接 #
根据开发文档，完成数据回传
HTML
https://api-service.partnershare.net/接口信息 #
域名:https://api-service.partnershare.net/
路径: POST /api/open/v1/track/conversion
描述: 品牌主系统调用此接口上报转化事件（注册、付费等）
鉴权: API Key + API Secret + 签名 查看如何进行API鉴权
请求参数 #
归因参数（二选一）
| 参数名 | 类型 | 必填 | 说明 |
| click_id | string | 条件必填 | 受邀用户点击ID、PartnerShare根据这个ID关联到具体推广渠道和合作伙伴 |
| invite_code | string | 条件必填 | 推荐人邀请码 |
说明：
- click_id：即通过【6.添加追踪代码】获取到的ps_click_id
- invite_code：即通过【6.添加追踪代码】获取到的ps_ref
- 根据活动情况，选择其一回传即可
事件类型参数（二选一）
| 参数名 | 类型 | 必填 | 说明 |
| event_type | integer | 条件必填 | 事件类型：1=注册, 2=付费, 3=自定义事件 |
| event_name | string | 条件必填 | 事件名称：signup、purchase 或自定义名称 |
说明：
- 根据活动情况，选择其一回传即可
用户信息参数
| 参数名 | 类型 | 必填 | 说明 |
| invited_user_id | string | 条件必填 | 受邀用户ID（品牌主系统内的用户ID） |
| invited_user_name | string | 否 | 受邀用户名称 |
说明：
- 注册事件：invited_user_id 必填
- 付费/自定义事件：如果提供了 click_id，可以不传 invited_user_id，系统会从注册事件中同步用户信息
交易信息参数（付费事件）
| 参数名 | 类型 | 必填 | 说明 |
| transaction_id | string | 否 | 交易ID（用于去重，识别该笔交易方便追溯） |
| conversion_value | string/float | 条件必填 | 转化价值（订单金额，按比例奖励时必填） |
| currency | string | 否 | 货币代码（默认：USD） |
| transaction_cycle_count | integer | 否 | 交易周期数（分期奖励时使用，如：12） |
说明：
- 如果奖励规则是按比例计算，conversion_value 必填
- transaction_id 用于去重，强烈建议提供以避免重复奖励
- transaction_cycle_count 用于分期奖励，如果奖励规则设置了分期但未配置分期数，会使用此值
错误码说明
| 错误码 | 说明 |
| 0 | 成功 |
| 6000000 | 业务错误（具体错误信息见 message） |
| 401 | 鉴权失败（API Key无效、签名错误、时间戳过期等） |
| 403 | IP不在白名单中 |
3.开始推广 #
测试通过后，推荐计划生效
通过将推荐页面内嵌至产品或官网，可避免外部跳转，帮助推广员在同一页面内完成绑定、邀请与返现流程，从而降低操作成本并提升转化效率。
