概要:行単位のデータ(ローデータ)には、インストール、アプリ内イベント、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のコンバージョンデータ(3) |
|
該当なし | SDKのコンバージョンデータでは、アプリの初回起動から最大8秒でユーザーのアトリビューションデータを取得します(AppsFlyerのサーバーで最大5秒、それに加えて通信経路全体のネットワーク遅延)。 | ✓ | UTC | 該当なし |
|
注意と略語: (1)複数アプリへの対応。 (2)一部のレポートは日次更新のため、実際の更新頻度・反映時間はレポートによって異なります。 (3)SDKのコンバージョンデータでは、アプリの初回起動から最大8秒でユーザーのアトリビューションデータを取得します(AppsFlyerのサーバーで最大5秒、それに加えて通信経路全体のネットワーク遅延)。そのため、この方法は最も精度が低くなります。 (P)プレミアム機能 (*)レポート生成数の上限が適用されます | ||||||
ツールの制限事項
| 制限事項 | Pull API(*) | Push API | Data Locker | SDKの コンバージョンデータ |
|---|---|---|---|---|
| データ量の上限 | 1回の呼び出しにつき100万行 | 該当なし | 該当なし | 該当なし |
| データの選択項目 | データの種類を選択。フィールドの選択肢は限定的 | データの種類、フィールド、アプリ内イベントを選択 | データの種類、フィールド、アプリ内イベントを選択 | なし |
| データ取得可能期間 | 90日間 | 該当なし | 14日間 | ユーザーのライフタイム全体(SDKで取得可能) |
| (*)レポート生成数の上限が適用されます | ||||
導入時の検討事項
| 検討事項 | Pull API | Push API | Data Locker | SDKの コンバージョンデータ |
|---|---|---|---|---|
| サーバー側の開発 | 任意 | 必須 | 任意 | 任意 |
| データ処理の必要性 | 任意 | 必須 | 任意 | 任意 |
| データ損失のリスク | なし | あり(受信サーバーが停止した場合) | なし | 小(アドネットワークの応答が遅延した場合) |
| クライアント・サーバーの処理コスト | なし | 高い | 低い | なし(サーバーにデータを送信する場合を除く) |
| クライアント・サーバーの保守 | なし | 高い | 低い | なし(サーバーにデータを送信する場合を除く) |
| データ形式 | CSVファイル | JSONまたはクエリパラメータ | CSVまたはparquet | JSON |
ローデータのレコードは、発生した文脈に応じてレポートにまとめられます。例えば、非オーガニックインストールやオーガニックアプリ内イベントなどです。ここでは、説明のためにレポートを以下のように分類します。
-
ユーザージャーニー:ユーザーのアプリ利用の流れやエンゲージメントを追跡するために使用します。
例:クリック > インストール > アプリ内イベント > アンインストール。 - 機能別:特定のAppsFlyer機能に関連する、主要なユーザージャーニーには含まれないレポートです。例えば、アドネットワークへのポストバック、不正・検証ルールのレポート、ユーザーレベルの広告収益レポートなどがあります。
レポートのフィールド
ローデータのフィールド一覧には、ユーザージャーニーレポートのフィールドと、一部の機能別レポートのフィールドが含まれます。それぞれの基本的な構成は、以下のとおりです。
-
ユーザージャーニー:
- 共通のフィールドで構成されます。
- 値が入力されるフィールドは、ユーザージャーニーの文脈によって異なります。例えば、非オーガニックのレポートには、ユーザーの獲得元としてアトリビューションされたメディアソースが含まれます。 オーガニックのレポートにはメディアソースがないため、アトリビューション関連のフィールドには値が入力されません。
- 機能別:独自のフィールドで構成されるか、ユーザージャーニーのフィールドに、その機能に関連するフィールドが追加されます。例えば、SKAdNetworkレポートには独自のフィールドがあります。一方、ポストバックレポートには、ユーザージャーニーのフィールドに加えて、パートナーへのポストバック送信に関するフィールドが含まれます。
ヒントレポートを理解するには、実際のレポートを見るのが効果的です。データ出力ページからレポートをダウンロードできます。
分かりやすくするため、ユーザージャーニーのフィールドは文脈ごとにグループ分けしています。
ユーザージャーニーのローデータフィールドグループ
| フィールドグループ | オーガニックユーザーへの適用 | フィールドの例 |
|---|---|---|
| アプリ | はい | アプリID、アプリ名、アプリのバージョン、SDKのバージョン、ATT |
| アトリビューション | インストール時刻を除き、適用されない | インストール時刻、アトリビューション対象のタッチ時刻、メディアソース、キャンペーン、広告セット、広告、パートナー、リターゲティングコンバージョンの種類 |
| アシストアトリビューション | なし | アシストしたパートナー、マッチタイプ |
| デバイス情報 | はい | 広告ID、GAID、OAID、デバイスの種類、顧客ユーザーID |
| デバイスの位置情報 | はい | IPアドレス、都市、国 |
| イベント | はい |
アプリ内イベントレポートで値が入力されるフィールド: イベント名、イベント値、イベント収益 |
ユーザージャーニーレポート
ユーザージャーニーの基本
ユーザージャーニーレポートには、ユーザーのライフタイム全体で発生したイベントの収集データが含まれます。データは、以下の基準でレポートに分けられます。
- ユーザーの流入元:オーガニックまたは非オーガニック
- ジャーニーの文脈:
- アプリのインストール前に発生した広告エンゲージメント(インプレッションとクリック)
- ユーザー獲得
- リターゲティング
ユーザー獲得(UA)レポートには、以下が含まれます。
- 広告に接触した見込みユーザーによる、インストール前のインプレッションとクリック。
- インストールイベント。
- その後にユーザーが実行したアプリ内イベント。
リターゲティングレポートには、以下が含まれます。
- ユーザーのリターゲティング時に発生したインプレッションとクリック。
- コンバージョンイベント:リエンゲージメントまたはリアトリビューション。
- リエンゲージメントの一環として、その後に実行されたアプリ内イベント。留意点:
- リターゲティングデータは常に非オーガニックです。
-
リターゲティングのアプリ内イベントは、UAとリターゲティングの両方のアプリ内イベントレポートに含まれます。リターゲティングの二重アトリビューションの仕組みを参照してください。
ユーザージャーニーを追跡するには、インストールやアプリ内イベントなど、確認したい過程に関連するレポートを結合します。結合後、AppsFlyer ID、イベント時刻、レポートの種類で並べ替えます。これにより、特定のユーザーのイベントを時系列で確認し、ユーザージャーニーを把握できます。
ユーザージャーニーレポートの利用条件
- 利用できるレポートは、ご契約のプランによって異なります。
- 各レポートには、表に示すとおり、オーガニックユーザー、非オーガニックユーザー、またはその両方が含まれます。
- 過去のローデータレポートには、取得ツールとデータの取得元に応じた保持ポリシーが適用されます。通常、過去90日分のデータを取得できます。注意集計データには保持ポリシーは適用されません。
ユーザージャーニーレポート
| カテゴリ | Data Locker限定 | レポートの対象 | オーガニック | 非オーガニック |
|---|---|---|---|---|
| ユーザー獲得 | ✓ | クリック | 該当なし | |
| リターゲティング | ✓ | リターゲティングキャンペーンのクリック | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | ✓ | インプレッション | 該当なし | |
| リターゲティング | ✓ | リターゲティングキャンペーンのインプレッション | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | - | インストール | ✓ | ✓ |
| ユーザー獲得 | - | アプリ内イベント | ✓ | ✓ |
| ユーザー獲得 | - | アトリビューションされた広告収益 | - | ✓ |
| ユーザー獲得 | - | オーガニック広告収益 | ✓ | - |
| リターゲティング | - | リターゲティング広告収益 | リターゲティングは常に非オーガニック | |
| リターゲティング | - | リターゲティングコンバージョン(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| リターゲティング | - | リターゲティングアプリ内イベント(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| リターゲティング | ✓ | リターゲティングセッション(リエンゲージメントとリアトリビューション) | リターゲティングは常に非オーガニック | |
| ユーザー獲得 | ✓ | セッション | ✓ | ✓ |
| ユーザー獲得 | - | 非オーガニックアンインストール | - | ✓ |
| ユーザー獲得 | - | オーガニックアンインストール | ✓ | - |
| ユーザー獲得 | ✓ | クロスプラットフォームのエンゲージメント | ✓ | ✓ |
ユーザージャーニーレポートの説明
クリックとインプレッション
| レポート | 特徴 |
|---|---|
| 発生する状況 | ユーザーがキャンペーンに接触し、広告をクリックまたは閲覧します。 |
| 特徴 | ユーザーが広告をクリックまたは閲覧した際のアトリビューションリンクとHTTPヘッダーが記録されます。 |
| 活用例 |
|
| レポートのサンプル | クリック |
| 備考 | SRNのデータは利用できません。 |
| データが制限されるユーザー | プライバシー上のルールにより、インプレッションやクリックのデータが制限される(ユーザー識別子が含まれない)場合や、データ自体を取得できない場合があります。取得の可否は、メディアソースとプラットフォームによって異なります。 |
インストールとリターゲティングコンバージョン
| レポート名 |
ユーザー獲得:インストール |
リターゲティング:コンバージョン |
|---|---|---|
| 発生する状況 |
ユーザーがアプリを初めて開いたとき。 |
ユーザーがリターゲティング広告に接触し、その後にアプリを開いたとき。リターゲティングコンバージョンには、リエンゲージメントとリアトリビューションがあります。 リターゲティングのアトリビューションガイドを参照してください。 |
| 活用例 |
|
インストールと同様。 |
| オーガニックと非オーガニックの違い |
|
該当なし |
| レポートのサンプル | インストール | リターゲティングコンバージョンレポートの構造は、インストールレポートと同じです。一部のフィールドには、リターゲティングの文脈に応じた値が入力されます。リターゲティングのローデータを参照してください。 |
アプリ内イベント
| レポート | 特徴 |
|---|---|
| レポートの対象となる状況 | アトリビューション(インストール、リアトリビューション、リエンゲージメント)後のユーザーの行動を時系列で記録したもの。 |
| 特徴 |
|
| 活用例 |
以下の目的でレポートを活用できます。
|
| イベント値 |
イベント値フィールド イベント値フィールドには、イベントに関連するすべてのデータがJSON形式で含まれます。 BIシステムに取り込んで、さらに分析できます。 ヒント Microsoft ExcelのPower Queryを使用すると、JSON文字列からイベントパラメータを解析できます。
収益のレポート AppsFlyerの収益とROIのデータは、イベントで送信されたaf_revenueに基づきます。 アプリ内イベントでaf_revenueパラメータが送信されると、AppsFlyerはその値をイベント収益フィールドに入力します。このフィールドの値を使用して、ダッシュボードと集計レポートを更新します。 注意 af_revenueパラメータは、実際に収益が発生したことを示すアプリ内イベントにのみ使用してください。 add_to_cartなど、収益に関係していても確定していないイベントには、af_priceなどの別のパラメータを使用してください。 |
| レポートのサンプル | アプリ内イベント |
| 備考 |
セッション
| レポート | 特徴 |
|---|---|
| 発生する状況 | ユーザーがアプリを開くと、セッションイベントがAppsFlyerに送信されます。セッション間の最小時間のしきい値を超えた場合に、イベントが記録されます。 |
| 特徴 | レポートの構造は、アプリ内イベントレポートと同じです。セッションイベントは件数が多いため、別のレポートで提供されます。 |
| 活用例 | ユーザーのアプリへのエンゲージメントを把握する。 |
| レポートのサンプル | セッションレポートは、アプリ内イベントレポートと同様です。注意:ローデータでは、セッションのイベント名はlaunchです。 |
アンインストール
| レポート | 特徴 |
|---|---|
| 発生する状況 | アプリをアンインストールしたユーザーの記録。 |
| 特徴 |
|
| 取得できるフィールド |
|
| レポートのサンプル | アンインストール。注意:サンプルの2行目には、分かりやすいように、関連データがある場合に値が入力されるフィールドを示しています。 |
| 活用例 |
|
ツール別のユーザージャーニーレポートの対応状況
ツール別の広告エンゲージメントレポート
| レポート | データ出力 | Pull API | Data Locker | Push API | SDKの コンバージョンデータ |
|---|---|---|---|---|---|
| インプレッション(1) | - | - | ✓ | - | - |
| クリック(1) | - | - | ✓ | - | - |
| (1)クリックとインプレッションのデータは、非SRNから提供されます。 SRNは、これらのデータを提供しません。 | |||||
ツール別のユーザー獲得レポート
| レポート | データ出力 | Pull API | Data Locker | Push API | SDKのコンバージョンデータ |
|---|---|---|---|---|---|
| インストール | ✓ | ✓ | ✓ | ✓ | ✓ |
| セッション | - | - | ✓ | - | - |
| アプリ内イベント | ✓ | ✓ | ✓ | ✓ | - |
| アンインストール | ✓ | ✓ | ✓ | - | - |
ツール別のリターゲティングローデータレポート
| レポート | データ出力 | Pull API | Data Locker | Push API | SDKの コンバージョンデータ |
|---|---|---|---|---|---|
| クリック(1) | - | - | ✓ | - | - |
| コンバージョン(リアトリビューション + リエンゲージメント) | ✓ | ✓ | ✓ | ✓ | ✓ |
| インプレッション(1) | - | - | ✓ | - | - |
| セッション | - | - | ✓ | - | - |
| アプリ内イベント | ✓ | ✓ | ✓ | ✓ | - |
| (1)クリックとインプレッションのデータは、非SRNから提供されます。 SRNは、これらのデータを提供しません。 | |||||
よくある質問
| 詳細 |
|---|
|
各タイムスタンプには、どのような違いがありますか? タイムスタンプは、すべてのレポートで共通です。そのため、異なるレポートを結合できます。 主なタイムスタンプは、以下のとおりです。
留意点:
|
|
contributorフィールドの用途は何ですか? contributorフィールドには、貢献したメディアソースが記載されます。アシストインストールと呼ばれることもあります。 Protect360では、ハイジャックされたインストールのアトリビューション修正にも使用されます。 |
|
keywordsフィールドとは何ですか?すべての非オーガニックインストールで取得できないのはなぜですか? Google AdsまたはApple Adsにアトリビューションされたインストールには、インストールにつながった広告のキーワードやキーワードIDが含まれる場合があります。 |
インストールレポートの活用のヒント
ユーザージャーニーの理解
ユーザージャーニーとは、商品の購入や航空券の予約など、ユーザーが目標を達成するまでの一連の行動です。ユーザージャーニーの分析では、一定期間にユーザーがアプリ内で何をしたか、どの程度活発に利用したか、どのような価値をもたらしたかを確認します。
AppsFlyer IDを使用すると、ユーザージャーニーを特定し、詳しく確認できます。 IDは、デバイスごとのアプリのインストール単位で生成されます。ユーザーのライフサイクル全体(インストールからアンインストールまで)を通して、IDは変わりません。ユーザーがデバイスIDをリセットしても、AppsFlyer IDは維持されます。
インストールレポートとアプリ内イベントレポートは同じ構造のため、1つのレポートに結合できます。結合したレポートでは、AppsFlyer IDや顧客ユーザーID(取得できる場合)で集計・絞り込みを行い、ユーザージャーニーを分析できます。
例
エンゲージメントが高いユーザー
- あるユーザーが8月20日の09:31にアプリをインストールしました。
- 結合したレポートから、このユーザーが8月20日の10:31、8月22日の15:22、8月25日の16:47に購入したことが分かります。
- このことから、エンゲージメントが高いユーザーだと判断できます。アプリの起動から1時間後に購入し、インストール後も別の日に継続して購入しています。
エンゲージメントが低いユーザー
- あるユーザーが7月30日にアプリをインストールしました。結合したレポートでは、8月15日に商品をカートに追加していますが、その後の購入イベントはありません。
- 購入を迷っていると考えられるため、カートに追加した商品でリターゲティングする、といった対応が可能です。
キャンペーン最適化のためのユーザージャーニー分析
- 旅行アプリのユーザー獲得(UA)担当者が、インストールとアプリ内イベントのレポートをダウンロードして結合します。
- アプリ内のユーザージャーニーを確認するため、AppsFlyer IDで絞り込みや集計を行います。
- あるAppsFlyer IDのユーザーが12か月前にアプリをダウンロードし、その数日後に航空券を予約したことが分かりました。
- その後、そのユーザーはいくつかの航空券のお得な情報を閲覧したものの、予約していません。さらに調べると同じ行動パターンのユーザーが複数見つかり、担当者は詳しい分析を進めます。
- その結果、これらのユーザーの多くが、メディアソースCで配信されたキャンペーンBの広告Aから流入したと分かりました。この広告とキャンペーンは、特定の目的地への旅行を希望するユーザーを対象としていました。
- ユーザージャーニーの分析から、キャンペーンの対象が狭すぎたため、アプリへの十分なエンゲージメントにつながらなかった可能性があると判断できます。
機能別レポート
AppsFlyerで利用できる追加機能に関するレポート
ポストバック
ポストバックレポートでは、アドネットワークに送信されたデータのコピーを確認できます。例えば、データの差異の調査に使用できます。これらのレポートは情報確認用であり、アドネットワークとの連携に必須ではありません。
- レポートに含まれるもの:
- アトリビューション先のメディアソースに送信されたポストバックのコピー。
- ローデータのフィールドと、このセクションに記載する追加フィールド。
- レポートに含まれないもの:
- SRNのインストール。
- Meta ads、X Ads、Apple Adsに関連するアプリ内イベント。
- アトリビューション先以外のパートナーへのポストバック。任意のパートナーにアトリビューションされたイベント、またはオーガニックイベントを参照してください。
- オーガニックユーザー。オーガニックインストールの説明を参照してください。
- 2021年3月以降、フィールドへの値の入力は、ネットワークの高プライバシーモードの設定に従います。高プライバシーモードが有効な場合、ユーザー識別子など一部のフィールドは含まれません。アドネットワーク向け高プライバシーモードのポストバック仕様を参照してください。
- Pull APIでのポストバックレポートの取得
ポストバックレポート(データ出力ページおよびPull APIで取得可能)
| レポートの対象 | アトリビューション先のメディアソースに送信されるイベント |
|---|---|
| インストール | 非オーガニック(UA)インストール |
| アプリ内イベント | 非オーガニックアプリ内イベント |
| リターゲティングコンバージョンのポストバック | リターゲティング(リエンゲージメントとリアトリビューション) |
| リターゲティングアプリ内イベント | リターゲティングアプリ内イベント |
ポストバックレポートの追加フィールド
| フィールド | 備考 |
|---|---|
| Postback URL | 収益などの値が対応するフィールドに表示されない場合でも、Postback URLで確認できます。 |
| Postback method | |
| Postback HTTP response code | 200:アドネットワークでポストバックが受信されたことを示します。 |
| Postback error message |
Protect360の不正・検証ルール
- Protect360および検証ルールのローデータレポートを参照してください。
- アドネットワークと代理店がProtect360と検証ルールのレポートにアクセスするには、広告主からの権限付与が必要です。
連携済みパートナーにProtect360へのアクセス権限を付与するには:
- Collaborate > Active Integrationsに移動します。
- 連携済みパートナーを選択します。
- Permissionsタブで、Access your Protect360 dashboard & raw data via APIをオンにします。
- アプリ内イベント(CPA)ダッシュボードへのアクセス権限を付与するには、Access aggregate in-app events dataをオンにします。
関連記事