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

ローデータレポート|概要

  • 更新

概要:概要:行レベルデータ(ローデータ)には、インストール、アプリ内イベント、Webサイト訪問、Protect360ブロック済みインストール、広告収益、パートナーに送信されたユーザーに関するポストバックなどのユーザーに関するイベントが記載されています。ローデータレポートは、ダウンロード、API、Data Lockerを介して取得できます。

ローデータレポート|ツールとレポート

ローデータレポートを使用すると、ユーザーの行動やジャーニーの分析、広告ネットワークのアカウントとのデータ照合、CRMやBIシステムのデータ拡充などを行うことができます。ローデータを活用することで、アプリのパフォーマンスをより詳細に分析し、最適化や改善につなげることができます。 

レポートは、各種レポーティングツールを介して利用できます。それぞれのツールには異なる特性があり、用途に応じて使い分けることができます。たとえば、特定の広告ネットワークのアカウントとデータを照合する場合は、必要に応じてデータ出力のページからレポートをダウンロードできます。一方、ユーザーのパフォーマンスデータをBIシステムに取り込む場合は、Data LockerまたはPull APIを使用してプログラムからデータを取得できます。

 ヒント

ローデータについてさらに詳しく知りたい場合は、AppsFlyer Learning Portalの短時間で学べるコースをご覧ください。

レポーティングツール|特性と機能

このセクションでは、レポートの取得に使用できる各レポーティングツールについて説明します。

以下の点にご留意ください:

  • レポートの日付範囲は、イベントが実際に発生した日付(アクティビティベース)に基づきます。これは、日付範囲がLTVベースとなる集計レポートとは異なります。
  • 各項目の説明については、データ項目の手引きをご覧ください。

レポートツール

ツール 説明 複数 / 単一アプリ(1) データ更新(2) スクリプトへの埋め込み タイムゾーン 通貨
ローデータ出力ページ
  • ユーザーインターフェースからレポートをダウンロード
  • 形式:CSVファイル
単一アプリ 継続的に更新 x アプリ設定値 アプリ設定値
Pull API*
  • APIコールを使用してレポートをダウンロード
  • 形式:CSVファイル
単一アプリ 継続的に更新
  • 選択可能
  • デフォルト:UTC
  • 選択可能
  • デフォルト:USD
Data Locker P
  • クラウド上のバケットにデータをストリーミング
  • データ量の制限なし
  • データ保持期間:14日間
  • 形式:CSVまたはParquet
複数 数時間程度の遅延を伴い継続的に更新 UTC USD 
Push API P
  • ユーザージャーニーデータ(インストール、アプリ内イベント、リターゲティング、SKAN)をリアルタイムでお客様のサーバーに送信
  • 形式:JSONまたはクエリのパラメーター
同じエンドポイントを使用可能 AppsFlyerでイベントが記録されてから数分以内 UTC + アプリ固有 USD + アプリ固有
SDK Conversion data(3)
  • アプリ内でアトリビューションのコンバージョンデータを取得
  • 形式:JSON
該当なし 初回アプリ起動から最長8秒以内にユーザーのアトリビューションデータを取得(AppsFlyerサーバーでの処理に最長5秒、それに加えてエンドツーエンドのネットワーク遅延) UTC 該当なし
注記および略語:
(1)複数アプリへの対応
(2)実際のデータ更新頻度はレポートによって異なります。一部のレポートは日次で更新されます。
(3)SDK Conversion dataでは、初回アプリ起動から最長8秒以内にユーザーのアトリビューションデータを取得します(AppsFlyerサーバーでの処理に最長5秒、それに加えてエンドツーエンドのネットワーク遅延)。そのため、この方法は最も精度が低くなります。
(P) Premium機能
(*)レポート生成数の上限が適用されます。

ツールの制限事項

制限  Pull API(*) Push API Data Locker SDK
Conversion data
データ制限 1回のAPIコールにつき100万行 該当なし 該当なし 該当なし
データの選択オプション データタイプを選択可能。項目の選択には制限あり データタイプ、項目、アプリ内イベントを選択可能 データタイプ、項目、アプリ内イベントを選択可能 不可
データ取得可能期間 90日間 該当なし 14日間  無期限(SDK内で利用可能)
(*)レポート生成数の上限が適用されます。

実装に関する考慮事項

注意事項  Pull API Push API Data Locker SDK
Conversion Data
サーバーサイドでの開発 任意 必須 任意 任意
データ処理 任意 必須 任意 任意
データ損失のリスク なし あり(受信側サーバーがダウンしている場合) なし 小(広告ネットワークからのレスポンスに遅延が発生した場合)
クライアント・サーバー間の処理コスト なし なし(データをサーバーに送信する場合を除く)
クライアント・サーバー間のメンテナンス なし なし(データをサーバーに送信する場合を除く)
データ形式 CSVファイル JSONまたはクエリのパラメーター CSVまたはParquet JSON

特定のコンテキストで生成されたローデータレコードは、レポート単位でまとめられます。たとえば、非オーガニックインストールやオーガニックのアプリ内イベントなどです。分かりやすくするため、レポートは以下のように分類されています:

  • ユーザージャーニー:ユーザーがアプリとどのように接触し、エンゲージしたかという一連のジャーニーを追跡するために使用します。
    例:クリック > インストール > アプリ内イベント > アンインストール
  • 機能別:特定のAppsFlyer機能に関連するものの、主要なユーザージャーニーには含まれないレポートです。たとえば、広告ネットワークへのポストバック、不正および検証ルールに関するレポート、ユーザー単位の広告収益レポートなどがあります。

レポート項目

ローデータ項目の手引きには、ユーザージャーニーレポートに関連する項目と、一部の機能別レポートの項目が記載されています。その原則は以下の通りです。

  • ユーザージャーニー:
    • 共通の項目セットがあります。
    • 各項目に値が入力されるかどうかは、ジャーニーのコンテキストによって異なります。たとえば、非オーガニックレポートにはユーザー獲得に貢献したメディアソースが含まれます。 一方、オーガニックレポートにはメディアソースが存在しないため、アトリビューション関連の項目には値が入力されません。 
  • 機能:機能固有の項目セットを持つ場合と、ユーザージャーニーの項目に、その機能に関連する追加項目が含まれる場合があります。たとえば、SKAdNetworkレポートには固有の項目一覧があります。一方、ポストバックレポートにはユーザージャーニーの項目に加えて、パートナーへのポストバック送信に関連する項目が含まれます。 

ヒント:各レポートについて理解するには、実際のレポートを確認するのが最も効果的です。データ出力ページから各種レポートをダウンロードできます。 

分かりやすくするため、ユーザージャーニーの項目はコンテキストに基づいてグループ分けされています。

ユーザージャーニーのローデータ項目グループ

項目グループ オーガニックユーザーとの関連 項目の例
App はい App ID, app name, app version, SDK version, ATT
Attribution なし(Install timeを除く) Install time、Attributed touch time、Media source、Campaign、Adset、Ad、Partner、Retargeting conversion type
Contributors attribution なし Contributor partner, match type
Device info はい Advertising ID, GAID, OAID, device type, customer user ID
Device location はい IP address, city, country
Event はい

アプリ内イベントレポートの場合:

Event name、Event value、Event revenue

ユーザージャーニーレポート

Raw_data_-_User_acquisition_.png

ユーザージャーニーの基本

ユーザージャーニーレポートには、ユーザーのライフタイム中に発生したイベントについて収集されたデータが含まれます。データは、以下の観点に基づいて各レポートに分類されます。

  • ユーザーの流入元:オーガニックまたは非オーガニック
  • ジャーニーのコンテキスト:
    • アプリインストール前の広告とのエンゲージメント(インプレッションおよびクリック)
    • ユーザー獲得
    • リターゲティング

ユーザー獲得(UA)レポートには、以下のデータが含まれます:

  • 広告にエンゲージした潜在ユーザーによる、インストール前のインプレッションとクリック
  • インストールイベント
  • その後ユーザーが実行したアプリ内イベント

リターゲティングレポートには、以下のデータが含まれます:

  • ユーザーがリターゲティングされた際に発生したインプレッションとクリック
  • コンバージョンイベント:リエンゲージメントまたはリアトリビューション
  • リエンゲージメントの一環として、その後ユーザーが実行したアプリ内イベント注意点:

ユーザージャーニーを追跡するには、インストールやアプリ内イベントなど、確認したいジャーニーの区間に関連するレポートを組み合わせます。その後、AppsFlyer ID、イベント時刻、レポートタイプの順にレポートを並べ替えることで、特定のユーザーについて時系列に並んだイベント、つまりユーザージャーニーを確認できます。 

ユーザージャーニーレポートの提供状況

  • レポートの利用可否は、ご利用のサブスクリプションプランによって異なります。
  • レポートには、記載されている内容に応じて、オーガニックユーザー、非オーガニックユーザー、またはその両方のデータが含まれます。
  • 過去のローデータレポートには、使用するレポーティングツールおよびローデータの取得元に応じてデータ保持ポリシーが適用されます。通常、過去90日間のデータを利用できます。注意!データ保持ポリシーは集計データには適用されません。 

ユーザージャーニーレポート

カテゴリ Data Lockerのみ レポート内容 オーガニック 非オーガニック
ユーザー獲得 クリック 該当なし
リターゲティング リターゲティングキャンペーンからのクリック  リターゲティングは常に非オーガニック
ユーザー獲得 インプレッション 該当なし
リターゲティング リターゲティングキャンペーンのインプレッション リターゲティングは常に非オーガニック
ユーザー獲得 - インストール 
ユーザー獲得 - アプリ内イベント 
ユーザー獲得 - アトリビューション済み広告収益 -
ユーザー獲得 - オーガニック広告収益 -
リターゲティング - リターゲティング広告収益 リターゲティングは常に非オーガニック
リターゲティング - リターゲティングコンバージョン(リエンゲージメントとリアトリビューション) リターゲティングは常に非オーガニック
リターゲティング - リターゲティングアプリ内イベント(リエンゲージメントとリアトリビューション) リターゲティングは常に非オーガニック
リターゲティング リターゲティングセッション(リエンゲージメントとリアトリビューション) リターゲティングは常に非オーガニック
ユーザー獲得 セッション
ユーザー獲得 - 非オーガニックアンインストール  -
ユーザー獲得 - オーガニックアンインストール -
ユーザー獲得 クロスプラットフォームエンゲージメント

ユーザージャーニーレポートの詳細

クリックとインプレッション

レポート 特性
コンテクスト ユーザーがキャンペーンにエンゲージし、広告をクリックまたは閲覧した場合
特性 ユーザーが広告をクリックまたは閲覧した際のアトリビューションリンクおよびHTTPヘッダーの記録が含まれます。
ユースケース
  • アプリ起動(インストール、リアトリビューション、リエンゲージメント)につながらないキャンペーンを最適化する
  • 別のキャンペーンを使用して、該当ユーザーをリターゲティングする
サンプルレポート クリック
備考 SRNのデータは利用できません。
制限対象ユーザー プライバシールールにより、インプレッションやクリックのデータが制限される場合があります。この場合、ユーザー識別子が含まれない、またはデータ自体を利用できないことがあります。利用可否は、メディアソースおよびプラットフォームによって異なります。 

インストールとリターゲティングコンバージョン

レポート名 

ユーザー獲得:インストール

リターゲティングデータ:コンバージョン
コンテクスト

ユーザーが初めてアプリを起動したとき。

ユーザーがリターゲティング広告にエンゲージした後、アプリを起動したとき。リターゲティングコンバージョンには、リエンゲージメントまたはリアトリビューションがあります。

リターゲティング計測ガイドを参照してください。
使用事例
  • AppsFlyerの分析ツールでは利用できない項目を使用して、集計レポートを作成する
  • 他のレポートと組み合わせ、高度な横断分析を行う
  • 都市や大都市圏など、さまざまなディメンションでパフォーマンスを分析する 
  • 国、都市、言語に基づいてユーザーをセグメント化し、ターゲティングに活用する リターゲティングに使用するユーザーのデバイスIDを取得する
  • リターゲティングのユースケースも、基本的にはインストールの場合と同様です。
インストールに似ています。
オーガニックと非オーガニック
  • 非オーガニック:AttributionおよびContributors attributionの項目グループに値が入力されます。
  • オーガニック: Media sourceの項目は、空欄、null、またはorganicになります。システムにデータを読み込む際は、この点にご留意ください。 
適用外
サンプルレポート インストール リターゲティングコンバージョンレポートは、インストールレポートと同じ構造です。一部の項目には、リターゲティングのコンテキストに応じた値が入力されます。リターゲティングローデータ をご覧ください。 

アプリ内イベント

レポート 特性
レポートのコンテキスト アトリビューション(インストール、リアトリビューション、リエンゲージメント)後にユーザーが実行したアクションを時系列で表示します。
特性
  • レポートの構造と項目は、インストールレポートと類似しています。
  • イベント専用の項目には、イベント名、値、収益、時刻などの情報が含まれます。 
ユースケース

このレポートは、次の目的で使用します。

  • ユーザーのライフタイム全体にわたるジャーニーを確認し、インサイトを得る
  • インストールとアプリ内イベントのローデータを組み合わせて、ユーザーのジャーニー全体を追跡する 
イベント値

イベント値の項目

には、イベントに関連するすべてのデータがJSON形式で格納されます。BIシステムに読み込んで、さらに詳細な分析を行うことができます。

ヒント:Microsoft ExcelのPower Queryを使用すると、JSONテキスト文字列からイベントパラメーターを解析できます。


{"af_level":"10","af_user_journey":"3387","arena":"7","char_type":"paladin"}

収益のレポート

AppsFlyerの収益およびROIデータは、イベントで送信されたaf_revenueをもとに算出されます。 

アプリ内イベントでaf_revenueパラメーターが送信されると、AppsFlyerはその値を使用してEvent revenueの項目を入力します。この項目の値をもとに、ダッシュボードおよび集計レポートが更新されます。 

注意!af_revenueパラメーターは、実際に発生した収益を表すアプリ内イベントにのみ使用してください。 add_to_cartなど、収益に関連していても最終的な収益確定を表さないイベントでは、af_priceなどの別のパラメーターを使用してください。

サンプルレポート アプリ内イベント
備考
  • リターゲティングのアプリ内イベントは、UAとリターゲティングの両方のアプリ内イベントローデータレポートに二重で記録されます。 
  • アプリ内イベントには、起動イベント(af_app_opened)は含まれません。このイベントは、セッションのローデータレポートで確認できます。 
  • 位置情報は、イベント実行時のユーザーのIPアドレスをもとに判定されます。 

セッション

レポート 特性
コンテクスト ユーザーがアプリを起動すると、セッションイベントがAppsFlyerに送信されます。「セッション間の最短時間」のしきい値を超えている場合にイベントが記録されます。 
特性 レポートの構成は、アプリ内イベントレポートと同じです。セッションイベントは非常に件数が多いため、個別のレポートとして提供されます。
ユースケース アプリに対するユーザーエンゲージメントを把握する
サンプルレポート セッションレポートはアプリ内イベントレポートと類似しています。(注:ローデータでは、セッションのイベント名はlaunchです。) 

アンインストール

レポート 特性
コンテクスト ユーザーによるアプリのアンインストールを記録します。 
特性
  • 他のユーザージャーニーレポートのように継続的に更新されるのではなく、このレポートは1日1回更新されます。 
  • レポートのEvent timeは、実際にアンインストールが行われた時刻ではなく、AppsFlyerがアプリのアンインストールを判定した時刻を表します。詳しくは、アンインストール計測を参照してください。
利用可能な項目
  • ユーザーが非オーガニックのメディアソースから流入している場合、Media source関連の項目に値が入力されます。 
  • アンインストールイベントは、ユーザーがアプリをアンインストールしたとAppsFlyerが判定した後、AppsFlyerサーバーによって生成されます。そのため、多くの項目には値が入力されません。 
  • 利用できるユーザー識別子は、インストール時に記録されたものです。CUIDは利用できません。 
  • 位置情報関連の項目には、ユーザーがメディアソースにエンゲージした時点(クリックまたはインプレッション)の位置情報が入力されます。エンゲージメント時の位置情報を利用できない場合は、インストールイベントに関連付けられた位置情報が使用されます。 
サンプルレポート アンインストール:例を分かりやすくするため、サンプルレポートの2行目には、関連するデータが利用可能な場合に値が入力される項目が示されています。 
ユースケース
  • アンインストールイベント、デバイス、ユーザー属性を分析する
  • リターゲティングに使用するアンインストールユーザーのオーディエンスを作成する

ツール別のユーザージャーニーレポート提供状況

広告エンゲージメントレポート:ツール別 

レポート データ出力 Pull API Data Locker Push API SDK
Conversion Data
インプレッション (1) - - - -
クリック (1) - - - -
(1) クリックおよびインプレッションデータは非SRN媒体から提供されます。SRNではこれらのデータは提供されません。

ユーザー獲得レポート:ツール別 

レポート データ出力 Pull API Data Locker Push API SDK conversion data
インストール
セッション - - - -
アプリ内イベント -
アンインストール - -

リターゲティングローデータレポート:ツール別

レポート データ出力 Pull API Data Locker Push API SDK
conversion Data
クリック (1) - - - -
コンバージョン(リアトリビューション+リエンゲージメント)
インプレッション (1) - - - -
セッション - - - -
アプリ内イベント -
(1) クリックおよびインプレッションデータは非SRN媒体から提供されます。SRNではこれらのデータは提供されません。

よくある質問

詳細

タイムスタンプにはどのような違いがありますか?

タイムスタンプはすべてのレポートで共通しているため、異なるレポート同士を組み合わせることができます。

関連するタイムスタンプは以下のとおりです。 

  • Attributed touch time:ユーザーが広告にエンゲージした時刻
  • Install time:アプリが初めて起動された時刻
  • Event time:イベントが発生した時刻

注意点: 

  • インストールレポートでは、Install timeとEvent timeは同じです。
  • アプリ内イベントレポートでは、Install timeとEvent timeは異なります。その差から、アプリの初回起動からユーザーがアプリ内でエンゲージするまでに経過した時間を確認できます。

Contributorの項目は何のために使用されますか?

Contributorの項目には、コンバージョンに貢献したメディアソースが記録されます。これらはアシストインストールと呼ばれることもあります。Protect360では、この項目はハイジャックされたインストールのアトリビューション修正にも使用されます。

Keywordsの項目は何を指しますか?なぜ、すべての非オーガニックインストールで利用できないのですか?

Google AdsまたはApple Adsにアトリビューションされたインストールには、そのインストールにつながった広告に関連するキーワードまたはKeyword IDが含まれる場合があります。 

インストールレポート活用のヒント

ユーザージャーニーの理解

ユーザージャーニーとは、商品の購入や航空券の予約など、特定の目標を達成するまでにユーザーが行う一連のステップのことです。ユーザージャーニーを分析する目的は、ユーザーがアプリ内でどのような行動を取っているか、どの程度アクティブであるか、そして一定期間にどの程度の価値をもたらしているかを把握することです。

AppsFlyer IDを使用すると、ユーザージャーニーを特定して可視化できます。AppsFlyer IDは、デバイスごとのアプリインストールに対して生成されます。このIDは、インストールからアンインストールまで、ユーザーのライフサイクルを通じて変更されません。また、ユーザーがデバイスIDをリセットした場合でも、AppsFlyer IDは保持されます。

インストールレポートとアプリ内イベントレポートは同じ構造を持つため、1つのレポートに統合できます。統合したレポートでは、AppsFlyer IDおよびCustomer User ID(利用可能な場合)を使用して集計やフィルタリングを行い、ユーザージャーニーを分析できます。

 例

アプリとのエンゲージメントが強いユーザー

  • ユーザーが8月20日9:31にアプリをインストールしました。
  • 統合レポートを見ると、8月20日10:31、8月22日15:22、8月25日16:47に購入を行っています。
  • この結果から、このユーザーはエンゲージメントの高いユーザーであると判断できます。アプリを起動してから1時間後に購入し、その後もインストール後の数日間にわたって購入を継続しています。

アプリとのエンゲージメントが弱いユーザー

  • ユーザーが7月30日にアプリをインストールしました。統合レポートを見ると、8月15日に商品をカートへ追加していますが、その後の購入イベントはありません。
  • このユーザーは購入をためらっている可能性があると判断し、カートに追加した商品を使用してリターゲティングすることができます。

キャンペーン最適化のためのユーザージャーニー分析

  • 旅行アプリのユーザー獲得(UA)担当者が、インストールレポートとアプリ内イベントレポートをダウンロードして統合します。
  • 次に、アプリ内のユーザージャーニーを確認するため、AppsFlyer IDを使用してデータをフィルタリングまたは集計します。
  • AppsFlyer IDで特定されたあるユーザーが、12か月前にアプリをダウンロードし、その数日後に航空券を予約していたことが分かりました。
  • その後、このユーザーはいくつかの航空券情報を閲覧したものの、予約には至っていませんでした。さらに調査を進めたところ、UA担当者は同じような行動パターンを持つユーザーが他にもいることを発見し、より詳しく分析することにしました。
  • その結果、これらのユーザーの多くが、メディアソースCで配信されたキャンペーンB広告Aから流入していることが分かりました。この広告とキャンペーンは、特定の目的地への旅行を希望するユーザーをターゲットとしていました。
  • ユーザージャーニーを分析することで、UA担当者は、このキャンペーンのターゲティング範囲が狭すぎたこと、またユーザーがアプリに十分エンゲージしていなかった可能性があると判断できます。

機能別レポート

プラットフォームで利用できる追加機能に関連するレポートです。

ポストバック

ポストバックレポートでは、広告ネットワークに送信されたデータのコピーを確認できます。たとえば、データの乖離を調査する際に利用できます。これらのレポートは情報確認を目的としたものであり、広告ネットワークとの連携に必須ではありません。

ポストバックレポート(Export DataページおよびPull APIから利用可能)

レポート内容 成果が紐づくメディアソースに送信されるイベント
インストール 非オーガニック (UA) インストール
アプリ内イベント 非オーガニックのアプリ内イベント
リターゲティングコンバージョンポストバック リターゲティング(リエンゲージメントとリアトリビューション)
リターゲティングアプリ内イベント  リターゲティングアプリ内イベント

ポストバックレポートの追加項目

項目 備考
Postback URL 収益など、一部の値は該当する項目に表示されない場合がありますが、Postback URL内で確認できます。
Postback method  
Postback HTTP response code 200:広告ネットワークがポストバックを受信したことを示します。
Postback error message    

Protect360と検証ルール

  • Protect360検証ルールのローデータレポートを参照してください。
  • 広告ネットワークおよび代理店がProtect360と検証ルールのレポートにアクセスするには、広告主から権限を付与してもらう必要があります。

連携済みパートナーにProtect360へのアクセス権限を付与するには、以下の手順を実行します。

  1. 連携 > Active Integrationsに移動します。 
  2. 該当の媒体を選択します。
  3. 権限タブにて、Protect360管理画面とAPIでのローデータへのアクセスを許可するをオンにします。
  4. アプリ内イベント(CPA)ダッシュボードへのアクセスも許可する場合は、アプリ内イベントの集計データへのアクセスも有効にします。