どのようにお手伝いできますか?

検索

SKANローデータレポート

  • 更新

概要：SKANローデータレポートには、元のSKANポストバックに加え、AppsFlyerがiOSから受信したポストバックを変換・デコードして生成した、行単位のデータが含まれます。データは、Data LockerとPush API経由で利用できます。契約プランにローデータが含まれている場合、Data Lockerの契約は不要です。 

SKANローデータレポート

原則： 

  • データの提供方法：
    • Data Locker
      • 注意！ローデータを契約しているアカウントで利用できます。 Data Lockerの契約は不要です。現在Data Lockerを使用していない場合は、管理者ユーザーがData Lockerを設定し、SKANレポートを有効にする必要があります。［レポート］＞［Data Locker］に移動します。 SKANレポートを選択します。 
      • データの更新頻度：日次。 データは、AppsFlyerがポストバックを受信した日付のh=23フォルダーに格納されます。 
    • Push API
  • インストール日：AppsFlyerがポストバック到着時刻から、以下のように算出します。
    • SKAN V4のポストバックでは、次の式を使用します。インストール日＝ポストバック到着時刻−［累積ウィンドウ期間］−［平均ポストバック遅延時間］。
      • ポストバック1：インストール日＝ポストバック到着時刻−48時間−36時間
      • ポストバック2：インストール日＝ポストバック到着時刻−168時間−84時間
      • ポストバック3：インストール日＝ポストバック到着時刻−840時間−84時間
    • SKAN V3のポストバックでは、次の式を使用します。インストール日＝ポストバック到着時刻−36時間−［最終アクティブ時間帯の平均値］。 
      • ［最終アクティブ時間帯の平均値］のデフォルトは12時間です。
      • CVが0の場合、最終アクティブ時間帯の平均値は0に設定されます。
    • Googleは独自にインストール時刻を推定し、AppsFlyerはその時刻を使用します。注意：Googleによるインストールの報告には、最大45日かかる場合があります。詳細はこちら

利用できるレポートの種類：

  • デバイスポストバック：iOSデバイスから、インストールまたは再ダウンロードごとに1件受信するポストバック。
  • SKANローデータ：
    • AppsFlyerは、デバイスポストバックをデコード・変換し、ローデータのレコードを生成します。
    • 各ポストバックから、インストールまたは再ダウンロードのレコードと、アプリ内イベントのレコードが生成されます。
    • アプリ内イベントのレコード数は、CVによって以下のように異なります。
      • CVが0、空欄、nullの場合：アプリ内イベントのレコードは生成されません。 
      • CVの範囲：
        • 1〜63：SKAN 3と、SKAN 4のウィンドウ1の細かいCVでは、計測設定に応じたアプリ内イベントのレコード数になります。
        • low、medium、high：SKAN 4の粗いCVでは、計測設定に応じたアプリ内イベントのレコード数になります。

一部のフィールドが空欄になる理由以下のいずれかの理由で、フィールドが空欄になります。

  • campaign_name、ad_network_campaign_id、ipなど、任意の追加情報をアドネットワークが提供していない場合。
  • Appleのしきい値ポリシーにより、データが開示されなかった場合。 source_app_id、skad_campaign_id、skad_conversion_valueなどが該当します。 

SKANローデータレポートの形式と内容

ローデータレポートの種類

レポートの種類 レポート名 説明
ポストバック ポストバック

iOSからアドネットワークに送信されたポストバック。アドネットワークが情報を追加した後、AppsFlyerに転送します。ポストバックのサンプルをダウンロード（CSV）。

注意：did_win=falseのポストバックは含まれません。

Data Lockerのトピック名：skad_postbacks
ポストバック ポストバックのコピー（Appleから直接受信）

iOSからAppsFlyerに直接送信されたポストバック。

iOS15以降で利用できます。広告主がアプリを設定し、帰属先へのポストバックをAppsFlyerにも送信する必要があります。ポストバックコピーのサンプルをダウンロード（CSV）。

注意：このトピックには、帰属先へのポストバックのみが含まれます。 

Data Lockerのトピック名：skad_postbacks_copy
デコード済みイベント インストール

初回のアプリインストール

SKANがredownload=falseを報告した場合。つまり、そのApple IDのユーザーが、このアプリを初めてダウンロードしたことを意味します。
インストールのサンプルをダウンロード（CSV）。

Data Lockerのトピック名：skad_installs
デコード済みイベント 再ダウンロード

初回ではないアプリインストール

SKANがredownload=trueを報告した場合。つまり、そのApple IDのユーザーが、このアプリを以前にもダウンロードしていることを意味します。レポートの構成は、インストールのレポートと同じです。

Data Lockerのトピック名：skad_redownloads
デコード済みイベント アプリ内イベント

アプリ内イベント

2021年7月21日以降、アプリ内イベントのローデータの提供方法が、以下の表のとおり変更されています。 

アプリ内イベントのレコード数は、計測設定によって異なります。 

アプリ内イベントのサンプルをダウンロード（CSV）。

Data Lockerのトピック名：skad_inapps

2021年7月21日以降に受信したiOSポストバックに適用：

計測タイプ 説明
収益
  • 特定のユーザーの収益。収益が0より大きい場合、skad_revenueとevent_nameのフィールドを含むレコードが生成されます。
  • min_revenueとmax_revenueには、カスタムコンバージョンで定義した範囲の値が入ります。  
アプリ内コンバージョンとファネルイベント
  • 実行されたコンバージョンイベントの種類ごとに1件のレコードが生成されます。 event_nameフィールドには、対応するイベント名が設定されます。イベントが実行されていない場合、レコードは生成されません。
  • コンバージョンイベントでは、min_event_counter=0、max_event_counter=1となります。 
アプリ内エンゲージメント  ユーザーがアプリ内イベントを実行した回数は、次の式で算出します。[round up (min_event_counter + max_event_counter) / 2]

2021年7月20日までに受信したiOSポストバックに適用：

計測タイプ レコード数 説明
収益 0-1 収益が0より大きい場合、skad_revenueとevent_nameのフィールドを含むレコードが生成されます。
コンバージョン  0-6 実行されたコンバージョンイベントの種類ごとに1件のレコードが生成されます。 event_nameフィールドには、対応するイベント名が設定されます。イベントが実行されていない場合、レコードは生成されません。
エンゲージメント 0-63 レコード数は、ユーザーがエンゲージメントイベントを実行した回数を表します。ユーザーがイベントを実行しなかった場合、エンゲージメントのレコードはありません。
カスタム 0〜上限なし 独自のコンバージョンスキーマに従います。 
デコード済みイベント SRNの広告ディメンション 
  • Meta広告のイベントを、キャンペーン、広告セット、広告の粒度で提供するレポートです。各行は、インストールまたはアプリ内イベントのいずれかです。
  • Meta広告のSKANポストバックには、広告セットと広告の粒度の情報は含まれません。このデータは、このレポートでのみ確認できます。SKANダッシュボード、Performance API、その他のSKANのData Lockerレポートには表示されません。
  • レポートのスキーマは固定されていません。 Data Lockerのフィールド選択設定は適用されません。
  • 推奨：このレポートのデータを、ほかのSKANレポートと統合・比較しないでください。このレポートではSRNがデコードしたデータを使用しますが、ほかのレポートではAppsFlyerがデコードしたデータを使用するため、差異が生じる場合があります。差異の原因には、タイムゾーンやSRNのスキーマの違い、SRN連携でのアプリ内イベントとCVのマッピングの誤りなどがあります。
  • SRNの広告ディメンションのサンプルをダウンロード（CSV）。
Data Lockerのトピック名：skad_srn_advertising_dimensions

ローデータのフィールド形式

フィールドの形式

形式名 説明
文字列［n］ 文字列の最大長。通常、データ受信時にはフィールド長を制限しません。ただし、その後の処理でデータが切り詰められる場合があります。
日時文字列 yyyy-mm-dd hh:mm:ss形式の文字列。例：2019-09-17 00:09:25 
列挙型［n］ 列挙型のフィールドには、指定された値のみを設定できます。たとえば、コストの通貨は3文字で、指定された通貨コードのみを使用できます。
タイムスタンプ

10桁のUNIXタイムスタンプ。例：

2020年8月4日07:25（UTC）は、"timestamp": "1596525944"になります。
ブール値 フィールドの値は、TRUEまたはFALSEです。
整数 整数
浮動小数点数 小数点以下の値を含められる実数。

ポストバック／ポストバックコピーレポートで利用できるフィールド

フィールド名 データソース、または対応開始のiOS SKANバージョン 説明 形式 ポストバックコピーに含まれる 
ad_network_campaign_id アドネットワーク アドネットワークがAppsFlyerに報告したキャンペーンID 文字列 いいえ

ad_network_campaign

_name

 アドネットワーク

アドネットワークがAppsFlyerに報告したキャンペーン名。

 

 文字列 いいえ
ad_network_timestamp アドネットワーク

アドネットワークがポストバックを受信した時刻。

Google広告の場合、Googleが報告した最終クリック時刻から算出します。

 タイムスタンプ いいえ
app_id AppsFlyer IDプレフィックス付きのアプリID（広告対象アプリ）。 文字列 はい
city AppsFlyer 2021年8月30日以降、常にnull  文字列 いいえ
country_code アドネットワーク   文字列 いいえ
dma   2021年8月30日以降、常にnull  文字列 いいえ
postal_code   2021年8月30日以降、常にnull   文字列 いいえ
region AppsFlyer 報告されたcountry_codeに基づきます。 文字列 いいえ
skad_ad_network_id 1.0  一部のSRNはIDを共有しないため、フィールドは空欄になります。たとえば、X広告が該当します。  文字列 はい 
skad_attribution_signature 1.0   文字列 はい
skad_campaign_id 1.0 広告配信に使用されたキャンペーンID。範囲：0〜100 文字列 はい
skad_conversion_value 2.0 

iOSが報告したCV。範囲：0〜63。

nullの場合、iOSがこのフィールドに値を設定していません。** 

 整数 はい
skad_redownload 2.0 trueの場合、アプリが再ダウンロードされています。 ブール値 はい
skad_source_app_id 2.0

サイトID。広告を掲載するアプリ。このフィールドは、source_app_idと同じです。

値が設定されるかどうかは、プライバシーしきい値に基づきます。**

 文字列 はい
skad_transaction_id 1.0   文字列 はい
skad_version 2.0   文字列 はい
timestamp アドネットワーク AppsFlyerがSKANポストバックを受信した時刻。  日時文字列 はい
ad_network_name アドネットワーク アドネットワークがAppsFlyerに報告したアドネットワーク名。 
  • 空欄の場合、アドネットワークが値を設定しなかったか、設定できなかったことを意味します。
  • skad_ad_network_idを使用して、アドネットワーク名を特定できます。こちらの表を使用してください。 
 文字列 いいえ
ip  

ポストバックを送信したiOSデバイスのHTTPメッセージに含まれるIPアドレス。

アドネットワークがAppsFlyerにアドレスを提供した場合に設定されます。

注意！このアドレスの取得に、SDKは関与しません。

 文字列 いいえ
skad_app_id 1.0   文字列 いいえ
source_app_id AppsFlyer サイトID。広告を掲載するアプリ。このフィールドは、skad_source_app_idと同じです。 文字列 いいえ
ad_network_adset_id アドネットワーク   文字列 いいえ
ad_network_adset_name アドネットワーク   文字列 いいえ
ad_network_ad_name アドネットワーク   文字列 いいえ
ad_network_ad_id アドネットワーク   文字列 いいえ
did_win 3.0 (iOS 14.6) インストールに貢献したキャンペーンと、帰属先となったキャンペーンを区別するために使用します。 
  • trueの場合、インストールはこのキャンペーンに帰属しています。
  • falseの場合、インストールに貢献したと見なされますが、SKANダッシュボードやレポートには含まれません。
  • nullの場合、iOSまたはSKAdNetworkが古いバージョンであるため、iOSがこのフィールドに値を設定していません。
 ブール値 はい
fidelity_type 2.2 (iOS 14.5)

アトリビューションに影響する広告の表示方式を区別します。以下のように、0と1で表します。 

  • ビュースルー広告（0）
  • StoreKitで表示される広告（1）

SKAN 2.2未満では、このフィールドの値は使用しないでください。

 整数 はい
ad_network_source_app_id アドネットワーク アドネットワークが報告した広告掲載元アプリのID。アドネットワークが報告する値で、コストの照合に役立ちます。このデータの基になる情報は、広告掲載元アプリが提供します。  文字列 いいえ
ad_network_channel アドネットワーク   文字列 いいえ
af_prt アドネットワーク   文字列 いいえ
skad_postback_sequence_index 4.0 (iOS 16.2)
  • SKANのウィンドウを表す値で、0、1、2のいずれかです。
  • SKAN 3では、値は0です。
整数 はい
skad_coarse_conversion_value

4.0 (iOS 16.2)

 
  • 値はlow、medium、highのいずれかです。
  • SKAN 3では、値はnullです。
 文字列 はい
skad_source_identifier 4.0 (iOS 16.2)
  • 最大4桁の値です。
  • SKAN 3では、値はnullです。 
 文字列 はい
skad_source_domain 4.0 (iOS 16.2)
  • アトリビューション対象となるWeb広告の流入元を表します。
  • SKAN 3では、値はnullです。
 文字列 はい
ad_network_creative アドネットワーク
  • アドネットワークから受信した追加情報に基づく値です。
  • SKAN 3では、値はnullです。
 文字列 いいえ
**Appleが、プライバシーしきい値の仕組みに基づいて、フィールドに値を設定するかどうかを決定します。   

デコード済みイベントレポートで利用できるフィールド

フィールド名 ソース 説明 形式 SRNの広告ディメンションレポートに含まれる
ad_network_campaign_id アドネットワーク アドネットワークがAppsFlyerに報告したキャンペーンID 文字列 はい
ad_network_campaign
_name		 アドネットワーク アドネットワークがAppsFlyerに報告したキャンペーン名 文字列 はい
ad_network_timestamp アドネットワーク

アドネットワークがポストバックを受信した時刻

Google広告では、このフィールドに値は設定されません。 

タイムスタンプ

（SRNの広告ディメンションレポートでは日時文字列）

 はい
app_id iOS アプリID（広告対象アプリ） 文字列 はい
city   2021年8月30日以降、常にnull  文字列 いいえ
country_code アドネットワーク   文字列 いいえ
dma   2021年8月30日以降、常にnull  文字列 いいえ
event_name AppsFlyer

AppsFlyerで設定したアプリ内イベント名。

SRN ___reportでは、Meta広告で設定したアプリ内イベント名です。

 文字列 はい
event_uuid AppsFlyer パートナーがポストバックの重複を識別するための、一意のランダムな識別子 文字列 いいえ
install_date iOS ポストバック到着時刻に基づいて、AppsFlyerが推定します。 日時文字列 いいえ
install_type iOS 新規インストール 文字列 いいえ
ip iOS

ポストバックを送信したiOSデバイスのHTTPメッセージに含まれるIPアドレス。

アドネットワークがAppsFlyerにアドレスを提供した場合に設定されます。

注意！このアドレスの取得に、SDKは関与しません。 

 文字列 いいえ
media_source iOS 帰属先のアドネットワーク。AppsFlyerで使用するアドネットワーク名で表示します。 文字列 はい
postal_code   2021年8月30日以降、常にnull  文字列 いいえ
region AppsFlyer country_codeに基づいて決定 文字列 いいえ
skad_ad_network_id iOS ポストバックの送信先アドネットワークのID 文字列 いいえ
skad_ambiguous_event（SKAN 4以降は廃止） AppsFlyer trueの場合、このiOSポストバックは、広告主がダッシュボードでSKANの設定を変更してから72時間以内に受信したものです。 SKANの各種タイマーの影響により、AppsFlyerはイベントを正確にマッピングできません。
  • SKAN 4以降では利用できません。
 ブール値 いいえ
skad_attribution_signature iOS   文字列 いいえ
skad_campaign_id iOS 広告配信に使用されたキャンペーンID。範囲：0〜100 整数 いいえ
skad_conversion_value iOS

iOSが報告したCV。範囲：0〜63。

nullの場合、iOSがこのフィールドに値を設定していません。**

 整数 いいえ
skad_mode AppsFlyer iOSポストバックのデコードに使用したコンバージョン計測モード。選択肢：
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
 文字列 いいえ
skad_redownload iOS trueの場合、アプリが再ダウンロードされています。 ブール値 いいえ
skad_revenue iOS イベント収益額（USD）。 浮動小数点数 いいえ
skad_source_app_id iOS

サイトID。広告を掲載するアプリです。

値が設定されるかどうかは、プライバシーしきい値に基づきます。**

 文字列 いいえ
skad_transaction_id iOS - 文字列 いいえ
skad_version iOS - 文字列 いいえ
timestamp iOS

AppsFlyerがSKANポストバックを受信した時刻。

Google広告とMeta広告では、それぞれのAPIからAppsFlyerがデータを取得した時刻です。

タイムスタンプ

（SRNの広告ディメンションレポートでは日時文字列）

 はい
event_value S2S

デフォルト値：null

カスタムデコードを実装するアプリが設定した文字列を含みます。

広告主が自社システムで使用します。 AppsFlyerはこの値を使用しません。 

 文字列（JSON） いいえ
ad_network_adset_id アドネットワーク   文字列 はい
ad_network_adset_name アドネットワーク   文字列 はい
ad_network_ad_name アドネットワーク   文字列 はい
ad_network_ad_id アドネットワーク   文字列 はい
skad_did_win (1) 3.0 (iOS 14.6) インストールに貢献したキャンペーンと、帰属先となったキャンペーンを区別するために使用します。 
  • trueの場合、インストールはこのキャンペーンに帰属しています。
  • falseの場合、インストールに貢献したと見なされますが、SKANダッシュボードやレポートには含まれません。
  • nullの場合、iOSまたはSKAdNetworkが古いバージョンであるため、iOSがこのフィールドに値を設定していません。
 ブール値 いいえ
skad_fidelity_type (1) 2.2 (iOS 14.5)

アトリビューションに影響する広告の表示方式を区別します。以下のように、0と1で表します。 

  • ビュースルー広告（0）
  • StoreKitで表示される広告（1）

SKAN 2.2未満では、このフィールドの値は使用しないでください。

 整数 はい
ad_network_source_app_id (1) アドネットワーク アドネットワークが報告した広告掲載元アプリのID。アドネットワークが報告する値で、コストの照合に役立ちます。このデータの基になる情報は、広告掲載元アプリが提供します。 文字列 いいえ
ad_network_channel (1) アドネットワーク   文字列 いいえ
af_prt (1) アドネットワーク   文字列 いいえ
min_revenue  AppsFlyer 注意事項（4）を参照 実数 いいえ
max_revenue  AppsFlyer 注意事項（4）を参照 実数 いいえ
event_revenue AppsFlyer 計算式：［該当イベントの値の合計（USD）］÷［特定の日に発生したイベント数］ 浮動小数点数 はい
min_event_counter AppsFlyer ユーザーがイベントを実行した回数の算出に使用します。注意事項（3）を参照 整数 いいえ
max_event_counter AppsFlyer 注意事項（3）を参照 整数 いいえ
min_time_post_install AppsFlyer 注意事項（5）を参照 整数 いいえ
max_time_post_install AppsFlyer 注意事項（5）を参照 整数 いいえ
af_attribution_flag AppsFlyer SSOT（Single Source of Truth）がオンの場合：trueであれば、AppsFlyerとSKANの両方でインストールがアトリビューションされています。 falseの場合、AppsFlyerではインストールがアトリビューションされていません。 skad_conversion_valueがnullの場合、フラグはモデリングに基づいてtrueまたはfalseに設定されます。 ブール値 いいえ
measurement_window AppsFlyer アクティビティ期間の長さ。デフォルトは24時間です。  整数 いいえ
interval AppsFlyer アクティビティ期間の間隔。  整数 いいえ
user_agent AppsFlyer デバイスのユーザーエージェント 文字列 いいえ
skad_postback_sequence_index 4.0 (iOS 16.2)
  • SKANのウィンドウを表す値で、0、1、2のいずれかです。
  • SKAN 3では、値は0です。
整数 はい
skad_coarse_conversion_value

 

4.0 (iOS 16.2)
  • 値はlow、medium、highのいずれかです。
  • SKAN 3では、値はnullです。
 文字列 はい
skad_source_identifier 4.0 (iOS 16.2)
  • 最大4桁の値です。
  • SKAN 3では、値はnullです。 
 文字列 はい
skad_source_domain 4.0 (iOS 16.2)
  • アトリビューション対象となるWeb広告の流入元を表します。
  • SKAN 3では、値はnullです。
 文字列 はい
ad_network_creative アドネットワーク
  • アドネットワークから受信した追加情報に基づく値です。
  • SKAN 3では、値はnullです。
 文字列 いいえ

**Appleが、プライバシーしきい値の仕組みに基づいて、フィールドに値を設定するかどうかを決定します。

（1）2021年6月2日以降、このフィールドはレポートに含まれますが、必ずしも値が設定されるわけではありません。

（3）ユーザーがアプリ内イベントを実行した回数は、次の式で算出します。[round up (min_event_counter + max_event_counter) / 2]。注意！ 小数点以下を切り上げて、整数にする必要があります。
例：
A. min=0、max=1の場合、平均は0.5となり、切り上げると1になります。
B. min=5、max=10の場合、平均は7.5となり、切り上げると8になります。

（4）収益は常にskad_revenueフィールドで提供されます。 SKAN 4またはカスタムモードでは、イベントに対応する収益範囲をmin_revenueとmax_revenueで確認できます。この範囲を使って、skad_revenueを算出します。

(5)

  • カスタムコンバージョン：AppsFlyerは、ポストバック到着時刻−36時間−average (min_time_post_install + max_time_post_install)としてインストール時刻を算出します。ただし、CV=0の場合、average (min_time_post_install + max_time_post_install)は0と見なします。 
  • デコードコンバージョン：max_time_post_installは、デコードマッピングで設定したhours_from_installと同じ値です。min_time_post_installは、その1時間前の値になります。 
  

補足情報

仕様と制限事項

項目 補足 
アドネットワークのアクセス アドネットワークにはポストバックが提供されます。
代理店のアクセス 利用不可
運用媒体の開示設定 N/A
タイムゾーン UTC
通貨  USD
オーガニックデータ SDKイベントデータに基づきます。たとえば、オーガニックインストール数は、SDKが報告した全インストール数から、SKANが報告したノンオーガニックインストール数を差し引いて算出します。
ノンオーガニックデータ SKANポストバックに基づきます。
データの更新頻度 日次。 SKANのタイミングにより、iOSはウィンドウ終了から24〜48時間後にインストールを報告します。
過去のデータ Data Lockerで取得可能な期間に限られます。 
アカウントユーザーのアクセス 利用できます。アカウントの権限に従います。

 関連情報

Tags