概要：トークンは、データのセキュリティを高めるために使用します。ユーザーがAppsFlyer API経由でデータにアクセスしたり、サーバー間通信でイベントデータを受信したりする際に使用します。管理者は、データの送受信を中断せずに、複数のトークンを管理できます。必要に応じて、APIトークンやサーバー間トークンの作成、名前の変更、削除を行えます。
重要
- トークンの確認と管理を行えるのは、管理者のみです。一般のアカウントユーザーは、［トークン］ページにアクセスできません。
- トークンはデータへのアクセスを可能にするため、安全に保管してください。公開コードリポジトリにトークンを掲載しないでください。
- 180日ごとにトークンを切り替えることを推奨します。
AppsFlyerトークンについて
トークンは、AppsFlyer APIやS2Sの呼び出しで、ユーザーがデータにアクセスできるようにするために使用します。管理者は、さまざまな目的でトークンを使用します。
- セキュリティ対策：
- トークンの漏洩や不正アクセスの疑いなど、特定のセキュリティ上の問題に対応するための切り替え
- 定期的なセキュリティポリシーの更新に合わせた、トークンの切り替え
- 異なるAPI呼び出しの管理
- テスト
- OneLink APIなど、特定機能での利用
トークンページを開く
- 上部のバーでアカウントメニュー（メールアドレスのドロップダウン）を開き、［セキュリティセンター］を選択します。
- ［AppsFlyer APIトークン］セクションで、［AppsFlyer APIトークンを管理］をクリックします。 現在のトークンが表示されます。
トークンの種類
用途に応じて、さまざまな種類のトークンがあります。新しいアカウントには、デフォルトでAPIトークン（APIトークンV2）が生成されます。管理者は、以下の表に示す種類ごとに、最大2個のトークンを作成できます。
| トークンの種類 | 用途 |
|---|---|
| APIトークン | Pull API、Cohort API、ROI APIなどのAPI呼び出しを認可する、JWT（JSON Web Token）形式のトークン。 |
| OneLink API（有料機能） | 大規模なキャンペーンでユーザーエンゲージメントを最適化するため、ユーザーに合わせたリンクを生成するOneLink API専用のトークン。 |
| S2Sトークン | サーバー間通信でデータを送信するために使用します。 |
| MCPトークン | サードパーティのシステムや自社運用のシステムを、AppsFlyer MCPで認証するために使用します。 |
注意
Advanced Security Moduleなど、専用のAPI V2トークンを必要とする機能を連携する際に、すでに上限の2個に達している場合は、新規発行を依頼する代わりに既存のAPI V2トークンを再利用できます。同じトークンを複数の用途に使用できます。
トークンの管理
管理者は、複数のトークンの作成、名前の変更、削除を行えます。主な用途は、現在のトークンから新しいトークンへの切り替えです。先に新しいトークンを作成して自社システムに設定し、利用可能になってから古いトークンを削除します。
トークンの取得
- 上部のバーでアカウントメニュー（メールアドレスのドロップダウン）を開き、［セキュリティセンター］を選択します。
- ［AppsFlyer APIトークン］セクションで、［AppsFlyer APIトークンを管理］をクリックします。
- 利用可能なトークンが表示されます。
- 必要なトークンをコピーします。
トークンの作成
- ［トークン］ページで、［＋新しいトークン］をクリックします。
- トークン名を入力します。
- トークンの種類を選択します。
- ［トークンを作成］をクリックします。
注意
- API V2トークンは、作成直後に有効になります。
- S2S、OneLink、そのほかの種類のトークンは、有効になるまで最大30分かかることがあります。
- 有効化が完了するまで、トークンのステータスは［有効化待ち］になります。
- ステータスが［有効］に変わってから、トークンを使用してください。
- 新しいトークンを、必ず自社システムに設定してください。
トークンの削除
警告
- トークンを削除すると、そのトークンを使用するシステムに障害が発生することがあります。
- 削除したトークンは［トークン］ページから消え、そのトークンによる呼び出しはすべて拒否されます。
- トークンを切り替える場合は、先に新しいトークンを作成してシステムに設定し、有効化待ちではなく利用可能な状態になったことを確認してから、古いトークンを削除してください。
- ［トークン］ページで、削除するトークンの削除アイコンをクリックします。
- 削除の確認として「Delete token」と入力する必要があります。
- ［トークンを削除］をクリックします。
API V2トークンの用途
広告主とアドネットワークの、API V2トークンの用途は次のとおりです。
広告主
アドネットワーク
S2Sトークンの用途
広告主とアドネットワーク向けのS2Sトークンの用途は、次のとおりです。
広告主
| S2Sトークン |
|---|
| モバイルのアプリ内イベント用S2S API |
| Webイベント用S2S API |
アドネットワーク
| S2Sトークン |
|---|
| AppsFlyerのプリロードリファラによるアトリビューション |
注意
ほとんどのアドネットワークでは、管理画面からS2Sトークンを生成することはできなくなっています。そのため、管理者の画面にはS2Sトークンの生成オプションが表示されません。管理画面からトークンを生成できるのは、個別に管理されている一部のパートナーのみです。
OneLinkトークンの用途
広告主向けのOneLink APIトークンの用途は、次のとおりです。
パラメータをカスタマイズしたOneLink短縮URLの作成、取得、更新、削除。
MCPトークンの用途
MCPトークンの用途は、AppsFlyer MCPの記事を参照してください。