概要:SKANローデータレポートには、AppsFlyerがiOSから受信したポストバックを変換およびデコードしたあとに生成された、行単位のデータと、SKANポストバックのローデータが含まれています。データはData LockerとPush API経由で取得できます。通常のローデータを利用できるプランをご契約の場合は、DataLockerの追加契約は不要です。
SKANローデータレポート
基本仕様:
-
データは以下により提供されます:
-
Data Locker
- 注意!ローデータを利用できるご契約アカウントであれば、本機能を利用できます。つまり、Data Lockerを別途契約する必要はありません。現在Data Lockerを使用していない場合には、広告主アカウントのアドミン権限でData Lockerの設定を行い、SKANレポートを有効にする必要があるので注意してください。これを行うには、 レポート> Data Lockerに移動します。SKANレポートを選択してください。
- データの更新頻度:毎日。 データは、AppsFlyerがポストバックを受信した日付のH=23フォルダに格納されます。
-
Push API
- データ更新頻度:SKANデータのPush APIを参照してください。
-
Data Locker
-
インストール日:ポストバック到着時刻から、AppsFlyerにより次のように導き出されます:
-
ポストバックがSKAN V4の場合:インストール日 = ポストバック到着時間 - [累積ウィンドウの長さ] - [ポストバックの平均遅延時間]
- ポストバック1: インストール日 = ポストバック到着時刻 - 48h - 36h
- ポストバック2: インストール日 = ポストバック到着時刻 - 168h - 84h
- ポストバック3: インストール日 = ポストバック到着時刻 - 840h - 84h
-
ポストバックがSKAN V3の場合:インストール日 = ポストバック到着時間 - 36時間 - [平均最終アクティブ範囲]。
- デフォルトの「平均最終アクティブ範囲」は12時間です。
- コンバージョン値が 0 の場合、最後のアクティブ範囲の平均は 0 に設定されます。
- Googleは独自にインストール時間を見積もり、AppsFlyerはそのインストール時間を使用します。注意:Googleがインストールをレポートするまでには、最長で13日ほどかかることがあります。詳細はこちら
-
ポストバックがSKAN V4の場合:インストール日 = ポストバック到着時間 - [累積ウィンドウの長さ] - [ポストバックの平均遅延時間]
利用可能なレポートタイプ:
- デバイスのポストバック:iOSデバイスから受け取った、インストールまたは再ダウンロード当たり1つのデバイスポストバック
-
SKANローデータ:
- AppsFlyerはデバイスポストバックをローデータの記録にデコードおよび変換します。
- 各ポストバックは、インストールまたは再ダウンロードレコードとアプリ内イベントレコードを生成します。
- アプリ内イベントレコードの数は、次のようにコンバージョン値 (CV) によって異なります:
- CV = 0、空白、または null:アプリ内の記録は生成されていません。
- CV範囲:
- 1-63:SKAN 3 および SKAN 4 ウィンドウ1 の細かい値(Coarse value)の場合、これは計測設定に応じたアプリ内記録の値です。
- Low / medium / high:SKAN 4の粗い値の場合、これは測定設定に応じたアプリ内レコードの数です。
一部の項目が空欄なのはなぜですか? ー 以下のような理由で発生します:
- campaign_name、ad_network_campaign_id、ipなど、アドネットワークから提供されなかった必須ではないエンリッチメント項目。
- Apple側が設けている閾値のポリシーのために、Appleがデータ提供を行わなかった場合。例:source_app_id、skad_campaign_id、skad_conversion_value
SKANローデータレポートの形式と項目
ローデータレポートタイプ
レポートタイプ | レポート名 | 説明 | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ポストバック | Postbacks |
iOSがアドネットワークに送信するポストバック。ポストバックは、アドネットワークによって強化された後、AppsFlyerに転送されます。ポストバック例のCSVをダウンロード 注意:did_win=false の場合、ポストバックは含まれません。 Data Lockerでのトピック名:skad_postbacks |
|||||||||||||||||||||||
ポストバック | ポストバックのコピー(Appleから直接) |
直接iOSからAppsFlyerに送信されたポストバック。 iOS 15以降で利用でき、広告主が成果を獲得したポストバックをAppsFlyerに送信するようにアプリを設定する必要があります。ポストバックコピー例のCSVをダウンロード 注意:このトピックには成果が紐づくポストバックのみが含まれます。 Data Lockerでのトピック名: skad_postbacks_copy |
|||||||||||||||||||||||
デコードされたイベント | Installs |
初回アプリインストール SKANは、redownload=false をレポートします。つまり、Apple IDベースで、初めてアプリをダウンロードしたユーザーであることを示しています。 Data Lockerでのトピック名: skad_installs |
|||||||||||||||||||||||
デコードされたイベント | Redownloads |
初回インストールではないアプリインストール SKANにより redownload=true とレポートされたインストールつまり、Apple IDベースで、再ダウンロードしたユーザーであることを示しています。このレポートはインストールと同じ構成です。 Data Lockerでのトピック名: skad_redownloads |
|||||||||||||||||||||||
デコードされたイベント | In-app events |
In-app events 2021年7月21日より、アプリ内イベントのローデータの提供方法が変更されます(表参照)。 アプリ内イベントの記録数は、お客様の計測設定によって異なります。 Data Lockerでのトピック名: skad_inapps 2021年7月21日以降に受信したiOSのポストバックに対して有効:
2021年7月20日以降に受信したiOSのポストバックに対して有効:
|
|||||||||||||||||||||||
デコードされたイベント | SRN広告ディメンション |
|
ローデータ項目の形式タイプ
各項目のフォーマット
フォーマット名 | 説明 |
---|---|
文字列 (String [n]) | 文字列の最大長。通常、データの受信時に項目長の制限を強制しませんが、その後データが切り捨てられる可能性があります。 |
時間文字列 |
yyyy-mm-dd hh:mm:ss . 例: |
列挙型 (Enum [n]) | 列挙型の項目には特定の値のみが含まれます。 例:Cost currencyは3文字で、指定された通貨コードのみを含むことができます。 |
タイムスタンプ |
10桁のUNIXタイムスタンプが用いられます。例: 2020年8月4日 07:25 UTC は以下のように変換されます: |
ブール値 | 項目の価値は TRUE または FALSE のいずれかです。
|
整数 | 整数 |
Float | 浮動小数点数を表し、小数点を含む実数値が入ります。 |
ポストバックおよびポストバックコピーレポートで利用可能な項目
項目名 | ソースまたはiOSのSKAN開始バージョン | 説明 | 形式 | ポストバックコピーで利用可能 |
---|---|---|---|---|
ad_network_campaign_id | アドネットワーク | アドネットワークからAppsFlyerにレポートされたキャンペーンID | 文字列 | いいえ |
ad_network_campaign _name |
アドネットワーク |
アドネットワークからAppsFlyerへレポートされたキャンペーン名
|
文字列 | いいえ |
ad_network_timestamp | アドネットワーク |
アドネットワークがポストバックを受信した時刻。 Google Adsの場合、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によりレポートされたコンバージョン値。範囲は0〜63です。 nullの場合、iOS自体がこの項目に値を入力しなかったことを示します。** |
整数 | はい |
skad_redownload | 2.0 | true の場合、アプリは再ダウンロードされたことを示す。 | ブール値 | はい |
skad_source_app_id | 2.0 |
サイトID。広告が配信されたアプリのID。この項目は、source_app_idと同じです。 項目の入力は、プライバシーのしきい値によって異なります** |
文字列 | はい |
skad_transaction_id | 1.0 | 文字列 | はい | |
skad_version | 2.0 | 文字列 | はい | |
timestamp | アドネットワーク | AppsFlyerがSKANポストバックを受信した時間 | 時間文字列 | はい |
ad_network_name | アドネットワーク | アドネットワークからAppsFlyerにレポートされたアドネットワーク名。
|
文字列 | いいえ |
ip |
ポストバックを送信するiOSデバイスのHTTPメッセージのIPアドレス。 この項目は、アドネットワークがアドレスを提供する場合にのみ入力されます。 注意!SDKはアドレスの取得には関与しません。 |
文字列 | いいえ | |
skad_app_id | 1.0 | 文字列 | いいえ | |
source_app_id | AppsFlyer | サイトID。広告が配信されたアプリの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) | インストールにアシストまたはアトリビューションされたキャンペーンを区別するために使用されます。
|
ブール値 | はい |
fidelity_type | 2.2 (iOS 14.5) |
アトリビューションに影響する、広告表示方法の違いを区別します。次のように 0と1の値を使用して示されます:
SKANバージョンが2.2より前の場合は項目値を無視します。 |
整数 | はい |
ad_network_source_app_id | アドネットワーク | アドネットワークによってレポートされたパブリッシャーアプリID。コストの調整を支援するために使用します。アドネットワークによってレポートされます。パブリッシャーアプリがこのデータの基礎を提供します。 | 文字列 | いいえ |
ad_network_channel | アドネットワーク | 文字列 | いいえ | |
af_prt | アドネットワーク | 文字列 | いいえ | |
skad_postback_sequence_index | 4.0 (iOS 16.2) |
|
整数 | はい |
skad_coarse_conversion_value |
4.0 (iOS 16.2)
|
|
文字列 | はい |
skad_source_identifier | 4.0 (iOS 16.2) |
|
文字列 | はい |
skad_source_domain | 4.0 (iOS 16.2) |
|
文字列 | はい |
ad_network_creative | アドネットワーク |
|
文字列 | いいえ |
** 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アドレス。 この項目は、アドネットワークがアドレスを提供する場合にのみ入力されます。 注意!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 以降廃止) | AppsFlyer | trueの場合:広告主が管理画面でSKAN 設定を変更してから最初の72時間以内にiOSポストバックが受信されました。SKANが採用しているさまざまなタイマーのため、AppsFlyerはイベントを正確にマッピングできません。
|
ブール値 | いいえ |
skad_attribution_signature | iOS | 文字列 | いいえ | |
skad_campaign_id | iOS | 広告を掲載するために使用されるキャンペーンID。範囲 0~100 | 整数 | いいえ |
skad_conversion_value | iOS |
iOSによりレポートされたコンバージョン値。範囲は0〜63です。 nullの場合、iOS自体がこの項目に値を入力しなかったことを示します。** |
整数 | いいえ |
skad_mode | AppsFlyer | iOSポストバックをデコードするために使用されるコンバージョン計測モード。含まれる値:
|
文字列 | いいえ |
skad_redownload | iOS | trueの場合:アプリは再ダウンロードであることを指します。 | ブール値 | いいえ |
skad_revenue | iOS | イベント収益額(USD) | Float | いいえ |
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 カスタムデコードまたはS2Sでイベント送信を実装するアプリによって設定された文字列が含まれます。 広告主はこれを自社のシステムで使用します。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) | インストールにアシストまたはアトリビューションされたキャンペーンを区別するために使用されます。
|
ブール値 | いいえ |
skad_fidelity_type (1) | 2.2 (iOS 14.5) |
アトリビューションに影響する、広告表示方法の違いを区別します。次のように 0と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)]÷ [特定の日に発生したイベントの数] | Float | はい |
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が有効の場合:true:インストールはAppsFlyerとSKANの両方によってアトリビューションされていることを示します。false:インストールはAppsFyer計測でオーガニックとして計測されていることを示します。skad_conversion_valueがnullの場合:フラグはtrueまたはfalseのいずれかになります(推定値 に基づきます)。 | ブール値 | いいえ |
measurement_window | AppsFlyer | アクティビティ期間の長さ。デフォルト:24時間 | 整数 | いいえ |
interval | AppsFlyer | アクティビティ期間の間隔。 | 整数 | いいえ |
user_agent | AppsFlyer | デバイスのユーザーエージェント | 文字列 | いいえ |
skad_postback_sequence_index | 4.0 (iOS 16.2) |
|
整数 | はい |
skad_coarse_conversion_value |
4.0 (iOS 16.2) |
|
文字列 | はい |
skad_source_identifier | 4.0 (iOS 16.2) |
|
文字列 | はい |
skad_source_domain | 4.0 (iOS 16.2) |
|
文字列 | はい |
ad_network_creative | アドネットワーク |
|
文字列 | いいえ |
** Appleがプライバシーしきい値メカニズムに基づいて、各項目を入力するか否かを判断します (1) 2021年6月2日からこの項目はレポートに追加されましたが、必ずしも値が入力されるとは限りません。 (3) ユーザーが特定のアプリ内イベントを実行した回数を決定するには、数式を使用します: (4) 収益は常に (5)
|
追加情報
特性と制限
特性 | 備考 |
---|---|
アドネットワークのアクセス | アドネットワークにポストバックが提供されます。 |
代理店によるデータアクセス | 利用不可 |
代理店の運用媒体の開示設定 | 該当なし |
タイムゾーン | UTC |
通貨 | USD |
オーガニックデータ | SDKイベントデータに基づく。たとえば、オーガニックインストールの指標は次のように計算されます:SDKがレポートするすべてのインストールデータから、SKAdNetworksがレポートする非オーガニックインストールを差し引きます。 |
非オーガニックデータ | SKANポストバックに基づく |
データ更新頻度 | 毎日。SKANのタイミングとは、期間が終了してから23-48時間後にiOSがインストールをレポートすることを指します。 |
過去データ | Data Lockerの利用可能なデータ保存期間に依存します。 |
アカウントユーザーのアクセス | 利用可能。利用範囲はアカウント権限に基づきます。 |