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

推奨
マーケター マーケター
最終更新日：

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

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

このAPIは、AppleのSKAdNetworkによって報告されたデータ（実際のデータ）と他のデータポイントを、インストール日またはポストバック到着日を使用して生成します。 レポートは、SKAN管理画面に表示されるデータと同様の構造です。 

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

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

  1. APIトークンを取得します（管理者のみがトークンを取得できます）。
  2. 認証ヘッダーで使用する APIトークンを開発者に渡します。
  3. 以下のセクションで説明するように、APIコールを行うときに入力するパラメーターを開発者へ渡してください。パラメーターは、レポートが何に焦点を当て、どのように編成されるかを決定し、レポートの時間枠を定義します。
  4. デベロッパーハブのSKAN集計パフォーマンスレポートAPIに従うよう開発者に伝えます。

パラメーター

項目 形式 必須

date_type

期間で使用される日付タイプは、start_date と end_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 の場合に返されます

いいえ
modeled_conversion_values
  • V2以降でのみご利用いただけます
  • 値 true または false
  • true の場合、ポストバックには、デコードされたメトリック列を設定するときに、モデル化されたデータが含まれます。利用できる項目を参照してください
  • false の場合、ポストバックは、モデル化されたデータなしで、SKANのローポストバックによって受信されたデコードされたデータを表示します。
  • デフォルト設定： false

いいえ

レスポンスの構成と例

APIはCSVファイルで生成されます。

  • レポートで利用できるフィールドと指標は以下の表の通りです。 
  • 一部の指標（収益、エンゲージメント、コンバージョン）は、SKANパフォーマンス計測の設定によって異なります。
  • レポートにはレポート期間にユーザーが実行したアプリ内イベントのみが含まれています。そのため、アプリ内イベントのカラムの数や順序は、レポートごとに変わる可能性があります。データのインポート処理を計画する際には、カラムの順序に頼らないロジックを構成してください。
  • 例： V1 | V2

レポート項目

カラム名 ディメンションまたは指標 API V1 トークンで使用可能 API V2 トークンで使用可能

SKAN 4向けAPI V2 トークンで使用可能

 推定値のみのフィルターで使用可能

日付 

データは選択された date_type に基づきます。

 ディメンション N Y Y Y
Media Source (pid) ディメンション Y Y Y Y
Campaign (c)

ディメンション

Y

Y

Y

Y
Campaign ID ディメンション Y Y Y Y
Site ID ディメンション Y Y Y N
Adset ディメンション N Y Y Y
Adset ID ディメンション N Y Y Y
Ad ディメンション N Y Y N
Ad ID ディメンション N Y Y N
Country ディメンション Y  Y Y N

AF Attribution Flag

(参考：SSOTガイド）

 ディメンション N Y Y Y

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

 ディメンション N N Y Y

クリエイティブ

 ディメンション N N Y N

Channel

 ディメンション N N Y N
Impressions 指標 Y Y Y Y
Clicks 指標 Y Y Y Y
CTR 指標 Y Y Y Y
Installs 指標 Y Y Y Y

Click Through Installs (fidelity_type = 1)

 指標 Y Y Y Y

View Through Installs

(fidelity_type = 0)

 指標 Y Y Y Y

Null Conversion Value Rate

(2022年1月23日より利用可能) 

 指標 N Y Y Y
Conversion Rate 指標 Y Y Y Y
Converted Users 指標 Y Y Y Y
Converted Users/Installs 指標 Y Y Y Y
Total Revenue 収益指標 Y Y Y Y
Total Cost 指標 Y Y Y Y
ROI 収益指標 Y Y Y Y
ARPU 収益指標 Y Y Y Y
Average eCPI 指標 Y Y Y Y
{af_skad_revenue} (Unique users) 収益指標 Y Y Y Y
{af_skad_revenue} (Event counter) 収益指標 Y Y Y Y

{your in-app event name} (Unique users) 

 指標 Y Y Y Y
{your in-app event name} (Event counter)  指標 Y Y Y Y

仕様と制限事項

仕様 備考
データ更新頻度 データ可用性は、SKANデータの更新頻度に基づいています。
期間
  • 日付範囲を設定する場合、設定できる最新の日付は、現在の日付のUTCタイムゾーンから3日を引いたものです。つまり3月31日に選択できる最新の日付は3月28日です。
  • サポートされている最も古い日付：2020年11月1日
  • 最大クエリ範囲：90日間
レート制限
  • クエリは最大25万行を返します。
  • 1分あたり10コールまで
SRN媒体
  • Meta ads: データ利用可能
  • Google Ads：Googleのクリックタイム方式により、インストールはインストール後13日後まで記録することができます。過去13日間のGoogle経由のデータは、13日前までは確定されません。
アドネットワークのアクセス アナリティクスパートナーの場合は、広告主に権限の付与を依頼してください。
代理店アクセス 利用不可
アプリ固有のタイムゾーン UTCのみ
アプリ固有の通貨 常にUSD
オーガニックデータ SDKからAppsFlyerに直接報告されたすべてのデータと、SKANポストバックによって報告された非オーガニックデータとの差として計算されます
非オーガニックデータ AppsFlyerが受け取ったSKANポストバックを使用して計算されます
過去データ サポートされている最も早いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日
アカウントユーザーのアクセス 認証トークンは、アドミンアカウントのみが管理画面から取得できます。
総コスト 通常のアトリビューション（通常のオーバービュー管理画面）に、最も低い粒度レベル（例：広告、国、サイトIDなど）の行数が50,000を超えるSKANキャンペーンが含まれている場合、SKAN APIに合計コスト指標が含まれないことがあります。