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

検索

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

含まれる値： 

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

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

 いいえ

start_date

 

インストール日の範囲は、start_date と end_date によって決まります。ご注意ください注記！インストール日は、ポストバックの受信日とは異なります。 

  • YYYY-MM-DD形式の最も早いインストール日 
  • 2024-02-26
    例： 2020-11-05
はい
end_date
  • YYYY-MM-DD形式の最新のインストール日
  • レポートコールあたりの最大日数：60日90日 
  • 例： 2020-11-12
はい
view_type

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

  • acquisition：インストール 
  • retargeting：Redownloads
  • unified：unified：ユーザー獲得と再ダウンロードの合計。
  • unifiedデフォルトunified

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

いいえ

レスポンスの構成と例

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

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

レポート項目

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

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

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

日付 

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

 ディメンション いいえ Y Y Y
Media Source (pid) ディメンション Y Y Y Y
キャンペーン（c）

ディメンション

Y

Y

Y

Y
Campaign ID ディメンション Y Y Y Y
Site ID ディメンション Y Y Y いいえ
Adset ディメンション いいえ Y Y Y
Adset ID ディメンション いいえ Y Y Y
Ad ディメンション いいえ Y Y いいえ
Ad ID ディメンション いいえ Y Y いいえ
国 ディメンション Y  Y Y いいえ

AF Attribution Flag

見る：SSOTガイド

 ディメンション いいえ Y Y Y

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

 ディメンション いいえ N Y Y

クリエイティブ

 ディメンション いいえ N Y いいえ

Channel

 ディメンション いいえ N Y いいえ
インプレッション 指標 Y Y Y Y
クリック 指標 Y Y Y Y
CTR 指標 Y Y Y Y
インストール 指標 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日より利用可能)  

 指標 いいえ Y Y Y
コンバージョン率 指標 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
平均eCPI 指標 Y Y Y Y
収益指標 Y Y Y Y
収益指標 Y Y Y Y

 

 指標 Y Y Y Y
  指標 Y Y Y Y

仕様と制限事項

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

Tags