どのようにお手伝いできますか?

AppsFlyerトークンの管理

  • 更新

概要:トークンを使用することで、データのセキュリティを強化できます。トークンを使用すると、AppsFlyer API経由でデータへアクセスしたり、サーバー間(S2S)通信でイベントデータを受信したりできます。管理者は、データの継続性を維持しながら複数のトークンを管理できます。必要に応じて、APIトークンやS2Sトークンの作成、名前変更、削除が可能です。

重要

AppsFlyerAdmin_us-en.png

  • トークンを表示・管理できるのは管理者のみです。一般のアカウントユーザーは、トークンページへアクセスできません。
  • トークンはデータへのアクセスを可能にするため、安全に保管してください。トークンを公開コードリポジトリに掲載しないでください。
  • トークンは180日ごとに交換することを推奨します。

AppsFlyerトークンについて

トークンは、AppsFlyer APIやS2S通信を通じてユーザーがデータへアクセスできるようにするために使用します。管理者は、主に以下の目的でトークンを使用します。

  • セキュリティ対策:
    • トークンの漏洩や不正アクセスの疑いなど、特定のセキュリティ上の懸念に対応するためのトークン交換
    • 定期的なセキュリティポリシー更新の一環として行うトークン交換
  • 異なるAPIコールの管理
  • テスト用途
  • OneLink APIなど、特定機能での利用

トークンページへのアクセス

  1. 上部バーから、アカウントメニュー(メールアドレスのドロップダウン)を開き、セキュリティセンターを選択します。
  2. 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トークンを再利用できます。同じトークンを複数のユースケースで利用できます。

トークンの管理

管理者は、複数のトークンを作成、名前変更、削除して管理できます。主な用途は、現在使用しているトークンを新しいトークンへ置き換えることです。まず新しいトークンを作成してシステムへ実装し、利用可能になったことを確認してから古いトークンを削除します。

トークンの確認

  1. 上部バーから、アカウントメニュー(メールアドレスのドロップダウン)を開き、セキュリティセンターを選択します。
  2. AppsFlyer APIトークンセクションで、AppsFlyer APIトークンを管理をクリックします。
  3. 利用可能なトークンが表示されます。
  4. 必要なトークンをコピーします。

トークンの作成

  1. トークンページで、+新しいトークンをクリックします。
  2. トークン名を入力します。
  3. トークンの種類を選択します。
  4. トークンを作成をクリックします。

注意

  • API V2トークンは、作成後すぐに有効になります。 
  • S2S、OneLinkなどその他の種類のトークンは、有効になるまで最大30分かかる場合があります。 
    • 有効化が完了するまでは、トークンのステータスは保留中です。 
    • ステータスが有効に変わってから、トークンを使用してください。 
  • 新しいトークンを必ずシステムへ実装してください。

トークンの削除

警告

  • トークンを削除すると、そのトークンに依存するシステムでエラーが発生する可能性があります。
  • トークンを削除するとトークンページから削除され、旧トークンを使用したすべてのリクエストが拒否されます。
  • トークンを交換する場合は、まず新しいトークンを作成して実装し、利用可能になったこと、つまりステータスが「保留中」ではなくなったことを確認してから古いトークンを削除してください。
  1. トークンページで、削除するトークンの削除アイコンをクリックします。
  2. 「トークンを削除」と入力して、トークンの削除を確認します。
  3. トークンを削除をクリックします。

API V2トークンの用途

API V2トークンを使用する広告主および広告ネットワークのユースケース:

広告主

API V2トークン
Pull APIローデータ
Pull API集計データ
アプリ一覧の取得
Cohort
SKAdNetwork集計レポート
パートナー連携設定のコピー
インストールリファラ復号キーの設定
Net Revenue API
OpenDSR API
Master API
オーディエンスインポートAPI 
Advanced Security Module連携(Android)

広告ネットワーク

API V2トークン
広告ネットワーク向けアプリ一覧
キャンペーン管理プラットフォームとの連携
連携済みパートナー向けProtect360レポート
InCost

S2Sトークンの用途

S2Sトークンを使用する広告主および広告ネットワークのユースケース:

広告主

S2Sトークン
モバイルアプリ内イベントS2S API 
WebイベントS2S API

広告ネットワーク

S2Sトークン
AppsFlyerプリロードリファラアトリビューション

注意

ほとんどの広告ネットワークでは、S2Sトークンをセルフサービスで生成できなくなっています。そのため、管理者にはUI上でS2Sトークンを生成するオプションが表示されません。セルフサービスでのトークン生成は、一部のマネージドパートナーのみ利用できます。

OneLinkトークンの用途

OneLink APIトークンを使用する広告主のユースケース:

カスタムパラメータを含むOneLinkショートURLを作成、取得、更新、削除します。

MCPトークンの用途

MCPトークンで利用できるユースケースについては、AppsFlyer MCPの記事を参照してください。