SKAN集計パフォーマンスレポートAPI

概要:追加のデータポイントで強化されたSKANパフォーマンスです。SKAN管理画面のデータと同様のデータが取得できます。インストール日またはポストバック到着日を使用して集計してください。

SKAN集計パフォーマンスレポートAPI

APIの基本

概要 このAPIは、AppleのSKAdNetworkによって報告されたデータ(実際のデータ)と他のデータポイントを、インストール日、またはポストバック到着日を使用して返します。レポートは、SKAN管理画面に表示されるデータと同様の構造をしています。
データ更新頻度

データ可用性は、SKANデータの更新頻度に基づいています。

パス

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

Pathの必須パラメータ

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

クエリパラメータ―

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

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

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

日付の制限
  • 日付範囲を設定する場合、設定できる最新の日付は、現在の日付のUTCタイムゾーンから3日を引いたものです。つまり3月31日に選択できる最新の日付は3月28日です。
  • サポートされている最も古い日付:2020年11月1日
  • 最大クエリ範囲:90日間
レート制限
  • クエリは最大20万行のデータを返します。
  • 1分あたり60コール
SRNに関する備考
  • Facebook:データが利用できます。
  • Google Ads:Googleのクリックタイム方式により、インストールはインストール後8日後まで記録することができます。
APIの仕様
クエリパラメータ―
項目 形式 必須

data_type

期間で使用される日付タイプは、start_dateend_date によって決まります。

オプション:

  • [デフォルト] install: ポストバックの到着時間を使用し、測定期間を考慮した上で、AppsFlyerが導き出したインストール日です。
  • arrival: ポストバック到着時刻。注:オーガニックインストールの値はN/Aです。

Google Ads データ: Google Adsのレポート方法により、インストール日とポストバック到着日は同じになります。

いいえ

start_date

 

インストール日の範囲は、start_date と end_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-11-10&end_date=2020-11-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

レスポンスの構成と例

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

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

利用できる項目

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

グループ化

Campaign ID グループ化
Site ID グループ化
Country グループ化
Impressions 指標
Clicks 指標
CTR 指標
Installs 指標
Conversion Rate 指標
Converted Users 指標
Converted Users/Installs 指標
Total Revenue 収益指標
Total Cost 指標
ROI 収益指標
ARPU 収益指標
Average 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 エンゲージメント指標

{engagement in-app event}

event counter

エンゲージメント指標

 

特性と制限

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

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

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

備考

200 OK

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

200 OK

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

  • SKAdNetwork管理画面で、指定した日付範囲でデータが存在することを確認してください。
  • start_date の日付が昨日よりも前の日付であることを確認してください。推奨される最新の日付は、現在の日付のUTC時刻から3日を差し引いた日付です。例:UTCタイムゾーンの現在の日付が3月31日の場合、使用すべき最新日は3月28日です。 
400 Bad request

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

401 Unauthorized

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

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

403 権限なし このレポートにアクセスする権限がありません。アナリティクスパートナーの場合は、広告主に権限を付与してもらうよう依頼してください。
404 Not found
429 リクエストが多すぎます

レート制限を超えました

 

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