概要：API経由の集約されたSKAdNetworkポストバックです。データはポストバック受信日を使用して集計されます。
SKAdNetworkポストバックの受信日での集約レポートAPI
APIの基本仕様
| 概要 |
API は、ポストバック受信日の範囲を使用して、集約されたSKAdNetworkポストバックを返します。注記！ポストバック受信日は、SKAdNetwork管理画面とレポートで使用されるインストール日と異なります。 関連記事：インストール日で集約されたレポートAPI |
| データ更新頻度 |
レポートは、毎日更新されます。 データの可用性は、SKAdNetworkデータの更新率に基づいています。 |
| パス V1 |
V1は非推奨です。サポート終了日は今後発表される予定です。 |
| パス V2 |
|
| Pathの必須パラメータ |
|
|
クエリパラメータ― |
次の表に記載されています。 |
| HTTP method | GET |
| レスポンスコンテンツタイプ | text/plain |
| 承認 |
API V2.0トークン（Bearer token）を含む
|
| 日付の制限 |
|
| レート制限 |
|
| SRNに関する備考 |
Google Ads：ポストバック到着日はGoogleによって報告されたラストクリック時刻を使用して算出されます。 |
アドミンアカウントであれば| 項目 | 詳細 | 必須 |
|---|---|---|
|
|
ポストバック受信日の範囲は、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ではありません。 |
いいえ |
リクエストの例（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)>'レスポンスの構成と例
APIは、次の命名規則を持つCSVファイルを返します：
<app_id>_skadnetworks_postbacks_report_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv利用できる項目
次の表で利用できるカラムと指標を示しています。
| カラム名 | ディメンションまたは計測 | API V1で利用可能 | API V2 で利用可能 |
|---|---|---|---|
|
skad_conversion_value |
グループ化 | Y | Y |
|
skad_ad_network_id 一部のSRNは彼らのIDをAppsFlyerと共有していません。この場合、この項目は空白で、ad_network_nameが入力されます。 |
グループ化 |
Y |
Y |
|
ad_network_name 現状、殆どの場合はこのフィールドの値は空白になります。skad_ad_network_id を共有しないSRNの場合は入力されます。 |
グループ化 | Y | Y |
|
skad_campaign_id |
グループ化 | Y | Y |
|
ad_network_campaign_id |
グループ化 | Y | Y |
|
ad_network_campaign_name |
グループ化 | Y | Y |
|
ad_network_adset_id |
グループ化 | N | Y |
|
ad_network_adset_name |
グループ化 | N | Y |
|
ad_network_ad_id |
グループ化 | N | Y |
|
ad_network_ad_name |
グループ化 | N | Y |
|
skad_version |
グループ化 | Y | Y |
|
skad_redownload |
グループ化 | Y | Y |
|
skad_source_app_id |
グループ化 | Y | Y |
|
skad_fidelity_type |
グループ化 | N | Y |
|
geo |
グループ化 | Y | Y |
|
arrival_date |
グループ化 | Y | Y |
|
count |
測定 | Y | Y |
特性と制限
| 特性 | 備考 |
|---|---|
| アドネットワークのアクセス | 広告主が権限を付与している場合、アナリティクスパートナーが利用できます。 |
| 代理店アクセス | 利用不可 |
| アプリ固有のタイムゾーン | UTCのみ |
| アプリ固有の通貨 | 常にUSD |
| オーガニックデータ | SDKからAppsFlyerに直接報告されたすべてのデータと、SKAdNetworkポストバックによって報告された非オーガニックデータとの差として計算されます |
| 非オーガニックデータ | AppsFlyerが受け取ったSKAdNetworkポストバックを使用して計算されます |
| 過去データ | サポートされている最も早いコンバージョンデータ（インストールまたはリターゲティング）：2020年11月1日 |
| アカウントユーザーのアクセス | 認証トークンは、アドミンアカウントのみが管理画面から取得できます。 |
HTTPレスポンスコードとトラブルシューティング
| HTTP | レスポンス |
備考 |
|---|---|---|
| 200 | OK |
有効なデータが返されました（CSV） |
| 200 | OK |
空のレポート - 指定した日付範囲のデータが見つかりませんでした（CSVで列名のみが返される）。
|
| 400 | Bad request |
クエリパラメーターが抜けているか、無効です |
| 401 | Unauthorized |
認証トークンが抜けているか、無効です 正しくトークンが設定されていることを確認してください。 |
| 403 | 権限なし | このレポートにアクセスする権限がありません。アナリティクスパートナーの場合は、広告主に権限を付与してもらうよう依頼してください。 |
| 404 | Not found |
|
| 429 | リクエストが多すぎます |
レート制限を超えました |