SKAdNetworkパフォーマンスレポートAPI

概要:追加のデータポイントで強化されたiOSキャンペーンパフォーマンスのSKAdNetworkに関する指標です。SKAdNetwork管理画面のデータと同様のデータが取得できます。実際のデータが対象で、SKAdのシミュレーションデータは取得できません。

SKAdNetworkパフォーマンスレポートAPI

APIの基本

概要 このAPIは、AppleのSKAdNetworkによって報告されたデータ(実際のデータ)と他のデータポイントを返します。
データ更新頻度
  • レポートは、毎日更新されます。
  • データの可用性は、SKAdNetworkデータの更新率に基づいています。
パス

https://hq1.appsflyer.com/api/skadnetworks/v1/data/app/<app_id>

Pathの必須パラメータ

<app_id>:AppsFlyer管理画面に表示されるアプリの識別子です。管理画面に表示されるとおりに正確に入力してください。例:id123456789

クエリパラメータ―

次の表に記載されています。
HTTP method GET
レスポンスコンテンツタイプ text/plain
Authorization

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

AppsFlyerAdmin_us-en.png管理者が管理画面にてV2トークンを取得し、メールアドレスをクリックして、APIトークンページを開きます。 

日付の制限
  • サポートされている最も古い日付:2020年11月1日
  • 最大クエリ範囲:90日間
レート制限
  • クエリは最大20万行のデータを返します。
  • 1分あたり60コール
APIの仕様
クエリパラメータ―
項目 形式 必須

start_date

  • YYYY-MM-DD 
  • 許可されている最も古い日付:2020-11-01
    例:2020-11-05
はい
end_date
  • YYYY-MM-DD
  • レポートコールあたりの最大日数:90日
  • 例:2020-11-12
はい
view_type

次のとおり、インストールをタイプ別に絞り込みます:

  • acquisition:インストール
  • retargeting: 再ダウンロード
  • unified:ユーザー獲得と再ダウンロードの合計。
  • [デフォルト] unified
  • view_type=unified の場合に広告費の指標を返します

いいえ

リクエストの例(cURL)

curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks/v1/data/app/<app_id>?start_date=2020-09-10&end_date=2020-09-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

レスポンスの構成と例

APIはm次の命名規則を持つCSVファイルを返します:

<app_id>_skadnetworks_report_<view_type>
_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv

利用できる項目

SKAdNetwork集計レポートの構成
列名 ディメンションまたは指標
Media Source (pid) グループ化
キャンペーン(c)

グループ化

Campaign ID グループ化
Site ID グループ化
グループ化
インプレッション 指標
クリック 指標
クリック率 指標
インストール 指標
コンバージョン率 指標
コンバージョンしたユーザー 指標
コンバージョンしたユーザー / インストール 指標
総収益 収益指標
Total Cost 指標
ROI 収益指標
ARPU 収益指標
平均 eCPI 指標
{af_skad_revenue} unique users 収益指標
{af_skad_revenue} event counter 収益指標
{conversion in-app event [n]} Unique Users (n=1..6) コンバージョン指標
{conversion in-app event [n]} Event Counter (n=1..6) コンバージョン指標
{engagement in-app event} Unique Users エンゲージメント指標

{engagment in-app event}

イベントカウンター

エンゲージメント指標

 

特性と制限

特性
特性 備考
アドネットワークのアクセス 利用不可
代理店アクセス 利用不可
アプリ固有のタイムゾーン UTCのみ
アプリ固有の通貨 常にUSD
オーガニックデータ SDKからAppsFlyerに直接報告されたすべてのデータと、SKAdNetworkポストバックによって報告された非オーガニックデータとの差として計算されます
非オーガニックデータ AppsFlyerが受け取ったSKAdNetworkポストバックを使用して計算されます
過去データ サポートされている最も早いコンバージョンデータ(インストールまたはリターゲティング):2020年11月1日
チームメンバーアクセス 認証トークンは、アカウント管理者が管理画面から取得できます。

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

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

備考

200 OK

有効なデータが返されました(CSV)

200 OK

空のレポート - 指定した日付範囲のデータが見つかりませんでした(CSVで列名のみが返される)

  • SKAdNetwork管理画面で、指定した日付範囲でデータが存在することを確認してください。
  • start_date の日付が昨日よりも前の日付であることを確認してください。
400 Bad request

クエリパラメーターが抜けているか、無効です

401 Unauthorized

認証トークンが抜けているか、無効です

正しくトークンが設定されていることを確認してください。

404 Not found
429 リクエストが多すぎます

レート制限を超えました

 

この記事は役に立ちましたか?