SKANポストバック到着日での集計レポートAPI

推奨

マーケター

最終更新日： 2024年02月26日 06:26

概要：API経由の集約されたSKAdNetworkポストバックです。データはポストバック受信日を使用して集計されます。

SKAN集計レポートAPI：ポストバック到着日ベース

このAPIでは、ポストバック受信日の範囲を基に、SKAdNetworkポストバックの集計データを取得できます。

注意！ポストバック受信日は、SKAdNetwork管理画面とレポートで使用されるインストール日とは異なります。

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

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

項目	詳細	必須
`start_date`	ポストバック受信日の範囲は、start_date と end_date で制限されます。注！受信日は、SKAdNetwork管理画面とレポートで使用されているインストール日とは異なります。 YYYY-MM-DD 許可されている最も古い日付：2020-11-01 例：`2020-11-05`	はい
`end_date`	YYYY-MM-DD レポートコールあたりの最大日数：60日例：`2020-11-12`	はい
`ad_network_name`	メディアソースのフィルタ	いいえ
`geo`	ISO 3166 (alpha-2)を使用した国コード別に絞り込みます。例：`US`、`CN`	いいえ
`skad_redownload`	`true` または `false` で絞り込みます。	いいえ
`skad_source_app_id`	ソースアプリIDで絞り込みます。	いいえ
`ad_network_campaign_id`	アドネットワークのキャンペーンIDで絞り込みます。注記：これは、SKAdNetworkによりレポートされたキャンペーンIDではありません。	いいえ
`modeled_conversion_values`	V2以降のみでサポート値 `true` または `false` `true` の値、ポストバックは "count" 列に推定されたコンバージョン値データを設定します。推定されたデータで使用可能な項目を参照 `false` の場合、ポストバックはコンバージョン値のカウントと、レポート構造でリストされた受信可能なすべての項目を、推定値データなしで確認します。デフォルト設定： `false`	いいえ

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

利用できるカラムと指標は以下の表の通りです。

例： V1 ｜V2

SKAdNetwork集計レポートの構成
カラム名	ディメンションまたは計測	API V1トークンで使用可能	API V2 トークンで使用可能	SKAN 4向けAPI V2 トークンで使用可能	推定値のみのフィルターで使用可能
skad_postback_sequence_index	グループ化	N	N	Y	Y
skad_conversion_value	グループ化	Y	Y	Y	Y
skad_coarse_conversion_value	グループ化	N	N	Y	Y
skad_ad_network_id 一部のSRNは彼らのIDをAppsFlyerと共有していません。この場合、この項目は空白で、ad_network_nameが入力されます。	グループ化	Y	Y	Y	Y
ad_network_name 現状、殆どの場合はこのフィールドの値は空白になります。skad_ad_network_id を共有しないSRNの場合は入力されます。	グループ化	Y	Y	Y	Y
skad_source_identifier	グループ化	N	N	Y	Y
skad_campaign_id	グループ化	Y	Y	Y	Y
ad_network_campaign_id	グループ化	Y	Y	Y	Y
ad_network_campaign_name	グループ化	Y	Y	Y	Y
ad_network_adset_id	グループ化	N	Y	Y	Y
ad_network_adset_name	グループ化	N	Y	Y	Y
ad_network_ad_id	グループ化	N	Y	Y	N
ad_network_ad_name	グループ化	N	Y	Y	N
ad_network_creative	グループ化	N	N	Y	N
ad_network_channel	グループ化	N	N	Y	N
skad_version	グループ化	Y	Y	Y	N
skad_redownload	グループ化	Y	Y	Y	N
skad_source_app_id	グループ化	Y	Y	Y	N
skad_source_domain	グループ化	N	N	Y	Y
skad_fidelity_type	グループ化	N	Y	Y	N
geo	グループ化	Y	Y	Y	N
arrival_date	グループ化	Y	Y	Y	Y
count	測定	Y	Y	Y	Y

仕様	備考
データ更新頻度	レポートは、毎日更新されます。データの可用性は、SKAdNetworkデータの更新率に基づいています。
期間	サポートされている最も古い日付：2020年11月1日最大クエリ範囲：60日間
コール頻度の制限	クエリは最大20万行のデータを返します。 1分あたり60コール
SRN媒体	Google Ads：ポストバック到着日はGoogleによって報告されたラストクリック時刻を使用して算出されます。
アドネットワークのアクセス	広告主が権限を付与している場合、アナリティクスパートナーが利用できます。
代理店アクセス	利用不可
アプリ固有のタイムゾーン	UTCのみ
アプリ固有の通貨	常にUSD
オーガニックデータ	このAPIでは使用できません
非オーガニックデータ	AppsFlyerが受け取ったSKAdNetworkポストバックを使用して計算されます
過去データ	サポートされている最も早いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日
アカウントユーザーのアクセス	認証トークンは、アドミンアカウントのみが管理画面から取得できます。