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

検索

広告主向けSKAN CVスキーマAPI

  • 更新

概要：AppsFlyer Conversion Studioに設定されている、現在のSKAdNetwork（SKAN）のコンバージョン値（CV）スキーマを確認できます。

SKANコンバージョン値スキーマAPI

APIの基本情報

概要

AppsFlyer Conversion Studioに設定されている、現在のSKAdNetwork（SKAN）のCVスキーマを確認します。

注意：

  • 過去のSKAN CVスキーマは取得できません。 
  • Conversion StudioからCSVマッピングファイルをダウンロードして、SKANスキーマを確認することもできます。
パス

https://hq1.appsflyer.com/api/skan-pull-cs-api/v1/conversion-studio-schema/app/<app_id>
パスパラメータ（必須）

<app_id>：AppsFlyerのダッシュボードに表示されるアプリ識別子。ダッシュボードの表示どおりに入力します。例：id123456789
HTTPメソッド GET
レスポンスのコンテンツタイプ text/plain
認証

API V2.0トークン（Bearerトークン）を含むAuthorization HTTPヘッダーが必要です。

AppsFlyerAdmin_us-en.png管理者ユーザーがダッシュボードでV2トークンを取得します。画面上部のアカウントメニュー（メールアドレスのドロップダウン）を開き、［セキュリティセンター］＞［AppsFlyer APIおよびS2Sトークン］に移動します。 
レート制限
  • 1回のクエリで最大50,000行を返します。
  • 1分あたり10回の呼び出し
最終設定変更日
  • デコードモードでは、ファイル名に日付が表示されます。
  • ほかのすべてのモードでは、last_config_change列に日付が表示されます。

リクエスト例（cURL）

curl --request \
GET 'https://hq1.appsflyer.com/api/skan-pull-cs-api/v1/conversion-studio-schema/app/<app_id>' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

レポート名

APIは、以下の規則で名前を付けたCSVファイルを返します。

デコードモード：conversion_value_mapping_<date of last schema configuration change>

ほかのすべてのモード：conversion_schema_report_custom_encode

仕様と制限事項

項目 補足 
アドネットワークのアクセス  分析パートナーの場合は、広告主に権限の付与を依頼してください。
代理店のアクセス 利用不可
アカウントユーザーのアクセス 認証トークンは、管理者ユーザーがダッシュボードで取得できます。

HTTPレスポンスコードとトラブルシューティング

HTTP レスポンス

補足
200 OK

有効なデータを返しました（CSV）。
400 不正なリクエスト

無効なリクエストです。
401 認証エラー

認証トークンがないか、無効です。

トークンを正しく使用していることを確認してください。
401 リクエスト数が多すぎます

レート制限を超えました。
403 権限がありません このレポートにアクセスする権限がありません。分析パートナーの場合は、広告主に権限の付与を依頼してください。 
404 見つかりません

Tags