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

検索

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

  • 更新

概要：SKANの成果データを、追加情報とともに取得できます。 SKAdNetworkダッシュボードと同様のデータです。インストール日またはポストバック到着日で集計します。

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

このAPIは、インストール日またはポストバック到着日を基準に、AppleのSKAdNetworkが報告したアトリビューション指標（実データ）と、その他の情報を返します。レポートの構成は、SKANダッシュボードに表示されるデータと同様です。 

SKAN集計パフォーマンスレポートAPIの使用方法

SKAN集計パフォーマンスレポートAPIを使用する手順：

  1. APIトークンを取得します。トークンは管理者が取得する必要があります。
  2. 認証ヘッダーで使用するAPIトークンを開発者に渡します。
  3. 次のセクションを参照し、API呼び出し時に指定するパラメータを開発者に伝えてください。パラメータでは、レポートの対象、データのまとめ方、対象期間を指定します。
  4. 開発者には、Developer HubのSKAN集計パフォーマンスレポートAPIの手順に従うよう依頼してください。

パラメータ

パラメータ名 形式 必須

date_type

start_dateとend_dateで指定する期間の基準となる日付の種類。

選択肢： 

  • ［デフォルト］install：AppsFlyerが、ポストバックの到着時刻と計測期間を考慮して算出したインストール日。
  • arrival：ポストバックの到着時刻。注意：オーガニックインストールの指標はN/Aになります。 

Google広告のデータ：Google広告の報告方式により、インストール日と到着日は同じになります。 

 いいえ

start_date

 

インストール日の対象期間は、start_dateとend_dateで指定します。注意！インストール日は、ポストバック到着日とは異なります。 

  • インストール日の開始日。形式はYYYY-MM-DDです。 
  • 指定できる最も古い日付：2020-11-01。
    例：2020-11-05
はい
end_date
  • インストール日の終了日。形式はYYYY-MM-DDです。
  • 1回のレポート取得で指定できる最大日数：90日 
  • 例：2020-11-12
はい
view_type

以下の種類でインストールを絞り込みます。 

  • acquisition：インストール 
  • retargeting：再ダウンロード
  • unified：新規獲得と再ダウンロードの両方
  • ［デフォルト］unified
  • コスト、クリック、インプレッションの指標は、view_type=unifiedの場合に返されます。

いいえ
modeled_conversion_values
  • V2以降でのみ利用可能
  • 指定できる値はtrueまたはfalseです。
  • trueの場合、ポストバックのデコード済み指標の列には、モデリングによる推定データも含まれます。利用できるフィールドを確認
  • falseの場合、モデリングによる推定データを含めず、元のSKANポストバックをデコードしたデータを表示します。
  • デフォルト値はfalseです。

いいえ

レポートの構成と例

APIはCSVファイルを返します。

  • レポートで利用できるフィールドと指標は、以下の表のとおりです。 
  • 一部の指標（収益、エンゲージメント、コンバージョン）は、SKANの成果計測の設定によって異なります。
  • レポートには、対象期間中にユーザーが実行したアプリ内イベントのみが含まれます。そのため、アプリ内イベントの列の数と順序は、レポートごとに変わる場合があります。データのインポート処理は、列の順序に依存しないように設計してください。
  • 例：V1｜V2

レポートのフィールド

フィールド名 ディメンションまたは指標 API V1トークンで利用可能  API V2トークンで利用可能

API V2トークンで利用可能（SKAN 4）

 推定データのみのフィルター使用時に利用可能

日付 

選択したdate_typeに基づくデータです。

 ディメンション N Y Y Y
メディアソース（pid） ディメンション Y Y Y Y
キャンペーン（c）

ディメンション

Y

Y

Y

Y
キャンペーンID ディメンション Y Y Y Y
サイトID ディメンション Y Y Y N
広告セット ディメンション N Y Y Y
広告セットID ディメンション N Y Y Y
広告 ディメンション N Y Y N
広告ID ディメンション N Y Y N
国 ディメンション Y  Y Y N

AppsFlyerアトリビューションフラグ

SSOT（Single Source of Truth）ガイドを参照してください。

 ディメンション N Y Y Y

ポストバックのシーケンスインデックス

 ディメンション N N Y Y

クリエイティブ

 ディメンション N N Y N

チャネル

 ディメンション N N Y N
インプレッション 指標 Y Y Y Y
クリック 指標 Y Y Y Y
CTR 指標 Y Y Y Y
インストール 指標 Y Y Y Y

クリックスルーインストール（fidelity_type = 1）

 指標 Y Y Y Y

ビュースルーインストール

(fidelity_type = 0)

 指標 Y Y Y Y

CVがnullの割合

［2022年1月23日以降に利用可能］ 

 指標 N Y Y Y
コンバージョン率 指標 Y Y Y Y
コンバージョンユーザー数 指標 Y Y Y Y
コンバージョンユーザー数÷インストール数 指標 Y Y Y Y
総収益 収益指標 Y Y Y Y
総コスト 指標 Y Y Y Y
ROI 収益指標 Y Y Y Y
ARPU 収益指標 Y Y Y Y
平均eCPI 指標 Y Y Y Y
{af_skad_revenue}（ユニークユーザー数） 収益指標 Y Y Y Y
{af_skad_revenue}（イベント回数） 収益指標 Y Y Y Y

{your in-app event name}（ユニークユーザー数） 

 指標 Y Y Y Y
{your in-app event name}（イベント回数）  指標 Y Y Y Y

仕様と制限事項

項目 補足 
データの更新頻度 データは、SKANの更新頻度に従って利用できるようになります。
日付範囲
  • 期間の終了日には、UTCの当日から3日前までの日付を指定してください。たとえば、3月31日であれば3月28日を指定します。 
  • 対応する最も古い日付：2020年11月1日
  • 1回のクエリで指定できる最大期間：90日
レート制限
  • 1回のクエリで最大250,000行を返します。
  • 1分あたり10回の呼び出し
SRNs
  • Meta広告：データを利用できます。 
  • Google広告：クリック時刻に基づくGoogleの方式により、インストール後最大45日までインストールが記録される場合があります。 Googleの過去45日分のデータを毎日取得することで、必要なGoogleのSKANデータを網羅できます。
アドネットワークのアクセス  分析パートナーの場合は、広告主に権限の付与を依頼してください。
代理店のアクセス 利用不可
アプリ固有のタイムゾーン UTCのみ
アプリ固有の通貨  常にUSD
オーガニックデータ SDKがAppsFlyerに直接報告した全データから、SKANポストバックが報告したノンオーガニックデータを差し引いて算出します。
ノンオーガニックデータ AppsFlyerが受信したSKANポストバックを使用して算出します。
過去のデータ 対応する最も古いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日
アカウントユーザーのアクセス 認証トークンは、管理者ユーザーがダッシュボードで取得できます。
総コスト 通常のアトリビューション（通常のOverview）にSKANキャンペーンが含まれ、その最も細かい粒度（広告、国、サイトIDなど）のデータが50,000行を超える場合、SKAN APIに総コスト指標が含まれないことがあります。

Tags