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

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

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

APIの基本仕様

概要

API は、ポストバック受信日の範囲を使用して、集約されたSKAdNetworkポストバックを返します。注記!ポストバック受信日は、SKAdNetwork管理画面とレポートで使用されるインストール日と異なります。

関連記事:インストール日で集約されたレポート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 ヘッダーが必要です。

AppsFlyerAdmin_us-en.pngアドミンアカウントであればV2トークンを管理画面から取得可能なので、管理画面右上のメールアドレスをクリックして、APIトークンのページを開いてください。 

日付の制限
  • サポートされている最も古い日付:2020年11月1日
  • 最大クエリ範囲:60日間
レート制限
  • クエリは最大20万行のデータを返します。
  • 1分あたり60コール
SRNに関する備考

Google Ads:ポストバック到着日はGoogleによって報告されたラストクリック時刻を使用して算出されます。

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)を使用した国コード別に絞り込みます。例:USCN

いいえ

skad_redownload

true または false で絞り込みます。

いいえ

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)>'

レスポンスの構成と例

例: 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

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で列名のみが返される)。

  • SKAdNetwork管理画面で、指定した日付範囲でデータが存在することを確認してください。
  • start_date の日付が昨日よりも前の日付であることを確認してください。
400 Bad request

クエリパラメーターが抜けているか、無効です

401 Unauthorized

認証トークンが抜けているか、無効です

正しくトークンが設定されていることを確認してください。

403 権限なし このレポートにアクセスする権限がありません。アナリティクスパートナーの場合は、広告主に権限を付与してもらうよう依頼してください。
404 Not found
429 リクエストが多すぎます

レート制限を超えました

この記事は役に立ちましたか?