概要:APIを介して利用できる集約されたSKAdNetworkポストバック。データはポストバック受信日を使用して集計されます。注意!このAPIは、SKAN 4 ポストバック2と3、またはSKAN 4の固有データ項目をサポートしておりません。
SKAdNetworkポストバックの受信日での集約レポートAPI
APIの基本仕様
概要 |
API は、ポストバック受信日の範囲を使用して、集約されたSKAdNetworkポストバックを返します。注記!ポストバック受信日は、SKAdNetwork管理画面とレポートで使用されるインストール日と異なります。 注意!このAPIは、SKAN 4 ポストバック2と3、またはSKAN 4の固有データ項目をサポートしておりません。 関連記事:インストール日で集約されたレポート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ではありません。 |
いいえ |
modeled_conversion_values |
|
いいえ |
リクエストの例(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 | 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で列名のみが返される)。
|
400 | Bad request |
クエリパラメーターが抜けているか、無効です |
401 | Unauthorized |
認証トークンが抜けているか、無効です 正しくトークンが設定されていることを確認してください。 |
403 | 権限なし | このレポートにアクセスする権限がありません。アナリティクスパートナーの場合は、広告主に権限を付与してもらうよう依頼してください。 |
404 | Not found |
|
429 | リクエストが多すぎます |
レート制限を超えました |