概览:使用 Token 有助于提高数据安全性。用户可通过 AppsFlyer API 访问数据,或通过服务器到服务器调用接收事件数据。管理员可以管理多个 Token,同时保持数据连续性。包括根据需要创建、重命名和移除 API Token 及服务器到服务器 Token。
重要提示!
- 只有管理员才能查看和管理 Token。账户用户无权访问 Token 页面。
- 请妥善保存好您的token,因为这关系到您的数据读取权限。请勿在公共代码库中发布 Token。
- 建议每 180 天重置一次 Token。
AppsFlyer Token 简介
广告主需要使用 Token 才能通过 AppsFlyer API 以及 S2S 调用指令获取数据。管理员可将 Token 用于以下用途:
- 安全措施:
- 更换 Token,以应对 Token 泄露或疑似未授权访问等特定安全问题
- 根据常规安全策略,定期更换 Token
- 管理不同的 API 调用
- 用于测试
- 用于特定功能,例如 OneLink API
访问 Token 页面
- 在顶部栏中,打开账户菜单(email 地址下拉菜单)> 安全中心。
- 在 AppsFlyer API Token 部分,点击 管理您的 AppsFlyer API Token。 页面会显示当前的 Token。
Token 类型
不同类型的 Token 用途各异。默认情况下,每个新账户都会生成一个 API Token(API token V2)。管理员最多可为每种类型创建两个 Token,详情请见下表。
| Token 类型 | 用途 |
|---|---|
| API token | 一种 JWT Token(JSON Web Token),用于授权 Pull API、Cohort API、ROI API 等 API 调用。 |
| OneLink API(高级) | 一种用于 OneLink API 的专用 Token。OneLink API 可用于生成个性化链接,以在大规模广告活动中实现最优的用户互动效果。 |
| S2S token | 通过调用 S2S API 发送数据时使用。 |
| MCP token | 用于通过 AppsFlyer MCP 验证第三方或自托管系统的身份。 |
注意
如果您要对接的功能需要专用的 API V2 Token(例如高级安全模块),且您已达到两个 Token 的上限,则可以重新利用现有的 API V2 Token,而不必申请新的 Token;同一个 Token 可用于多种用途。
管理 Token
管理员可以管理多个 Token:创建、重命名和移除 Token。这主要用于以新 Token 替换现有 Token。操作时,请先创建新 Token 并将其部署到您的系统中,待新 Token 可用后,再删除旧 Token。
获取 Token
- 在顶部栏中,打开账户菜单(email 地址下拉菜单)> 安全中心。
- 在 AppsFlyer API tokens 部分,点击 管理您的 AppsFlyer API tokens。
- 界面会显示可用 Token。
- 复制所需的 Token。
创建 Token
- 在 Tokens 页面中,点击 + New token。
- 输入 Token 名称。
- 选择 Token 类型。
- 点击 创建 Token。
注意
- API V2 Token 在创建后会立即激活。
- S2S、OneLink 和其他类型的 Token 最多可能需要 30 分钟才能变为活跃状态。
- 激活完成前,Token 状态为待处理。
- 请在 Token 状态变为活跃后使用该 Token。
- 请确保将新 Token 部署到您的系统中。
删除 Token
重要提示
- 删除 Token 后,依赖该 Token 的系统可能会出现故障。
- 删除 Token 后,该 Token 会从 Tokens 页面移除,并且使用原 Token 发起的所有调用都会被拒绝。
- 如需更换 Token,请先创建新 Token 并将其部署到系统中。待新 Token 可用(即不再处于“待处理”状态)后,才能删除旧 Token。
- 在 Tokens 页面中,点击要删除的 Token 对应的删除图标。
- 输入「删除 token」以确认删除该 Token。
- 点击删除 Token。
API V2 Token 的应用场景
广告主和广告平台使用 API V2 Token 的应用场景:
广告主
| API V2 Token |
|---|
| Pull API 原始数据报告 |
| Pull API 汇总数据 |
| 获取应用列表 |
| 群组分析 |
| SKAN 汇总报告 |
| 复制渠道对接设置 |
| 设置安装 referrer 解密密钥 |
| 净收入 API |
| OpenDSR API |
| Master API |
| 导入受众 API |
| 高级安全模块对接(Android) |
广告平台
| API V2 token |
|---|
| 广告平台的应用列表 |
| 与广告投放管理平台对接 |
| 对接合作伙伴的 Protect360 报告 |
| InCost |
S2S token 的用途
下表列出了广告主使用 S2S token 的场景:
广告主
| S2S token |
|---|
| 移动端应用内事件S2S API |
| 网页事件 S2S API |
广告平台
| S2S token |
|---|
| AppsFlyer 预装 referrer 归因 |
注意
大多数广告平台已无法自行生成 S2S token。因此,管理员在界面中看不到生成 S2S token 的选项。只有特定的托管渠道支持自行生成 S2S token。
OneLink token 的用途
广告主使用 OneLink API token 的场景包括:
创建、获取、更新和删除带有自定义参数的 OneLink 短链。
MCP Token 的使用方式
如需了解 MCP Token 的可用使用场景,请参阅AppsFlyer MCP 文章。