SKANローデータレポート

概要:SKANローデータレポートには、AppsFlyerがiOSから受信したポストバックを変換およびデコードしたあとに生成された、行単位のデータと、SKANポストバックのローデータが含まれています。データはData LockerPush API経由で取得できます。通常のローデータを利用できるプランをご契約の場合は、DataLockerの追加契約は不要です。  

SKANローデータレポート

基本仕様: 

  • データは以下により提供されます:
    • Data Locker
      • 注意!ローデータを利用できるご契約アカウントであれば、本機能を利用できます。つまり、Data Lockerを別途契約する必要はありません。現在Data Lockerを使用していない場合には、広告主アカウントのアドミン権限でData Lockerの設定を行い、SKANレポートを有効にする必要があるので注意してください。これを行うには、 レポート> Data Lockerに移動します。SKANレポートを選択してください。  
      • データの更新頻度:毎日。 データは、AppsFlyerがポストバックを受信した日付のH=23フォルダに格納されます。 
    • Push API
  • インストール日:ポストバック到着時刻から、AppsFlyerにより次のように導き出されます:
    • ポストバックがSKAN V4の場合:インストール日 = ポストバック到着時間 - [累積ウィンドウの長さ] - [ポストバックの平均遅延時間]
      • ポストバック1: インストール日 = ポストバック到着時刻 - 48h - 36h
      • ポストバック2: インストール日 = ポストバック到着時刻 - 168h - 84h
      • ポストバック3: インストール日 = ポストバック到着時刻 - 840h - 84h
    • ポストバックがSKAN V3の場合:インストール日 = ポストバック到着時間 - 36時間 - [平均最終アクティブ範囲]。
      • デフォルトの「平均最終アクティブ範囲」は12時間です。
      • コンバージョン値が 0 の場合、最後のアクティブ範囲の平均は 0 に設定されます。
    • Googleは独自にインストール時間を見積もり、AppsFlyerはそのインストール時間を使用します。注意:Googleがインストールをレポートするまでには、最長で13日ほどかかることがあります。詳細はこちら

利用可能なレポートタイプ:

  • デバイスのポストバック: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ベースで、初めてアプリをダウンロードしたユーザーであることを示しています。
インストール例のCSVをダウンロードする

Data Lockerでのトピック名: skad_installs

デコードされたイベント Redownloads

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

SKANにより redownload=true とレポートされたインストールつまり、Apple IDベースで、再ダウンロードしたユーザーであることを示しています。このレポートはインストールと同じ構成です。

Data Lockerでのトピック名: skad_redownloads

デコードされたイベント In-app events

In-app events

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

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

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

Data Lockerでのトピック名: skad_inapps

2021年7月21日以降に受信したiOSのポストバックに対して有効:

計測タイプ 説明
収益
  • 特定のユーザーの収益。収益が 0より多い場合、skad_revenue と event_name の項目を含む記録。
  • min_revenue と max_revenue の項目には、お客様のカスタムコンバージョン範囲の値が入力されます。  
アプリ内のコンバージョンとファネルイベント
  • 実行された各ユニークコンバージョンの記録。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 実行された各ユニークコンバージョンの記録。event_name 項目は、名前に応じて値が設定されます。イベントが実行されていない場合は、記録はありません。
エンゲージメント 0-63 レコード数は、ユーザーがエンゲージメントイベントを実行した回数を示します。ユーザーがエンゲージしなかった場合は、エンゲージメントの記録は作成されません。
カスタム 0-無制限 広告主側で設定されたカスタムのコンバージョン値のルールに依存します。 
デコードされたイベント SRN広告ディメンション 
  • レポートには、キャンペーン、広告セット、広告粒度のMeta広告イベントが含まれます。レポートの各行は、インストールイベントまたはアプリ内イベントのいずれかになります。
  • Meta広告からのSKANポストバックには、広告セットと広告の粒度は含まれません。このデータはこのレポート独自のもので、SKANダッシュボード、パフォーマンスAPI、その他のSKAN Data Lockerレポートには表示されません。
  • レポートはスキーマレスです。Data Lockerの項目選択オプションは適用されません。
  • ベストプラクティス:SRNによってデコードされたデータを使用する本レポートと、AppsFlyerによってデコードされたデータを使用する他のレポートとの間には不一致がある可能性があるため、本レポートのデータを他のSKANレポートと組み合わせたり、比較したりしないでください。これらの不一致は、タイムゾーンの違い、SRNスキーマの違い、またはSRN統合でアプリ内イベントをCVに誤ってマッピングしたことが原因である可能性があります。
  • SRN広告ディメンション例のCSVをダウンロード
Data Lockerでのトピック名: skad_srn_advertising_dimensions

ローデータ項目の形式タイプ

各項目のフォーマット

フォーマット名 説明
文字列 (String [n]) 文字列の最大長。通常、データの受信時に項目長の制限を強制しませんが、その後データが切り捨てられる可能性があります。
時間文字列 yyyy-mm-dd hh:mm:ss. 例: 
列挙型 (Enum [n]) 列挙型の項目には特定の値のみが含まれます。 例:Cost currencyは3文字で、指定された通貨コードのみを含むことができます。
タイムスタンプ

10桁のUNIXタイムスタンプが用いられます。例:

2020年8月4日 07:25 UTC は以下のように変換されます:"timestamp": "1596525944"

ブール値 項目の価値は 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にレポートされたアドネットワーク名。 
  • この項目が空白の場合、アドネットワークがそれを入力しなかった(できなかった)ことを意味します。
  • skad_ad_network_id を使用してアドネットワーク名を解決できます。これを行うには、この表を使用してください。 
文字列 いいえ
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) インストールにアシストまたはアトリビューションされたキャンペーンを区別するために使用されます。 
  • trueの場合:キャンペーンはインストールに貢献したとみなされます(ラストタッチアトリビューション獲得)。
  • falseの場合:キャンペーンはラストタッチではないためアトリビューション獲得しなかったとみなされます。SKANダッシュボードやレポートには含まれません。
  • nullの場合、古いiOSバージョンやSKANバージョンだったためiOS自体がこの項目に値を入力しなかったことを示します。
ブール値 はい
fidelity_type 2.2 (iOS 14.5)

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

  • 0:ビュースルー
  • 1:クリックスルー(StoreKitでレンダリングされた広告)

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)

 

  • 値はlowmediumhigh のいずれか。
  • SKAN 3の場合:常に0
文字列 はい
skad_source_identifier 4.0 (iOS 16.2)
  • 値は最大4桁です。
  • SKAN 3の場合:常に0 
文字列 はい
skad_source_domain 4.0 (iOS 16.2)
  • 値は、アトリビューション可能なウェブ広告のソースを示します。
  • SKAN 3の場合:常に0
文字列 はい
ad_network_creative アドネットワーク
  • 値はアドネットワークから取得したデータの拡充に基づいています。
  • SKAN 3の場合:常に0
文字列 いいえ
** 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はイベントを正確にマッピングできません。
  • SKAN 4以降では使用できません。
ブール値 いいえ
skad_attribution_signature iOS   文字列 いいえ
skad_campaign_id iOS 広告を掲載するために使用されるキャンペーンID。範囲 0~100 整数 いいえ
skad_conversion_value iOS

iOSによりレポートされたコンバージョン値。範囲は0〜63です。

nullの場合、iOS自体がこの項目に値を入力しなかったことを示します。**

整数 いいえ
skad_mode AppsFlyer iOSポストバックをデコードするために使用されるコンバージョン計測モード。含まれる値:
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
文字列 いいえ
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) インストールにアシストまたはアトリビューションされたキャンペーンを区別するために使用されます。 
  • trueの場合:キャンペーンはインストールに貢献したとみなされます(ラストタッチアトリビューション獲得)。
  • false の場合:キャンペーンはインストールに貢献していると認識されますが、SKANダッシュボードやレポートには含まれません。
  • nullの場合、古いiOSバージョンやSKANバージョンだったためiOS自体がこの項目に値を入力しなかったことを示します。
ブール値 いいえ
skad_fidelity_type (1) 2.2 (iOS 14.5)

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

  • 0:ビュースルー
  • 1:クリックスルー(StoreKitでレンダリングされた広告)

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)
  • 値はSKAN期間を(0、1、または2)を表します。
  • SKAN 3の場合:常に0
整数 はい
skad_coarse_conversion_value

 

4.0 (iOS 16.2)

  • 値はlowmediumhigh のいずれか。
  • SKAN 3の場合:常に0
文字列 はい
skad_source_identifier 4.0 (iOS 16.2)
  • 値は最大4桁です。
  • SKAN 3の場合:常に0 
文字列 はい
skad_source_domain 4.0 (iOS 16.2)
  • 値は、アトリビューション可能なウェブ広告のソースを示します。
  • SKAN 3の場合:常に0
文字列 はい
ad_network_creative アドネットワーク
  • 値はアドネットワークから取得したデータの拡充に基づいています。
  • SKAN 3の場合:常に0
文字列 いいえ

** 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時間を引いたものと (min_time_post_install + max_time_post_install) の平均でインストール時間を計算します。ただし、CV=0 の場合、(min_time_post_install + max_time_post_install) の平均は 0 として扱われます。 
  • デコードコンバージョン:min_time_post_install は max_time_post_install より1時間少なく、この時間はあなたがデコードコンバージョンマッピングに設定した hours_from_install と同じです。 
 

追加情報

特性と制限

特性 備考 
アドネットワークのアクセス アドネットワークにポストバックが提供されます。
代理店によるデータアクセス 利用不可
代理店の運用媒体の開示設定 該当なし
タイムゾーン UTC
通貨  USD
オーガニックデータ SDKイベントデータに基づく。たとえば、オーガニックインストールの指標は次のように計算されます:SDKがレポートするすべてのインストールデータから、SKAdNetworksがレポートする非オーガニックインストールを差し引きます。
非オーガニックデータ SKANポストバックに基づく
データ更新頻度 毎日。SKANのタイミングとは、期間が終了してから23-48時間後にiOSがインストールをレポートすることを指します。
過去データ Data Lockerの利用可能なデータ保存期間に依存します。 
アカウントユーザーのアクセス 利用可能。利用範囲はアカウント権限に基づきます。