概要:概要:行レベルデータ(ローデータ)には、インストール、アプリ内イベント、Webサイト訪問、Protect360ブロック済みインストール、広告収益、パートナーに送信されたユーザーに関するポストバックなどのユーザーに関するイベントが記載されています。ローデータレポートは、ダウンロード、API、Data Lockerを介して取得できます。
ローデータレポート|ツールとレポート
ローデータレポートを使用すると、ユーザーの行動やジャーニーの分析、広告ネットワークのアカウントとのデータ照合、CRMやBIシステムのデータ拡充などを行うことができます。ローデータを活用することで、アプリのパフォーマンスをより詳細に分析し、最適化や改善につなげることができます。
レポートは、各種レポーティングツールを介して利用できます。それぞれのツールには異なる特性があり、用途に応じて使い分けることができます。たとえば、特定の広告ネットワークのアカウントとデータを照合する場合は、必要に応じてデータ出力のページからレポートをダウンロードできます。一方、ユーザーのパフォーマンスデータをBIシステムに取り込む場合は、Data LockerまたはPull APIを使用してプログラムからデータを取得できます。
ヒント
ローデータについてさらに詳しく知りたい場合は、AppsFlyer Learning Portalの短時間で学べるコースをご覧ください。
レポーティングツール|特性と機能
このセクションでは、レポートの取得に使用できる各レポーティングツールについて説明します。
以下の点にご留意ください:
- レポートの日付範囲は、イベントが実際に発生した日付(アクティビティベース)に基づきます。これは、日付範囲がLTVベースとなる集計レポートとは異なります。
- 各項目の説明については、データ項目の手引きをご覧ください。
レポートツール
| ツール | 説明 | 複数 / 単一アプリ(1) | データ更新(2) | スクリプトへの埋め込み | タイムゾーン | 通貨 |
|---|---|---|---|---|---|---|
| ローデータ出力ページ |
|
単一アプリ | 継続的に更新 | x | アプリ設定値 | アプリ設定値 |
| Pull API* |
|
単一アプリ | 継続的に更新 | ✓ |
|
|
| Data Locker P |
|
複数 | 数時間程度の遅延を伴い継続的に更新 | ✓ | UTC | USD |
| Push API P |
|
同じエンドポイントを使用可能 | AppsFlyerでイベントが記録されてから数分以内 | ✓ | UTC + アプリ固有 | USD + アプリ固有 |
| SDK Conversion data(3) |
|
該当なし | 初回アプリ起動から最長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 |
ユーザージャーニーレポート
ユーザージャーニーの基本
ユーザージャーニーレポートには、ユーザーのライフタイム中に発生したイベントについて収集されたデータが含まれます。データは、以下の観点に基づいて各レポートに分類されます。
- ユーザーの流入元:オーガニックまたは非オーガニック
- ジャーニーのコンテキスト:
- アプリインストール前の広告とのエンゲージメント(インプレッションおよびクリック)
- ユーザー獲得
- リターゲティング
ユーザー獲得(UA)レポートには、以下のデータが含まれます:
- 広告にエンゲージした潜在ユーザーによる、インストール前のインプレッションとクリック
- インストールイベント
- その後ユーザーが実行したアプリ内イベント
リターゲティングレポートには、以下のデータが含まれます:
- ユーザーがリターゲティングされた際に発生したインプレッションとクリック
- コンバージョンイベント:リエンゲージメントまたはリアトリビューション
- リエンゲージメントの一環として、その後ユーザーが実行したアプリ内イベント注意点:
- リターゲティングデータは常に非オーガニックです。
-
リターゲティングのアプリ内イベントは、UAのアプリ内イベントレポートとリターゲティングのアプリ内イベントレポートの両方に含まれます。詳しくは詳しくは、リターゲティングの二重アトリビューションの仕組みをご覧ください。
ユーザージャーニーを追跡するには、インストールやアプリ内イベントなど、確認したいジャーニーの区間に関連するレポートを組み合わせます。その後、AppsFlyer ID、イベント時刻、レポートタイプの順にレポートを並べ替えることで、特定のユーザーについて時系列に並んだイベント、つまりユーザージャーニーを確認できます。
ユーザージャーニーレポートの提供状況
- レポートの利用可否は、ご利用のサブスクリプションプランによって異なります。
- レポートには、記載されている内容に応じて、オーガニックユーザー、非オーガニックユーザー、またはその両方のデータが含まれます。
- 過去のローデータレポートには、使用するレポーティングツールおよびローデータの取得元に応じてデータ保持ポリシーが適用されます。通常、過去90日間のデータを利用できます。注意!データ保持ポリシーは集計データには適用されません。
ユーザージャーニーレポート
| カテゴリ | Data Lockerのみ | レポート内容 | オーガニック | 非オーガニック |
|---|---|---|---|---|
| ユーザー獲得 | ✓ | クリック | 該当なし | |
| リターゲティング | ✓ | リターゲティングキャンペーンからのクリック | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | ✓ | インプレッション | 該当なし | |
| リターゲティング | ✓ | リターゲティングキャンペーンのインプレッション | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | - | インストール | ✓ | ✓ |
| ユーザー獲得 | - | アプリ内イベント | ✓ | ✓ |
| ユーザー獲得 | - | アトリビューション済み広告収益 | - | ✓ |
| ユーザー獲得 | - | オーガニック広告収益 | ✓ | - |
| リターゲティング | - | リターゲティング広告収益 | リターゲティングは常に非オーガニック | |
| リターゲティング | - | リターゲティングコンバージョン(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| リターゲティング | - | リターゲティングアプリ内イベント(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| リターゲティング | ✓ | リターゲティングセッション(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | ✓ | セッション | ✓ | ✓ |
| ユーザー獲得 | - | 非オーガニックアンインストール | - | ✓ |
| ユーザー獲得 | - | オーガニックアンインストール | ✓ | - |
| ユーザー獲得 | ✓ | クロスプラットフォームエンゲージメント | ✓ | ✓ |
ユーザージャーニーレポートの詳細
クリックとインプレッション
| レポート | 特性 |
|---|---|
| コンテクスト | ユーザーがキャンペーンにエンゲージし、広告をクリックまたは閲覧した場合 |
| 特性 | ユーザーが広告をクリックまたは閲覧した際のアトリビューションリンクおよびHTTPヘッダーの記録が含まれます。 |
| ユースケース |
|
| サンプルレポート | クリック |
| 備考 | SRNのデータは利用できません。 |
| 制限対象ユーザー | プライバシールールにより、インプレッションやクリックのデータが制限される場合があります。この場合、ユーザー識別子が含まれない、またはデータ自体を利用できないことがあります。利用可否は、メディアソースおよびプラットフォームによって異なります。 |
インストールとリターゲティングコンバージョン
| レポート名 |
ユーザー獲得:インストール |
リターゲティングデータ:コンバージョン |
|---|---|---|
| コンテクスト |
ユーザーが初めてアプリを起動したとき。 |
ユーザーがリターゲティング広告にエンゲージした後、アプリを起動したとき。リターゲティングコンバージョンには、リエンゲージメントまたはリアトリビューションがあります。 リターゲティング計測ガイドを参照してください。 |
| 使用事例 |
|
インストールに似ています。 |
| オーガニックと非オーガニック |
|
適用外 |
| サンプルレポート | インストール | リターゲティングコンバージョンレポートは、インストールレポートと同じ構造です。一部の項目には、リターゲティングのコンテキストに応じた値が入力されます。リターゲティングローデータ をご覧ください。 |
アプリ内イベント
| レポート | 特性 |
|---|---|
| レポートのコンテキスト | アトリビューション(インストール、リアトリビューション、リエンゲージメント)後にユーザーが実行したアクションを時系列で表示します。 |
| 特性 |
|
| ユースケース |
このレポートは、次の目的で使用します。
|
| イベント値 |
イベント値の項目 には、イベントに関連するすべてのデータがJSON形式で格納されます。BIシステムに読み込んで、さらに詳細な分析を行うことができます。 ヒント:Microsoft ExcelのPower Queryを使用すると、JSONテキスト文字列からイベントパラメーターを解析できます。
収益のレポート AppsFlyerの収益およびROIデータは、イベントで送信されたaf_revenueをもとに算出されます。 アプリ内イベントでaf_revenueパラメーターが送信されると、AppsFlyerはその値を使用してEvent revenueの項目を入力します。この項目の値をもとに、ダッシュボードおよび集計レポートが更新されます。 注意!af_revenueパラメーターは、実際に発生した収益を表すアプリ内イベントにのみ使用してください。 add_to_cartなど、収益に関連していても最終的な収益確定を表さないイベントでは、af_priceなどの別のパラメーターを使用してください。 |
| サンプルレポート | アプリ内イベント |
| 備考 |
|
セッション
| レポート | 特性 |
|---|---|
| コンテクスト | ユーザーがアプリを起動すると、セッションイベントがAppsFlyerに送信されます。「セッション間の最短時間」のしきい値を超えている場合にイベントが記録されます。 |
| 特性 | レポートの構成は、アプリ内イベントレポートと同じです。セッションイベントは非常に件数が多いため、個別のレポートとして提供されます。 |
| ユースケース | アプリに対するユーザーエンゲージメントを把握する |
| サンプルレポート | セッションレポートはアプリ内イベントレポートと類似しています。(注:ローデータでは、セッションのイベント名はlaunchです。) |
アンインストール
| レポート | 特性 |
|---|---|
| コンテクスト | ユーザーによるアプリのアンインストールを記録します。 |
| 特性 |
|
| 利用可能な項目 |
|
| サンプルレポート | アンインストール:例を分かりやすくするため、サンプルレポートの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ではこれらのデータは提供されません。 | |||||
よくある質問
| 詳細 |
|---|
|
タイムスタンプにはどのような違いがありますか? タイムスタンプはすべてのレポートで共通しているため、異なるレポート同士を組み合わせることができます。 関連するタイムスタンプは以下のとおりです。
注意点:
|
|
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担当者は、このキャンペーンのターゲティング範囲が狭すぎたこと、またユーザーがアプリに十分エンゲージしていなかった可能性があると判断できます。
機能別レポート
プラットフォームで利用できる追加機能に関連するレポートです。
ポストバック
ポストバックレポートでは、広告ネットワークに送信されたデータのコピーを確認できます。たとえば、データの乖離を調査する際に利用できます。これらのレポートは情報確認を目的としたものであり、広告ネットワークとの連携に必須ではありません。
- レポートには、以下のデータが含まれます。
- アトリビューションされたメディアソースに送信されたポストバックのコピー
- ローデータ項目、およびこのセクションで説明する追加項目
- 一方、ポストバックレポートに以下のデータは含まれません。
- SRNのインストール
- Meta Ads、X Ads、Apple Adsに関連するアプリ内イベント
- アトリビューションされていないパートナーのポストバック詳しくは、「他のパートナーまたはオーガニックに紐づいたイベント」をご覧ください。
- オーガニックユーザーのデータ。詳しくは、オーガニックユーザーについてを参照してください。
- 2021年3月以降、各項目の値は広告ネットワークの高プライバシーポストバックの設定に応じて入力されます。つまり、高プライバシーポストバックが有効になっている場合、ユーザー識別子など一部の項目は含まれません。詳しくは、アドネットワーク向け高プライバシーポストバックの仕様についてを参照してください。
- ポストバックレポートはPull APIから取得することもできます。
ポストバックレポート(Export DataページおよびPull APIから利用可能)
| レポート内容 | 成果が紐づくメディアソースに送信されるイベント |
|---|---|
| インストール | 非オーガニック (UA) インストール |
| アプリ内イベント | 非オーガニックのアプリ内イベント |
| リターゲティングコンバージョンポストバック | リターゲティング(リエンゲージメントとリアトリビューション) |
| リターゲティングアプリ内イベント | リターゲティングアプリ内イベント |
ポストバックレポートの追加項目
| 項目 | 備考 |
|---|---|
| Postback URL | 収益など、一部の値は該当する項目に表示されない場合がありますが、Postback URL内で確認できます。 |
| Postback method | |
| Postback HTTP response code | 200:広告ネットワークがポストバックを受信したことを示します。 |
| Postback error message |
Protect360と検証ルール
- Protect360と検証ルールのローデータレポートを参照してください。
- 広告ネットワークおよび代理店がProtect360と検証ルールのレポートにアクセスするには、広告主から権限を付与してもらう必要があります。
連携済みパートナーにProtect360へのアクセス権限を付与するには、以下の手順を実行します。
- 連携 > Active Integrationsに移動します。
- 該当の媒体を選択します。
- 権限タブにて、Protect360管理画面とAPIでのローデータへのアクセスを許可するをオンにします。
- アプリ内イベント(CPA)ダッシュボードへのアクセスも許可する場合は、アプリ内イベントの集計データへのアクセスも有効にします。
参照: