---
title: "推广点击跟踪 SDK 接入"
id: "584"
type: "docs"
slug: "sdk"
published_at: "2026-01-07T06:19:28+00:00"
modified_at: "2026-08-19T09:55:08+00:00"
url: "https://www.partnershare.net/help/api/sdk"
markdown_url: "https://www.partnershare.net/help/api/sdk.md"
excerpt: "该 SDK 用于在落地页自动保存推广归因参数、透传来源参数，并在满足条件时自动回传点击信息，减少接入方手动处理 […]"
taxonomy_doc_category:
- "技术集成"
---
## 快速入门
5
- [什么是推荐营销/老带新计划](https://www.partnershare.net/help/start-guides/referral-marketing)
- [什么是联盟营销](https://www.partnershare.net/help/start-guides/affiliate-marketing)
- [如何创建推荐计划](https://www.partnershare.net/help/start-guides/add-referral-marketing)
- [如何创建联盟营销活动](https://www.partnershare.net/help/start-guides/add-affiliate-marketing)
- [如何提升推广效果](https://www.partnershare.net/help/start-guides/improving-promotion-effectiveness)
## 推广运营
5
- [活动管理](https://www.partnershare.net/help/promoters/%e6%b4%bb%e5%8a%a8%e7%ae%a1%e7%90%86)
- [产品管理](https://www.partnershare.net/help/promoters/%e4%ba%a7%e5%93%81%e7%ae%a1%e7%90%86)
- [推广者管理](https://www.partnershare.net/help/promoters/data)
- [合作伙伴支持的提现方式](https://www.partnershare.net/help/promoters/withdrawal-methods)
- [查询合作伙伴提现状态](https://www.partnershare.net/help/promoters/withdrawal-status)
## 支付与交易
2
- [佣金结算](https://www.partnershare.net/help/payment/commission)
- [提现托管功能](https://www.partnershare.net/help/payment/auto-payouts)
## 账户管理
2
- [团队管理功能](https://www.partnershare.net/help/team/%e5%9b%a2%e9%98%9f%e7%ae%a1%e7%90%86%e5%8a%9f%e8%83%bd)
- [企业认证提示](https://www.partnershare.net/help/team/certification)
## 技术集成
5
- [API 鉴权与签名机制](https://www.partnershare.net/help/api/signature)
- [推广点击跟踪 SDK 接入](https://www.partnershare.net/help/api/sdk)
- [推广转化事件回传](https://www.partnershare.net/help/api/event-report)
- [将 PartnerShare 内嵌到产品中](https://www.partnershare.net/help/api/iframe)
- [PartnerShare 产品授权推广登录接入指南](https://www.partnershare.net/help/api/partnershare-integration)
## 常见问题
2
- [旧版帮助中心入口](https://www.partnershare.net/help/faq/%e6%97%a7%e7%89%88%e5%b8%ae%e5%8a%a9%e4%b8%ad%e5%bf%83%e5%85%a5%e5%8f%a3)
- [提现相关](https://www.partnershare.net/help/faq/withdrawal)
## 更新日志
2
- [更新日志 – 2026.05.15](https://www.partnershare.net/help/update/%e6%9b%b4%e6%96%b0%e6%97%a5%e5%bf%97-2025-05-15)
- [更新日志-2026.03.05](https://www.partnershare.net/help/update/update2026-3-5)
View Categories
该 SDK 用于在落地页自动保存推广归因参数、透传来源参数，并在满足条件时自动回传点击信息，减少接入方手动处理 URL 参数、Cookie 和跳转链路的成本。
### 1. SDK 能力概览 [#](#sdk-overview)
**保存归因参数**自动识别 URL 中的 `ps_click_id` 与 `ps_ref` 并写入 Cookie。
**透传链接参数**自动把当前页面中的归因参数追加到页面内的跳转链接，减少链路丢参。
**自动上报点击**当 URL 中带有 `ps_token` 时，页面加载后会自动请求点击上报接口。
### 2. 接入方式 [#](#sdk-install)
请将以下脚本放在你的落地页或站点公共模板中，建议放在页面底部或公共布局中统一引入。
```
```
SDK 加载后会自动执行，无需额外初始化即可完成 Cookie 写入、参数透传和自动上报逻辑。
### 3. 自动处理流程 [#](#sdk-flow)
**第 1 步**读取当前页面 URL 参数。
**第 2 步**将 `ps_click_id` 与 `ps_ref` 写入 Cookie。
**第 3 步**监听页面内 `` 链接点击，自动把归因参数继续拼接到跳转链接中。
**第 4 步**当 URL 中存在 `ps_token` 时，页面加载后自动请求点击上报接口。
### 4. 参数说明 [#](#sdk-params)
#### 4.1 核心归因参数 [#](#sdk-core-params)
| 参数名 | 来源 | 作用 | 说明 |
| --- | --- | --- | --- |
| ps_click_id | PartnerShare 跳转链接 | 点击归因 | 点击追踪 ID，用于标识一次具体点击，优先用于后续注册、付费等事件归因 |
| ps_ref | PartnerShare 跳转链接 | 邀请码归因 | 推广邀请码，用于在无法拿到点击 ID 的场景下补充归因链路 |
#### 4.2 自动上报参数 [#](#sdk-auto-report)
| 参数名 | 作用 | 是否自动写入 Cookie | 说明 |
| --- | --- | --- | --- |
| ps_token | 触发自动点击上报 | 否 | 当页面 URL 中存在该参数时，SDK 会在页面加载后自动请求点击上报接口 |
### 5. Cookie 约定 [#](#sdk-cookie)
| Cookie 名 | 说明 |
| --- | --- |
| ps_click_id | 保存点击归因 ID，便于注册或事件回传时读取 |
| ps_ref | 保存邀请码归因信息，便于落地页或后续事件上报时读取 |
SDK 默认以 `path=/`、`SameSite=Lax` 写入 Cookie。若页面运行在标准 HTTPS 环境，浏览器会按当前规则处理安全属性。
### 6. 极简链路图 [#](#sdk-link-diagram)
1**推广链接访问**用户从 PartnerShare 推广链接进入你的落地页。
landing page
2**SDK 捕获参数**页面加载后自动读取 URL 中的归因参数。
ps_click_idps_ref
3**保存并透传**归因参数写入 Cookie，并自动追加到站内跳转链接。
Cookielink append
4**业务转化读取**注册、付费等关键节点读取归因参数并提交到业务后端。
registerpayment
5**事件回传**业务后端通过事件上报接口把转化结果回传给 PartnerShare。
conversion API
### 7. 推荐接入方式 [#](#sdk-best-practice)
推荐将 SDK 部署在所有推广落地页、注册页以及关键跳转页面中，这样可以最大程度保证 `ps_click_id` 和 `ps_ref` 不丢失。
如果你的页面会跳转到注册页、支付页或其他站内页面，请确保这些页面的链接是通过标准 `` 标签跳转，SDK 才能自动完成参数透传。
### 8. 如何在业务代码中读取归因参数 [#](#sdk-read-cookie)
品牌方服务端在上报注册或付费事件前，通常需要先从前端 Cookie 中读取归因参数并提交到自己的后端。
```
function getCookie(name) {
const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
return match ? decodeURIComponent(match[2]) : '';
}
const clickId = getCookie('ps_click_id');
const inviteCode = getCookie('ps_ref');
console.log({ clickId, inviteCode });
```
### 9. 常见注意事项 [#](#sdk-notes)
SDK 只会自动透传当前 URL 中存在的 `ps_click_id` 与 `ps_ref`，不会自动补全其他自定义参数。
自动点击上报依赖 URL 中的 `ps_token`；如果页面没有该参数，SDK 不会主动请求点击上报接口。
如果你的页面跳转是通过前端路由、按钮脚本或异步逻辑完成，建议在对应逻辑中手动读取 Cookie 并补齐参数，不要完全依赖原生链接监听。
后续注册、付费等转化事件，请配合《事件上报》接口一起使用，才能完成完整的归因、奖励和结算闭环。
更新 19/08/2026
###### 分享这篇文章 ：
- 
- [https://www.facebook.com/sharer/sharer.php?u=https://www.partnershare.net/help/api/sdk](https://www.facebook.com/sharer/sharer.php?u=https://www.partnershare.net/help/api/sdk)
- [https://twitter.com/intent/tweet?url=https://www.partnershare.net/help/api/sdk](https://twitter.com/intent/tweet?url=https://www.partnershare.net/help/api/sdk)
- [https://www.linkedin.com/shareArticle?mini=true&url=https://www.partnershare.net/help/api/sdk](https://www.linkedin.com/shareArticle?mini=true&url=https://www.partnershare.net/help/api/sdk)
- [https://pinterest.com/pin/create/button/?url=https://www.partnershare.net/help/api/sdk](https://pinterest.com/pin/create/button/?url=https://www.partnershare.net/help/api/sdk)
[推广转化事件回传](https://www.partnershare.net/help/api/event-report)
[PartnerShare 产品授权推广登录接入指南](https://www.partnershare.net/help/api/partnershare-integration)
大纲 - [1. SDK 能力概览](#sdk-overview)
- [2. 接入方式](#sdk-install)
- [3. 自动处理流程](#sdk-flow)
- [4. 参数说明](#sdk-params)
- [4.1 核心归因参数](#sdk-core-params)
- [4.2 自动上报参数](#sdk-auto-report)
- [5. Cookie 约定](#sdk-cookie)
- [6. 极简链路图](#sdk-link-diagram)
- [7. 推荐接入方式](#sdk-best-practice)
- [8. 如何在业务代码中读取归因参数](#sdk-read-cookie)
- [9. 常见注意事项](#sdk-notes)