我们能为您提供什么帮助?

AppsFlyer Token 管理

  • 更新

概览:使用 Token 有助于提高数据安全性。用户可通过 AppsFlyer API 访问数据,或通过服务器到服务器调用接收事件数据。管理员可以管理多个 Token,同时保持数据连续性。包括根据需要创建、重命名和移除 API Token 及服务器到服务器 Token。

重要提示!

AppsFlyerAdmin_us-en.png

  • 只有管理员才能查看和管理 Token。账户用户无权访问 Token 页面。
  • 请妥善保存好您的token,因为这关系到您的数据读取权限。请勿在公共代码库中发布 Token。
  • 建议每 180 天重置一次 Token。

AppsFlyer Token 简介

广告主需要使用 Token 才能通过 AppsFlyer API 以及 S2S 调用指令获取数据。管理员可将 Token 用于以下用途:

  • 安全措施:
    • 更换 Token,以应对 Token 泄露或疑似未授权访问等特定安全问题
    • 根据常规安全策略,定期更换 Token
  • 管理不同的 API 调用
  • 用于测试
  • 用于特定功能,例如 OneLink API

访问 Token 页面

  1. 在顶部栏中,打开账户菜单(email 地址下拉菜单)> 安全中心。
  2. 在 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

  1. 在顶部栏中,打开账户菜单(email 地址下拉菜单)> 安全中心。
  2. 在 AppsFlyer API tokens 部分,点击 管理您的 AppsFlyer API tokens。
  3. 界面会显示可用 Token。
  4. 复制所需的 Token。

创建 Token

  1. 在 Tokens 页面中,点击 + New token。
  2. 输入 Token 名称。
  3. 选择 Token 类型。
  4. 点击 创建 Token。

注意

  • API V2 Token 在创建后会立即激活。 
  • S2S、OneLink 和其他类型的 Token 最多可能需要 30 分钟才能变为活跃状态。 
    • 激活完成前,Token 状态为待处理。 
    • 请在 Token 状态变为活跃后使用该 Token。 
  • 请确保将新 Token 部署到您的系统中。

删除 Token

重要提示

  • 删除 Token 后,依赖该 Token 的系统可能会出现故障。
  • 删除 Token 后,该 Token 会从 Tokens 页面移除,并且使用原 Token 发起的所有调用都会被拒绝。
  • 如需更换 Token,请先创建新 Token 并将其部署到系统中。待新 Token 可用(即不再处于“待处理”状态)后,才能删除旧 Token。
  1. 在 Tokens 页面中,点击要删除的 Token 对应的删除图标。
  2. 输入「删除 token」以确认删除该 Token。
  3. 点击删除 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 文章。