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

推奨

マーケティング担当

最終更新: 2023年01月29日 09:26

概要：APIを介して利用できる集約されたSKAdNetworkポストバック。データはポストバック受信日を使用して集計されます。注意！このAPIは、SKAN 4 ポストバック2と3、またはSKAN 4の固有データ項目をサポートしておりません。

SKAdNetworkポストバックの受信日での集約レポートAPI

APIの基本仕様

APIの仕様
概要	API は、ポストバック受信日の範囲を使用して、集約されたSKAdNetworkポストバックを返します。注記！ポストバック受信日は、SKAdNetwork管理画面とレポートで使用されるインストール日と異なります。注意！このAPIは、SKAN 4 ポストバック2と3、またはSKAN 4の固有データ項目をサポートしておりません。関連記事：インストール日で集約されたレポートAPI
データ更新頻度	レポートは、毎日更新されます。データの可用性は、SKAdNetworkデータの更新率に基づいています。
パス V1	~~`https://hq1.appsflyer.com/api/skadnetworks-postbacks/v1/data/app/<app_id>`~~ V1は非推奨です。サポート終了日は今後発表される予定です。
パス V2	`https://hq1.appsflyer.com/api/skadnetworks-postbacks/v2/data/app/<app_id>`
Pathの必須パラメータ	`<app_id>`：AppsFlyer管理画面に表示されるアプリの識別子です。管理画面に表示されるとおりに正確に入力してください。例：id123456789
クエリパラメータ―	次の表に記載されています。
HTTP method	`GET`
レスポンスコンテンツタイプ	`text/plain`
承認	API V2.0トークン（Bearer token）を含む `Authorization` HTTP ヘッダーが必要です。アドミンアカウントであればV2トークンを管理画面から取得可能なので、管理画面右上のメールアドレスをクリックして、APIトークンのページを開いてください。
日付の制限	サポートされている最も古い日付：2020年11月1日最大クエリ範囲：60日間
レート制限	クエリは最大20万行のデータを返します。 1分あたり60コール
SRNに関する備考	Google Ads：ポストバック到着日はGoogleによって報告されたラストクリック時刻を使用して算出されます。

クエリパラメータ―
項目	詳細	必須
`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`	いいえ

リクエストの例（cURL）

curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks-postbacks/v2/data/app/<app_id>?start_date=2020-09-10&end_date=2020-09-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

レスポンスの構成と例

例： V1 ｜V2

APIは、次の命名規則を持つCSVファイルを返します：

<app_id>_skadnetworks_postbacks_report_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv

利用できる項目

次の表で利用できるカラムと指標を示しています。

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

特性と制限

特性
特性	備考
アドネットワークのアクセス	広告主が権限を付与している場合、アナリティクスパートナーが利用できます。
代理店アクセス	利用不可
アプリ固有のタイムゾーン	UTCのみ
アプリ固有の通貨	常にUSD
オーガニックデータ	SDKからAppsFlyerに直接報告されたすべてのデータと、SKAdNetworkポストバックによって報告された非オーガニックデータとの差として計算されます
非オーガニックデータ	AppsFlyerが受け取ったSKAdNetworkポストバックを使用して計算されます
過去データ	サポートされている最も早いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日
アカウントユーザーのアクセス	認証トークンは、アドミンアカウントのみが管理画面から取得できます。

HTTPレスポンスコードとトラブルシューティング

レスポンスコードとトラブルシューティングガイド
HTTP	レスポンス	備考
200	OK	有効なデータが返されました（CSV）
200	OK	空のレポート - 指定した日付範囲のデータが見つかりませんでした（CSVで列名のみが返される）。 SKAdNetwork管理画面で、指定した日付範囲でデータが存在することを確認してください。 `start_date` の日付が昨日よりも前の日付であることを確認してください。
400	Bad request	クエリパラメーターが抜けているか、無効です
401	Unauthorized	認証トークンが抜けているか、無効です正しくトークンが設定されていることを確認してください。
403	権限なし	このレポートにアクセスする権限がありません。アナリティクスパートナーの場合は、広告主に権限を付与してもらうよう依頼してください。
404	Not found	ネットワークやファイアウォールに関する問題を処理してください AppsFlyerのIPアドレスが許可リストに登録されていることを確認してください
429	リクエストが多すぎます	レート制限を超えました