概要:Token可以帮助您强化数据安全。能让广告主通过AppsFlyer API获取数据,或使用服务器到服务器(S2S)的调用指令来接收事件数据。AF账户管理员可以在保障数据不中断的情况下管理多个token。Token管理包括API和S2S token的创建、重命名和移除等操作,具体取决于您的实际需求。
重要提示!
- 只有AppsFlyer账户的管理员才能查看和管理token。账户用户无法访问令牌页面。
- 请妥善保存好您的token,因为这关系到您的数据读取权限。切勿在公共代码库中发布这些token。
- 建议您每180天更换一次token。
AppsFlyer token简介
广告主需要使用Token才能通过AppsFlyer API以及S2S调用指令获取数据。对于AF账户管理员来说,token有以下几种用途:
- 推行数据安全措施:
- 为解决具体的数据安全隐患(如token被盗或疑似未授权访问)而更换token
- 作为数据安全政策例行更新的一环定期更换token
- 管理多个API的调用
- 在测试中使用
- 在特定功能中使用,如OneLink API
Tokens页面
- 从页面顶部导航栏打开账户菜单(点击右上角的邮箱地址,打开下拉菜单)> 安全中心。
- 向下滚动到AppsFlyer API token部分,点击管理您的AppsFlyer token。 界面会显示当前正在使用的token。
Token类型
我们针对各种不同的用途提供多种token。默认情况下,AF会为每个新账户生成一个API token(API token V2)。账户管理员最多可创建两个同一类型的token,详情请见下表。
| Token类型 | 用途 |
|---|---|
| API token | 用于对Pull API、Cohort API、ROI API等各种API的调用进行授权的JWT token(即JSON Web Token)。 |
| OneLink API(高阶付费) | 该token用于OneLink API,具有唯一性。OneLink API用于生成个性化链接,帮助您充分提升用户与应用的互动,适用于大规模广告投放。 |
| S2S token | 通过调用S2S API发送数据时使用。 |
| MCP token: | 用于验证第三方或自托管系统与 AppsFlyer MCP。 |
管理token
AppsFlyer账户管理员具有多个token的管理权限,包括token的创建、重命名、和移除,主要用于现行token换新。换新时需要先创建新token并将其部署到您的系统中,等到新token正式可用后将旧的token删除。
token的获取方式
- 从页面顶部导航栏打开账户菜单(点击右上角的邮箱地址,打开下拉菜单)> 安全中心。
- 向下滚动到AppsFlyer token部分,点击管理您的AppsFlyer token。
- 界面会显示可用token。
- 根据实际需要复制相关token。
token的创建方式
- 在Tokens页面中点击+新token。
- 输入token名称。
- 选择token类型。
- 单击创建token。
注意
- 新令牌立即可用。
- 请确保将新token部署到您的系统中
token的重命名方式
- 在Tokens页面中找到您想要重命名的token,然后点击该token的编辑图标。
- 重新命名该token。
- 点击保存。
token的删除方式
注意事项
- 删除某个token后,使用该token的系统可能会出现故障。
- 删除令牌时,它会从令牌页面中移除,之前的令牌的所有调用都会被拒绝。
- 如需更换token,请先创建一个新token并将其部署到您的系统中,等到新token正式变为可用状态后(即不再处于“处理中”的状态),才能删除旧的token。
- 在Tokens页面中找到您想要删除的token,然后点击该token的删除图标。
- 确认要删除该token时必须键入“Delete token”。
- 点击删除token。
API V2 token的使用方式
下表列出了广告主和广告平台的API V2 token使用场景:
广告主
| API V2 token |
|---|
| Pull API 原始数据报告 |
| Pull API汇总数据 |
| 获取应用列表 |
| 群组 |
| SKAN汇总报告 |
| 复制渠道对接设置 |
| 设置Install Referrer解密密钥 |
| 净收入 API |
| OpenDSR API |
| Master API |
| 导入受众API |
广告平台
| API V2 token |
|---|
| 广告平台的应用列表 |
| 与广告投放管理平台对接 |
| 对接渠道的Protect360报告 |
| InCost |
S2S token的使用方式
广告主和使用 S2S 令牌的广告主的用例:
广告主
| S2S token |
|---|
| 移动端应用内事件S2S API |
| 网络事件 S2S API |
广告平台
| S2S token |
|---|
| AppsFlyer预装referrer归因 |
注意
对于大多数广告网络,S2S 令牌生成不再是自助服务。因此,管理员在用户界面中不会看到生成 S2S 令牌的选项。自助令牌生成仅适用于特定的托管合作伙伴。
OneLink token的用途
广告主的OneLink API token使用场景包括:
MCP 令牌的申请
请参阅 AppsFlyer MCP 文章 以查看 MCP 令牌的可用用例。