SKANローデータレポート

概要:SKANローデータレポートには、AppsFlyerがiOSから受信したポストバックを変換およびデコードしたあとに生成された、行単位のデータと、SKANポストバックのローデータが含まれています。データは、Data LockerPush APIで利用できます。ご利用中のプランにローデータが含まれる場合、Data Lockerのサブスクリプションは必要ありません。

関連記事利用できるSKANレポート

SKANローデータレポート

仕組み:

  • データは以下により提供されます:
    • Data Locker
      • 注!ローデータを利用できるアカウントで利用できます。つまり、Data Lockerをサブスクリプションする必要はありません。Data Lockerを使用していない場合は、アドミンがData Lockerを設定し、SKANレポートを有効にする必要があります。この手順は、まず設定 > Data Lockerへ移動してください。SKANレポートを選択してください。
      • データ更新頻度:毎日。データは、AppsFlyerがポストバックを受信した日付のh=23フォルダに格納されます。例:ポストバックを月曜に受信した場合、その日の終わりに処理されます。処理は、火曜日の12:00 UTCまでに完了し、データは月曜の h=23 フォルダに書き込まれます。
    • Push API
  • インストール日
    • インストール日はポストバック到着時刻から算出されます。
    • デフォルトでは、インストール時刻はポストバック到着から48時間前です。そのため、レポートには複数日のインストールが含まれることがあります。
    • なお、カスタムコンバージョン値を使用する場合、インストール時刻の算出式は以下です:
      ポストバック時刻-24時間-hours_from_install

利用できるレポートタイプは次のとおりです。

  • デバイスポストバック:iOSデバイスから受け取った、インストールまたは再ダウンロード当たり1つのデバイスポストバック
  • SKANローデータ
    • AppsFlyerはデバイスポストバックをローデータの記録にデコードおよび変換します。
    • 各ポストバックは、インストールまたは再ダウンロードレコードとアプリ内イベントレコードを生成します。
    • アプリ内イベントレコードの数は、次のようにコンバージョン値 (CV) によって異なります。
      • CV = 0、空白、または null:アプリ内レポートは生成されませんでした。
      • CV 範囲 1-63:アプリ内イベントの記録数は計測設定により異なります。 

一部のフィールドが空欄なのはなぜですか?これは、以下のような理由で発生します。

  • 必須ではない追加情報のフィールドで、アドネットワークが提供してなかった場合
    例:campaign_name、ad_network_campaign_id、ipなど
  • Apple側が設けている閾値のポリシーのために、Appleがデータ提供を行わなかった場合。例えば、source_app_id、skad_campaign_id、skad_conversion_value 

レポートタイプ

レポートタイプ Event type 説明
ポストバック iOSからのポストバック

iOSからAppsFlyerに送信されたデバイスポストバックのコピー(ポストバックはアドネットワーク経由で送信されます)。ポストバックの例をダウンロードする (CSV)

Data Lockerでのトピック名:skad_postbacks

イベントのデコード インストール

初回アプリインストール

SKANは、redownload=false をレポートします。つまり、このApple IDで表されるユーザーは、初めてアプリをダウンロードしたユーザーであることを示しています。インストールの例をダウンロードする (CSV)

Data Lockerでのトピック名: skad_installs

イベントのデコード 再ダウンロード

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

SKANは、redownload=true とレポートします。つまり、このApple IDで表されるユーザーは、初めてアプリをダウンロードしたユーザーではないことを示しています。このレポートはインストールと同じ構成です。

Data Lockerでのトピック名:skad_redownloads

イベントのデコード In-app events

In-app events

2021年7月21日より、アプリ内イベントのローデータの提供方法が変更されます(表参照)。

アプリ内イベントの記録数は、お客様の計測設定によって異なります。

アプリ内イベントの例をダウンロードする (CSV)

測定タイプ 説明
収益
  • 特定のユーザーの収益。収益が >0 の場合、skad_revenue と event_name の項目を含むレコード。
  • min_revenue と max_revenue の項目には、お客様のカスタムコンバージョン範囲の値が入力されます。ほとんどの場合、それらを考慮する必要はありません。
アプリ内のコンバージョンとファネルイベント
  • 実行された各ユニークコンバージョンの記録。event_name 項目は、名前に応じて値が設定されます。イベントが実行されていない場合は、記録はありません。
  • コンバージョンイベントは、min_event_counter = 0、max_event_counter = 1です。
アプリ内エンゲージメント ユーザーが特定のアプリ内イベントを実行した回数を調べるには、[繰り上げ(min_event_counter + max_event_counter) / 2] という式を使用してください。
2021年7月21日以降に受信したiOSのポストバックに対して有効

 

測定タイプ レコード数 説明
収益 0-1 収益が >0 の場合、skad_revenue と event_name の項目を含むレコード。
コンバージョン

0-6

実行された各ユニークコンバージョンの記録。event_name 項目は、名前に応じて値が設定されます。イベントが実行されていない場合は、記録はありません。
エンゲージメント

0-63

レコード数は、ユーザーがエンゲージメントイベントを実行した回数を示します。ユーザーがエンゲージしない場合は、エンゲージメントの記録は作成されません。
カスタム 0-無制限 広告主側で設定されたカスタムのコンバージョン値のルールに依存します。
2021年7月21日以降に受信したiOSのポストバックに対して有効です。

SKANローデータの項目

項目の形式
項目名 説明
文字列 (String) [n]

文字列の最大長。通常、データの受信時にフィールド長の制限を強制しませんが、その後データが切り捨てられる可能性があります。

時間文字列

次の形式を持つ文字列:yyyy-mm-dd hh:mm:ss
例えば、
2019-09-17 00:09:25 

列挙型 (Enum) [n] 列挙型の項目には、特定の値のみを含めることができます。例えば、Cost currencyは3文字で、指定された通貨コードのみを含むことができます。
タイムスタンプ

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

2020年8月4日 07:25 (UTC)の場合: "timestamp": "1596525944"

Boolean

項目の値は、TRUE または FALSE のいずれかです。

ポストバックローデータの項目
カラム名 ソースまたはiOSのSKAN開始バージョン 説明 形式

ad_network_campaign_id

アドネットワーク アドネットワークからAppsFlyerにレポートされたキャンペーンID String

ad_network_campaign

_name

アドネットワーク

アドネットワークからAppsFlyerにレポートされたキャンペーンID

 

String

ad_network_timestamp

アドネットワーク

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

Google Adsの場合、Googleが報告する時刻はラストクリック時刻から算出されます。

タイムスタンプ

app_id

AppsFlyer プレフィックス「ID」を含むアプリID(広告主アプリ) String

city

AppsFlyer*   String

country_code

AppsFlyer*   String

dma

AppsFlyer*   String

postal_code

AppsFlyer*   String

region

AppsFlyer*   String

skad_ad_network_id

1.0 
  • ポストバックが送信されたアドネットワークのID
  • 一部のSRNは彼らのIDを共有せず、この項目は空白になります。例:Twitter。
String

skad_attribution_signature

1.0   String
skad_campaign_id 1.0 広告を公開するために使用されるキャンペーンID。範囲:0-100 String
skad_conversion_value 2.0 

iOSからレポートされるコンバージョン値。範囲:0-63

項目の入力は、プライバシーのしきい値によって異なります**

Integer
skad_redownload 2.0 true の場合、アプリは再ダウンロードされたことを示す。 String
skad_source_app_id 2.0

サイトID。広告を掲載するアプリ。この項目は、source_app_idと同じです。

項目の入力は、プライバシーのしきい値によって異なります**

String
skad_transaction_id 1.0   String
skad_version 2.0   String
timestamp アドネットワーク

iOSデバイスがポストバックを送信した時間。

Google広告の場合、Google Adsが報告する時刻はラストクリック時刻から算出されます。

時間文字列
ad_network_name アドネットワーク

アドネットワークからAppsFlyerにレポートされたアドネットワーク名 

  • このフィールドが空のときは、アドネットワークが入力しなかった(できなかった)場合です。
  • skad_ad_network_idの値を使用することで、アドネットワーク名を補完可能です。この表を利用してください。 
String
ip  

ポストバックを送信するiOSデバイスのHTTPメッセージのIPアドレス。

この項目は、アドネットワークがアドレスを提供する場合にのみ入力されます。

注!SDKはアドレスの取得には関与しません。

String

skad_app_id

1.0   String

source_app_id

AppsFlyer サイトID。広告を掲載するアプリ。この項目は、skad_source_app_id と同じです。 String

ad_network_adset_id

アドネットワーク   String

ad_network_adset_name

アドネットワーク   String

ad_network_ad_name

アドネットワーク   String

ad_network_ad_id

アドネットワーク   String

did_win (1)

3.0 (iOS 14.6)

インストールに貢献または成果が紐づくキャンペーンを区別するのに使用されます。

  • true の場合、インストールをもたらした成果がこのキャンペーンに紐づいています。
  • false の場合、キャンペーンはインストールに貢献したことを示しています。
Boolean

fidelity_type (1)

2.2 (iOS 14.5)

アトリビューションに影響する、広告表示方法の違いを区別します。0 / 1の値を使用して以下のように指定されます: 

  • ビュースルー広告 (0)
  • ストアキットレンダリング広告 (1)

SKANバージョンが2.2より前の場合は、項目の値を無視してください。

Integer

ad_network_source_app_id (1)

アドネットワーク アドネットワークによりレポートされたパブリッシャーのアプリID。コストの調整に使用してください。アドネットワークによりレポートされます。パブリッシャーアプリがこのデータの基礎を提供します。 String

ad_network_channel (1)

アドネットワーク   String

af_prt (1)

アドネットワーク   String

* iOSから送信されたポストバックの送信元IPアドレスを使用して生成されます

** Appleがプライバシーしきい値メカニズムに基づいて、各項目を入力するか否かを判断します

(1) 2021年6月2日からこのフィールドはレポートに追加されましたが、必ずしも値が入力されるとは限りません。 

 

デコードされたイベントのローデータ項目
カラム名 データソース 説明 形式
ad_network_campaign_id アドネットワーク アドネットワークからAppsFlyerにレポートされたキャンペーンID String
ad_network_campaign
_name
アドネットワーク アドネットワークからAppsFlyerにレポートされたキャンペーンID String
ad_network_timestamp アドネットワーク

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

Google Adsの場合、この項目は入力されません。

タイムスタンプ
app_id iOS App ID (広告主アプリ) String
city AppsFlyer*   String
country_code AppsFlyer*   String
dma AppsFlyer*   String
event_name AppsFlyer アプリ内イベント名 String
event_uuid AppsFlyer 重複したポストバックを識別できるようにする、ユニークな識別子です。 String
install_date iOS updateConversion 期間に基づきAppsFlyerが推定 時間文字列
install_type iOS 新規インストール String
ip iOS

ポストバックを送信するiOSデバイスのHTTPメッセージのIPアドレス。

この項目は、アドネットワークがアドレスを提供する場合にのみ入力されます。

注!SDKはアドレスの取得には関与しません。

string
media_source iOS AppsFlyerネットワーク名を使用して紐づけられるアドネットワーク String
postal_code AppsFlyer*   String
region AppsFlyer*   String
skad_ad_network_id iOS ポストバックが送信されたアドネットワークのID String
skad_ambiguous _event AppsFlyer true の場合、広告主が管理画面上でSKANの設定を変更してから最初の72時間以内にiOSポストバックを受信したことを示します。SKANで採用されている様々なタイマーの仕様により、AppsFlyerではこのイベントを正確にマッピングすることはできません。 Boolean
skad_attribution_signature iOS   String
skad_campaign_id iOS 広告を公開するために使用されるキャンペーンID。範囲:0-100 String
skad_conversion_value iOS

iOSからレポートされるコンバージョン値。範囲:0-63

項目の入力は、プライバシーのしきい値によって異なります**

Integer
skad_mode AppsFlyer iOSポストバックをデコードするために使用されたコンバージョン計測モード設定される値:single、split、またはcustom String
skad_redownload iOS true の場合、アプリは再ダウンロードされたことを示します。 String
skad_revenue iOS USDでのイベント収益額。 String
skad_source_app_id iOS

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

項目の入力は、プライバシーのしきい値によって異なります**

String
skad_transaction_id iOS - String
skad_version iOS - String
timestamp iOS

iOSデバイスから送信されたポストバックの時刻。

Google広告の場合、Google Adsが報告する時刻はラストクリック時刻から算出されます。

タイムスタンプ
event_value S2S

デフォルト値:null

カスタムデコード、またはS2S経由のイベント送信を実装しているアプリによって設定された文字列が含まれます。 

広告主側のシステムで利用しているもので、AppsFlyer側では利用していません。 

String (JSON)

ad_network_adset_id

アドネットワーク   String

ad_network_adset_name

アドネットワーク   String

ad_network_ad_name

アドネットワーク   String

ad_network_ad_id

アドネットワーク

 

String

skad_did_win (1)

3.0 (iOS 14.6)

インストールに貢献または成果が紐づくキャンペーンを区別するのに使用されます。

  • true の場合、インストールをもたらした成果がこのキャンペーンに紐づいています。
  • false の場合、キャンペーンはインストールに貢献したことを示しています。
Boolean

skad_fidelity_type (1)

2.2 (iOS 14.5)

アトリビューションに影響する、広告表示方法の違いを区別します。0 / 1の値を使用して以下のように指定されます: 

  • ビュースルー広告 (0)
  • ストアキットレンダリング広告 (1)

SKANバージョンが2.2より前の場合は、項目の値を無視してください。

Integer

ad_network_source_app_id (1)

アドネットワーク アドネットワークによりレポートされたパブリッシャーのアプリID。コストの調整に使用してください。アドネットワークによりレポートされます。このデータの基礎はパブリッシャーアプリにより提供されます。 String

ad_network_channel (1)

アドネットワーク   String

af_prt (1)

アドネットワーク   String

min_revenue (2)

AppsFlyer 注 (4) を参照してください 実数

max_revenue (2)

AppsFlyer 注 (4) を参照してください 実数

min_event_counter (2)

AppsFlyer ユーザーがイベントを実行した回数を計算するために使用します。注 (3) を参照してください Integer

max_event_counter (2)

AppsFlyer 注 (3) を参照してください Integer

min_time_post_install (2)

AppsFlyer 注 (5) を参照してください Integer

max_time_post_install (2)

AppsFlyer 注 (5) を参照してください Integer

* iOSから送信されたポストバックの送信元IPアドレスを使用して生成されます

** Appleがプライバシーしきい値メカニズムに基づいて、各項目を入力するか否かを判断します

  1. 2021年6月2日からこのフィールドはレポートに追加されましたが、必ずしも値が入力されるとは限りません。 
  2. 2021年7月21日からは、項目に入力されることがあります。
  3. ユーザーが特定のアプリ内イベントを実行する回数を調べるには、[繰り上げ(min_event_counter + max_event_counter) / 2] という式を使用してください。注!値は最も近い整数に繰り上げる必要があります。
    例:
    A. 最小値=0、最大値=1の場合、平均値は0.5で、繰り上げられた結果は1になります。
    B. 最小値=5、最大値=10の場合、平均値は7.5で、繰り上げられた結果は8になります。
  4. 収益は常に項目 skad_revenue で提供されます。カスタムコンバージョンを使用する場合、イベントに関連付けられ、skad_revenue の計算に使用されるバケットの範囲は、min_revenue と max_revenue で記述されます。
  5. カスタムコンバージョンでは、AppsFlyerはインストール時刻を、「ポストバック到着時刻 - min_time_post_install の平均 + max_time_post_install」として計算します。

特性と制限

SKANソリューション
特性 備考
アドネットワークのアクセス アドネットワークはポストバックを受信します
代理店アクセス 利用不可
代理店への運用詳細の開示 N/A
タイムゾーン UTC
通貨 USD
オーガニックデータ SDKイベントデータに基づきます。例えば、オーガニックインストールの指標は次のように計算されます。SDKによって報告されたすべてのインストールのデータから、SKANによって報告された非オーガニックインストールの数を差引きます。
非オーガニックデータ SKANポストバックに基づく
データ更新頻度

毎日。SKANのタイミングとは、アプリの初回起動から48~72時間後にiOSがインストールをレポートします。

過去データ

最も早い日付は、iOS 14が利用できる日です(2020年9月16日)

チームメンバーアクセス 利用可能です。利用範囲はアカウント権限に基づきます。
この記事は役に立ちましたか?