磁力参数获取指南（纯小白版）
本系统要填 3 个磁力参数：advertiser_id、app_id、app_secret，
然后再拿一次 auth_code 换 Token。照着下面一步一步做即可。
一、先搞懂这几个参数是什么
| 系统里的字段 |
通俗解释 |
去哪拿 |
磁力广告主 advertiser_id |
你投放广告那个账户的数字 ID（不是快手个人号） |
磁力智投投放后台 |
磁力开放平台 app_id |
你在开放平台创建的「应用」编号 |
磁力引擎开放平台 → 应用管理 |
磁力开放平台 app_secret |
这个应用的密钥（密码），创建时发一次，请保存 |
同上，创建应用成功后显示 |
auth_code（授权码） |
广告主同意授权后，浏览器地址栏里出现的一串码 |
打开授权链接 → 同意 → 从跳转网址里复制 |
重要区别：
你已经知道的「快手小游戏 ks_app_id」是游戏的 ID；
上面这些是投流 / 报表接口用的，要在磁力侧另外拿。
二、怎么获取 advertiser_id（广告主 ID）
必做你已经开了磁力智投后台，按下面找：
-
1
用浏览器打开磁力智投投放后台：
https://ad.e.kuaishou.com/
-
2
登录你刚开通的广告主账号（一般是快手账号 / 投放账号体系）。
-
3
进入后找以下任一位置（不同版本文案可能略有差异）：
- 右上角账户名称 / 头像旁边或下拉里的「账户信息」
- 左侧菜单「账户」「账户管理」「财务管理」相关页面
- 页面顶部账户切换处，常会显示「广告主 ID」或一串纯数字
-
4
看到类似
1234567890 这种纯数字，就是 advertiser_id。
把它复制下来，后面填到本系统。
注意：
不要填快手个人主页号、不要填小游戏 ks_app_id。
advertiser_id 一定是投放后台里的广告主账户 ID（数字）。
如果页面上找不到，直接问对接你的快手销售 / 运营要「广告主 ID」。
三、怎么开通磁力开放平台（开发者）
没有这一步，就拿不到 app_id / app_secret。
-
1
打开磁力引擎开放平台：
https://developers.e.kuaishou.com/
-
2
点击右上角类似「登录 / 注册为开发者」。
-
3
注册角色一般选 广告主（你自己投放自己的账户时选这个）。
-
4
按页面要求填写：
- 联系人信息
- 企业资质 / 营业执照等（按审核要求上传）
- 广告主账户 ID：可填你刚拿到的
advertiser_id
-
5
提交后等待审核（常见是若干个工作日）。审核通过才能进「应用管理」。
如果你完全不会填资质材料，把本页发给销售，让销售协助开通「磁力开放平台开发者」。
很多客户第一回都是销售带着开的。
四、创建应用，拿到 app_id 和 app_secret
开发者审核通过后：
-
1
登录开放平台 → 进入 应用管理 → 点击 添加应用。
-
2
填写内容（小白就这样填）：
| 字段 | 怎么填 |
|---|
| 应用名称 |
随便写，方便自己认，例如：eCPM监控 |
| 应用图标 |
有就传，没有按页面要求传一张占位图即可 |
| 回调地址（Redirect URI） |
用来接收授权后的跳转。推荐先写本机：
http://127.0.0.1:8181/
如果系统部署在服务器，也可写：
http://你的服务器IP:8181/
（端口以你实际启动端口为准，你当前配置是 8181）
|
-
3
保存成功后，页面会显示：
- app_id
- secret（就是系统里的
app_secret）
- 以及一条 授权链接
-
4
立刻把 app_id、secret、授权链接复制保存到记事本。
secret 有时只展示一次，丢了可能要重置或重建应用。
到这里，系统表单里的三个字段你都齐了：
advertiser_id + app_id + app_secret。
先去本系统「游戏管理」保存游戏配置。
五、怎么获取 auth_code（最关键，照做）
必做一次
只有 app_id / secret 不能自动生成 auth_code。
必须用浏览器点一次授权。
步骤
-
1
打开你保存的授权链接（在开放平台应用详情里）。
-
2
用能登录广告主账号的浏览器打开，按提示登录。
-
3
选择授权方式（二选一，按销售建议即可）：
- 基于广告账户授权：勾选要对的广告账户
- 基于用户授权：该快手号下全部广告账户
然后点「同意 / 授权」。
-
4
授权成功后，浏览器会跳到你填的回调地址，地址栏大概长这样：
http://127.0.0.1:8181/?auth_code=一长串字符&其它参数=...
-
5
用鼠标选中
auth_code= 后面那一串，一直选到下一个 & 之前
（如果没有 &，就选到结尾）。
复制下来。
-
6
马上去本系统粘贴换 Token（见下一节）。
auth_code 大约只有 10 分钟有效，而且通常只能用 1 次。
小白技巧：
就算跳转后页面打不开（本机没跑服务也没关系），
只要地址栏里有 auth_code，就能复制使用。
如果你回调地址填的是 127.0.0.1，
就必须在你自己电脑的浏览器里完成授权，
这样跳转才会回到你电脑，你才能看见并复制。
六、怎么填进本监控系统
- 打开本系统并登录（默认超管：
admin / admin）。
- 左侧菜单点 游戏管理 → 新增游戏 或编辑已有游戏。
- 填写：
- 游戏名称：你自己认得就行
- 快手小游戏 ks_app_id：你已经有的
- 磁力广告主 advertiser_id：第二节拿到的数字
- 磁力开放平台 app_id / app_secret：第四节拿到的
- 启用状态：启用
- 点保存。
- 再进入该游戏的编辑页，找到「磁力授权（access_token）」区域。
- 把刚复制的
auth_code 粘贴进去，点 换取 / 更新 Token。
- 看到「授权成功，access_token 已缓存」就对了。
成功后：平时查 eCPM，系统会尽量自动用 refresh_token 刷新，
一般不用天天重新拿 auth_code。
若过很久（大约 30 天 refresh 也失效）或重复授权导致旧 token 失效，再做一次第五节即可。
七、还要找销售开白名单
很容易漏
就算 Token 换成功了，如果广告账户没开通 ecpm_report 接口白名单，
拉数据时仍会报错 / 无权限。
请直接联系你的快手销售 / 运营说：
「请帮我把广告主账户（advertiser_id：________）开通
快小游实时 eCPM 报表接口 ecpm_report 白名单。」
官方说明可参考：
八、常见问题（小白必看）
Q1：能不能只用 app_secret 自动拿到 auth_code？
不能。
必须浏览器授权一次。secret 只能用来「换 Token / 刷新 Token」，不能代替广告主点同意。
Q2：回调地址可以写 127.0.0.1 吗？
可以，专门用来从地址栏复制 auth_code 很方便。
但开放平台填的回调地址，必须和实际跳转完全一致。
Q3：授权后地址栏没有 auth_code？
- 回调地址是否填错（多空格、端口不对、http/https 不一致）
- 是否授权失败又回到了别的页面
- 重新走一遍授权（重新获取新的授权机会）
Q4：提示 access_token 错误？
常见原因是广告主重复授权导致旧 token 失效。
重新拿一个新的 auth_code，再到系统里重新换 Token。
Q5：我按顺序做完，第一次建议检查清单
- □ advertiser_id 已从投放后台拿到（纯数字）
- □ 开放平台开发者已审核通过
- □ 应用已创建，app_id / app_secret 已保存
- □ 本系统游戏配置已保存
- □ 已授权并成功换取 Token
- □ 销售已开通 ecpm_report 白名单
- □ 在「数据获取」里选游戏 + 日期试查一次
一张图记住全流程
- 磁力智投后台 → 拿
advertiser_id
- 开放平台注册开发者 → 审核通过
- 创建应用 → 拿
app_id、app_secret、授权链接
- 本系统保存游戏配置
- 浏览器打开授权链接 → 复制
auth_code → 系统换 Token
- 找销售开 ecpm_report 白名单
- 去「数据获取」查询 eCPM