SKAdNetworkのポストバック受信日で集計されたレポートAPI

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

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

APIの基本仕様

概要

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

関連記事:インストール日で集約されたレポートAPI

データ更新頻度

レポートは、毎日更新されます。

データの可用性は、SKAdNetworkデータの更新率に基づいています。

Path

https://hq1.appsflyer.com/api/skadnetworks-postbacks/v1/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/v1/data/app/<app_id>?start_date=2020-09-10&end_date=2020-09-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

レスポンスの構成と例

CSVレポートの例

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

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

利用できる項目

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

SKAdNetwork集計レポートの構成
カラム名 ディメンションまたは計測

skad_conversion_value

グループ化

skad_ad_network_id

一部のSRNは彼らのIDをAppsFlyerと共有していません。この場合、この項目は空白で、ad_network_nameが入力されます。

グループ化

ad_network_name

[2021年8月24日更新] 現在、ほとんどの場合、このフィールドは空白になっています。skad_ad_network_id を共有しないSRNの場合は入力されます。

グループ化

skad_campaign_id

グループ化

ad_network_campaign_id

グループ化

ad_network_campaign_name

グループ化

skad_version

グループ化

skad_redownload

グループ化

skad_source_app_id

グループ化

geo

グループ化

arrival_date

グループ化

count

測定

 

特性と制限

特性
特性 備考
アドネットワークのアクセス 広告主が権限を付与している場合、アナリティクスパートナーが利用できます。
代理店アクセス 利用不可
アプリ固有のタイムゾーン 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 リクエストが多すぎます

レート制限を超えました

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