概要:トークンを使用することで、データのセキュリティを強化できます。トークンを使用すると、AppsFlyer API経由でデータへアクセスしたり、サーバー間(S2S)通信でイベントデータを受信したりできます。管理者は、データの継続性を維持しながら複数のトークンを管理できます。必要に応じて、APIトークンやS2Sトークンの作成、名前変更、削除が可能です。
重要
- トークンを表示・管理できるのは管理者のみです。一般のアカウントユーザーは、トークンページへアクセスできません。
- トークンはデータへのアクセスを可能にするため、安全に保管してください。トークンを公開コードリポジトリに掲載しないでください。
- トークンは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トークン | サーバー間(S2S)通信でデータを送信するために使用します。 |
| MCPトークン | サードパーティまたはセルフホスト環境のシステムをAppsFlyer MCPで認証するために使用します。 |
注意
専用のAPI V2トークンを必要とする機能(例:Advanced Security Module)を連携する際、すでに2トークンの上限に達している場合は、新しいトークンを要求せず、既存のAPI V2トークンを再利用できます。同じトークンを複数のユースケースで利用できます。
トークンの管理
管理者は、複数のトークンを作成、名前変更、削除して管理できます。主な用途は、現在使用しているトークンを新しいトークンへ置き換えることです。まず新しいトークンを作成してシステムへ実装し、利用可能になったことを確認してから古いトークンを削除します。
トークンの確認
- 上部バーから、アカウントメニュー(メールアドレスのドロップダウン)を開き、セキュリティセンターを選択します。
- AppsFlyer APIトークンセクションで、AppsFlyer APIトークンを管理をクリックします。
- 利用可能なトークンが表示されます。
- 必要なトークンをコピーします。
トークンの作成
- トークンページで、+新しいトークンをクリックします。
- トークン名を入力します。
- トークンの種類を選択します。
- トークンを作成をクリックします。
注意
- API V2トークンは、作成後すぐに有効になります。
- S2S、OneLinkなどその他の種類のトークンは、有効になるまで最大30分かかる場合があります。
- 有効化が完了するまでは、トークンのステータスは保留中です。
- ステータスが有効に変わってから、トークンを使用してください。
- 新しいトークンを必ずシステムへ実装してください。
トークンの削除
警告
- トークンを削除すると、そのトークンに依存するシステムでエラーが発生する可能性があります。
- トークンを削除するとトークンページから削除され、旧トークンを使用したすべてのリクエストが拒否されます。
- トークンを交換する場合は、まず新しいトークンを作成して実装し、利用可能になったこと、つまりステータスが「保留中」ではなくなったことを確認してから古いトークンを削除してください。
- トークンページで、削除するトークンの削除アイコンをクリックします。
- 「トークンを削除」と入力して、トークンの削除を確認します。
- トークンを削除をクリックします。
API V2トークンの用途
API V2トークンを使用する広告主および広告ネットワークのユースケース:
広告主
| API V2トークン |
|---|
| Pull APIローデータ |
| Pull API集計データ |
| アプリ一覧の取得 |
| Cohort |
| SKAdNetwork集計レポート |
| パートナー連携設定のコピー |
| インストールリファラ復号キーの設定 |
| Net Revenue API |
| OpenDSR API |
| Master API |
| オーディエンスインポートAPI |
| Advanced Security Module連携(Android) |
広告ネットワーク
S2Sトークンの用途
S2Sトークンを使用する広告主および広告ネットワークのユースケース:
広告主
| S2Sトークン |
|---|
| モバイルアプリ内イベントS2S API |
| WebイベントS2S API |
広告ネットワーク
| S2Sトークン |
|---|
| AppsFlyerプリロードリファラアトリビューション |
注意
ほとんどの広告ネットワークでは、S2Sトークンをセルフサービスで生成できなくなっています。そのため、管理者にはUI上でS2Sトークンを生成するオプションが表示されません。セルフサービスでのトークン生成は、一部のマネージドパートナーのみ利用できます。
OneLinkトークンの用途
OneLink APIトークンを使用する広告主のユースケース:
カスタムパラメータを含むOneLinkショートURLを作成、取得、更新、削除します。
MCPトークンの用途
MCPトークンで利用できるユースケースについては、AppsFlyer MCPの記事を参照してください。