概要：集計したSKAdNetworkポストバックをAPI経由で取得できます。データは、ポストバック到着日を基準に集計されます。
SKANポストバック到着日別集計API
このAPIは、指定したポストバック到着日の期間で、SKAdNetworkポストバックを集計して返します。
注意！ポストバック到着日は、SKAdNetworkダッシュボードとレポートで使用するインストール日とは異なります。
SKANポストバック到着日別集計APIの使用方法
SKANポストバック到着日別集計APIを使用する手順：
- APIトークンを取得します。トークンは管理者が取得する必要があります。
- 認証ヘッダーで使用するAPIトークンを開発者に渡します。
- 次のセクションを参照し、API呼び出し時に指定するパラメータを開発者に伝えてください。パラメータでは、レポートの対象、データのまとめ方、対象期間を指定します。
- 開発者には、Developer HubのSKANポストバック到着日別集計APIの手順に従うよう依頼してください。
パラメータ
| パラメータ名 | 詳細 | 必須 |
|---|---|---|
|
|
ポストバック到着日の対象期間は、start_dateとend_dateで指定します。注意！到着日は、SKAdNetworkダッシュボードとレポートで使用するインストール日とは異なります。
|
はい |
end_date |
|
はい |
ad_network_name |
メディアソースで絞り込み |
いいえ |
geo |
ISO 3166（alpha-2）の国コードで絞り込みます。例：US、CN
|
いいえ |
skad_redownload |
|
いいえ |
skad_source_app_id |
ソースアプリIDで絞り込み |
いいえ |
ad_network_campaign_id |
アドネットワークのキャンペーンIDで絞り込みます。 注意：これは、SKAdNetworkが報告するキャンペーンIDではありません。 |
いいえ |
modeled_conversion_values |
|
いいえ |
レポートの構成と例
APIはCSVファイルを返します。
利用できる列と指標は、以下の表のとおりです。
| 列名 | ディメンションまたは計測値 | API V1トークンで利用可能 | API V2トークンで利用可能 | API V2トークンで利用可能（SKAN 4） | 推定データのみのフィルター使用時に利用可能 |
|---|---|---|---|---|---|
| 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の更新頻度に従って利用できるようになります。 |
| 日付範囲 |
|
| レート制限 |
|
| SRNs |
Google広告：ポストバック到着日は、Googleが報告した最終クリック時刻を基に算出します。 |
| アドネットワークのアクセス | 広告主から権限を付与されている場合、分析パートナーも利用できます。 |
| 代理店のアクセス | 利用不可 |
| アプリ固有のタイムゾーン | UTCのみ |
| アプリ固有の通貨 | 常にUSD |
| オーガニックデータ | このAPIでは利用できません。 |
| ノンオーガニックデータ | AppsFlyerが受信したSKAdNetworkポストバックを使用して算出します。 |
| 過去のデータ | 対応する最も古いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日 |
| アカウントユーザーのアクセス | 認証トークンは、管理者ユーザーがダッシュボードで取得できます。 |
関連情報