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

Data Clean Room | アプリ内イベントレポートの作成 プレミアム機能

  • 更新

概要:アプリのインストール後のユーザー行動に着目したアプリ内イベントレポートを作成します。アプリ内イベントのローデータから特定のイベントパラメータを抽出し、必要に応じてカスタムソースと照合したうえで、集計形式に処理して出力します。

アプリ内イベントレポートの作成

以下の各タブに記載された手順に従って、アプリ内イベントレポートを作成します。

注意:読みやすさのため、手順を複数のタブに分けて説明しています。レポートを作成するには、すべての手順を完了する必要があります。カスタムソースを使用しないレポートには、一部の手順は不要です。該当する箇所に明記しています。

事前準備

  1. DCRの[レポート]タブに移動します。
  2. [+ 新しいレポート]ボタンをクリックします。
  3. ソースデータの種類として[アプリ内イベント]を選択し、画面右下の[次へ]をクリックします。
  4. レポート名を入力します。
    • DCR上でレポートを識別しやすい名前を指定してください。
    • 重要:同じアカウント内の他のレポートと異なる名前を指定してください。名前が重複していると、レポートを保存できません。
    • レポート名の要件:
      • 長さ:2~80文字
      • 使用できる文字:
        • 英字(A-Z, a-z)
        • 数字(0-9)。名前の先頭には使用できません。
        • ハイフン(-)。名前の先頭には使用できません。
      • 使用できない文字:
        • スペース
        • 上記以外の記号や特殊文字すべて

ソースの選択

レポートに使用するソースデータを指定します。

アプリ内イベントのソース

  • アプリ:AppsFlyerアカウント内のアプリを1つ以上選択します。
  • 対象期間:DCRがアプリ内イベントを検索する際、何日前までのデータを対象にするかを1~30日で指定します。
  • イベント:レポートに含めるアプリ内イベントを1つ以上選択します。
    • 選択したアプリのアプリ内イベントのうち、SDKまたはサーバー間API(S2S)でAppsFlyerにデータを送信するよう設定されたものをすべて選択できます。
  • ソースの種類:アプリ内イベントデータの種類を1つ以上選択します。
    インストール

    インストールのアトリビューションに紐づくアプリ内イベント

    • ユーザーがモバイルアプリをダウンロード、インストールし、起動すると、インストールが記録されます。
    リエンゲージメント

    リエンゲージメントに紐づくアプリ内イベント

    • 特定のアプリを利用していなかったユーザーが、そのアプリのリターゲティングキャンペーンに接触し、その後アプリを起動すると、リエンゲージメントが記録されます。
    リアトリビューション

    リアトリビューションに紐づくアプリ内イベント

    • 特定のアプリをアンインストールした過去のユーザーが、そのアプリのリターゲティングキャンペーンに接触し、その後アプリを再インストールすると、リアトリビューションが記録されます。

データソース

  1. [任意]レポートに使用するソースを追加します。ソースを追加するかどうかを決める際は、カスタムソースを使用するレポートと使用しないレポートの違いに注意してください。
    • カスタムソースを使用しないレポートでは、アプリ内イベントのローデータから特定のイベントパラメータと値を抽出します。
    • カスタムソースを使用するレポートでは、アプリ内イベントのローデータから特定のイベントパラメータと値を抽出した後、カスタムソースのユーザーレベルデータ(BI・CRMシステムのデータなど)と照合します。
  2. カスタムソースを使用するかどうかに応じて、次の手順に進んでください。
    • カスタムソースを使用しない場合は、「ディメンションの選択」に進み、以降のすべてのタブの手順を実施します。
    • カスタムソースを使用する場合は、次の「ソースの結合」タブと、以降のすべてのタブの手順を実施します。

次の手順は、カスタムソースを使用するレポートのみに必要です。

ソースの結合(カスタムソースを含むレポートのみ)

ソース間のデータを照合するには、レポートで使用する各カスタムソースに、アプリ内イベントデータの照合キーとなる識別子にマッピングされた識別子が必要です。

  • アプリ内イベントレポートには、指定期間内に照合キーと一致する、選択したイベントがすべて含まれます。

照合キーとなる識別子とは

アプリ内イベントデータの以下のいずれかの識別子を、照合キーとしてマッピングできます。

  • AppsFlyer ID(af_id): アプリのインストール時にAppsFlyerが生成する、一意の識別子です。
    • AppsFlyerが記録するすべてのイベントに含まれます。
    • アプリを削除して再インストールすると、新しいAppsFlyer IDが生成されます。
  • 顧客ユーザーID(CUID):通常、ユーザー登録時にアプリ所有者が生成・設定する、ユーザー固有の識別子です。
    • CUIDでデータをマッピングするには、SDKまたはサーバー間API(S2S)を通じてCUIDをAppsFlyerに送信するよう、アプリを設定する必要があります。

重要

CUIDによる照合を許可していない媒体もあります。 AppsFlyer IDの使用を強くおすすめします。

マッピング方法(直接/間接)

カスタムソースを複数含むレポートでは、いずれか1つをアプリ内イベントの照合キーに直接マッピングすれば構いません。他のカスタムソースは、次の例のように直接または間接的にマッピングできます。

例

dcr_mapping_identifiers_in-app events.png

上図の例:

  • カスタムソース#1の識別子AFは、アプリ内イベントの照合キーaf_idに直接マッピングされています。
  • カスタムソース#2は、user_code --> AF --> af_idの順に間接的にマッピングされています。
  • カスタムソース#3は、より多くのソースを経由し、間接的にマッピングされています。
    user_id --> user_code --> AF --> af_id。
  • カスタムソース#4の識別子IDは、アプリ内イベントの照合キーaf_idに直接マッピングされています。
    • カスタムソース#3の識別子user_idを経由して間接的にマッピングすることもでき、どちらの方法でも問題ありません。

✓ すべてのカスタムソースが、アプリ内イベントの照合キーaf_idに直接または間接的にマッピングされているため、この方法で全ソース間のデータを照合できます。

以降のタブの手順は、カスタムソースの有無にかかわらず、すべてのアプリ内イベントレポートに必要です。

ディメンションの選択

DCRは、ユーザーレベルのデータをレポートとして出力できません。選択したディメンションでデータを集計・グループ化し、意思決定に必要な知見を提供します。

ディメンションとは、地域、インストール日、キャンペーンなど、アプリユーザーを分類するための属性です。

event_valueからのディメンションの抽出

SDKまたはS2S APIでAppsFlyerにアプリ内イベントを送信する際、ローデータの多くはevent_valueという1つのフィールドに格納されます。この構造化データフィールドには、アプリからAppsFlyerに送信するイベント用に設定した、個々のアプリ内イベントパラメータが含まれています。

アプリ内イベントレポートの大きな利点の1つは、選択したイベントのevent_valueフィールドから、特定のパラメータと値を抽出できることです。

DCRレポートで使用するディメンションをevent_valueから抽出する手順:

  1. [ソースのディメンション]一覧で、次の extract_dimension_button.png ボタンをクリックします。

    [event_valueからフィールドを抽出]ウィンドウが開きます。

  2. [レポートフィールド]欄に、抽出したディメンションをレポートに表示する際の名前を入力します。
  3. [event_valueのパラメータ]一覧で、手順2で定義したレポートフィールド(ディメンション)にデフォルトでマッピングするアプリ内イベントパラメータを選択します。
    • 選択中のアプリで、指定したアプリ内イベントに設定されているパラメータを選択できます。
  4. デフォルトのマッピングは、アプリやイベントによって異なる場合があります。その場合は、以下の操作を行います。
    1. [例外を追加]ボタンをクリックします。
    2. レポートフィールドのマッピングを変更するアプリとイベントを選択します。
    3. このアプリとイベントの組み合わせで、レポートフィールドにマッピングするアプリ内イベントパラメータを選択します。
    4. 設定する例外の数だけ、この操作を繰り返します。
  5. 抽出するディメンションのマッピングを設定したら、event_valueから別のディメンションも抽出する場合は[保存してさらに追加]を、メイン画面に戻る場合は[保存]をクリックします。

抽出したディメンションを編集する手順:

  1. [ソースのディメンション]または[レポートのディメンション]一覧で、編集するディメンション名にカーソルを合わせます。
  2. ディメンションの右側に表示されるmore_options_button.pngボタンをクリックします。
  3. [抽出したフィールドを編集]を選択します。
  4. 必要に応じて、[レポートフィールド]の名前やパラメータのマッピングを変更します。
  5. [保存]をクリックして変更を保存します。

抽出したディメンションを削除する手順:

  1. [ソースのディメンション]または[レポートのディメンション]一覧で、削除するディメンション名にカーソルを合わせます。
  2. ディメンションの右側に表示されるmore_options_button.pngボタンをクリックします。
  3. [フィールドを削除]を選択します。
    • 注意:[レポートのディメンション]一覧から抽出したフィールドを削除すると、そのフィールドの定義も削除されます。定義を残してレポートからのみ除外するには、フィールドを選択し、[削除]ボタンで一覧から戻してください。

レポートのディメンションの選択

アプリ内イベントレポートでは、以下をディメンションとして使用できます。

レポートに含めるディメンションを選択する手順:

  1. 左側の[ソースのディメンション]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[レポートのディメンション]一覧に追加します。
    • 一覧内のディメンションは、検索バーで検索できます。
  2. ディメンションを除外するには、[レポートのディメンション]一覧で選択し、[削除]ボタンを使って[ソースのディメンション]一覧に戻します。
  3. レポートに含めたいディメンションをすべて追加するまで、この操作を繰り返します。

注意:デフォルトでは、すべてのレポートがアプリ内イベントのディメンションmedia_sourceでグループ化されます。このディメンションを使用しない場合は、[レポートのディメンション]一覧から除外できます。

[任意]ディメンションの表示名の変更

デフォルトでは、アプリ内イベントデータまたはカスタムソース内のディメンション名が、そのままレポートに表示されます。レポート用にディメンション名を変更することもできます。

ディメンションの表示名を変更する手順:

  1. [レポートのディメンション]一覧で、表示名を変更するディメンション名にカーソルを合わせます。
  2. ディメンションの右側に表示される編集ボタンedit_button.pngをクリックします。
  3. レポートに表示する名前を入力します(最大50文字)。
  4. [OK]で表示名を保存するか、[X]でキャンセルします。

注意:抽出したディメンションの名前を変更する場合は、前述の編集手順を使用してください。

ディメンションでのグループ化とプライバシー保護(再グループ化)

データセットの規模や選択したディメンションの数などによっては、レポート内のグループに含まれるユーザー数が少なすぎて、出力できない場合があります。そのまま出力すると、ユーザーレベルデータの提供に関する制限に違反するためです。

DCRは、データをレポートから完全に削除・非表示にする代わりに、再グループ化(集計単位をまとめ直す処理)によって、プライバシーを保護しながら可能な限り詳細な情報を提供します。

再グループ化の例

以下のディメンションを、この順序で使用するレポートを設定したとします。

  • アプリ内イベントのディメンション:
    • media source
    • campaign
    • adset_name
    • ad_id
  • カスタムソースのディメンション:
    • user_type

再グループ化前

DCRが最初にデータを分析すると、以下のように分類されます。

媒体
キャンペーン 広告セット
名
広告
ID
ユーザー
種別
収益
D0
収益
D7
件数 出力可能?
media_source UA_100 green kjh867 buyer 1 4 120

✓

media_source UA_101 green jkj987 ultra 2 23 220

✓

media_source UA_200 green lkh123 beg 6 7 x

X

media_source UA_200 green ilk945 beg 3 21 x

X

media_source UA_200 green plm654 beg 8 17 x

X

このままでは、最後の3行はそれぞれのユーザー数が少なすぎるため、出力できません。(この媒体では、出力に最低y人のユーザーが必要です。ここではx人しかいません。)

再グループ化のロジックに従って、DCRはまず、最後に指定されているアプリ内イベントのディメンション(ここではad_id)を集計単位から除外します。その後、データを再分析して、出力可能な行を確認します。

再グループ化後

再グループ化のロジックを適用すると、レポートは以下のようになります。

媒体
キャンペーン 広告セット
名
広告
ID
ユーザー
種別
収益
D0
収益
D7
件数 出力可能?
media_source UA_100 green kjh867 buyer 1 4 120

✓

media_source UA_101 green jkj987 ultra 2 23 220

✓

media_source UA_200 green RESTRICTED beg 17 45 y (x+x+x)

✓

結果:

  • 最後の行に、元の3行のデータがまとめられています。統合した行のユーザー数はy人となり、出力できるようになります。
  • 除外したディメンションの値は、RESTRICTEDとして表示されます。
  • 出力できない行(ユーザー数がy人未満の行)が残る場合、DCRはディメンションを1つずつ除外しながら分析を繰り返し、以下のいずれかの状態になるまで続けます。
    • すべての行を出力できる状態
    • 除外できるアプリ内イベントのディメンションがなくなった状態

注意:デフォルトでは、再グループ化の対象はデフォルトのアプリ内イベントディメンションのみで、抽出したアプリ内イベントやカスタムソースのディメンションには適用されません。デフォルトのアプリ内イベントディメンションでグループ化した結果、ユーザー数がy人未満になる行のデータは、RESTRICTEDとして出力されます。

  • カスタムソースのディメンションにも再グループ化を適用する詳細設定については、以下をご覧ください。

[任意]ディメンションの優先度の管理

デフォルトでは、[レポートのディメンション]一覧の下から順に、アプリ内イベントのディメンションが除外されます。重要なディメンションを残せるよう、この順序を変更したり、選択したカスタムソースのディメンションにも再グループ化を適用したりできます(該当する場合)。

ディメンションを除外する順序を変更する手順:

  1. [ディメンション優先度を管理]ボタンをクリックします。
  2. ディメンションを選択し、一覧内の目的の位置にドラッグします。右側の矢印ボタンでも移動できます。
    • 一覧の最上部にある[最も高い優先順位]のディメンションは、再グループ化が必要になった場合、最後に除外されます。
  3. [任意]カスタムソースのディメンションに再グループ化を適用する手順(カスタムソースを使用するレポートのみ):
    1. [詳細設定で再グループ化を調整]をクリックします。
    2. 再グループ化を適用するカスタムソースのディメンションを選択します。
    3. 選択したディメンションが[ディメンション優先度を管理]の一覧に追加されます。
      • デフォルトでは、一覧の末尾に[最も低い優先順位]として追加されます。アプリ内イベントのディメンションと同様、前述の方法で並べ替えることができます。
  4. [OK]をクリックして変更を保存します。
    • メイン画面の[レポートのディメンション]一覧の表示順は変わりませんが、変更した優先順位は保存されています。選択内容を確認・編集するには、[ディメンション優先度を管理]ボタンを再度クリックします。

指標の選択

指標とは、収益、アプリの起動回数、LTVなど、アプリユーザーに関して収集した数値データです。ソース内で指標に分類した数値フィールドを使用できます。

event_valueからの指標の抽出

レポートのディメンションと同様、event_valueからアプリ内イベントパラメータを抽出し、レポートの指標として使用できます。

DCRレポートで使用する指標をevent_valueから抽出する手順:

  1. [ソースの指標]一覧で、次の extract_metric_button.png ボタンをクリックします。

    [event_valueからフィールドを抽出]ウィンドウが開きます。

  2. [レポートフィールド]欄に、抽出した指標をレポートに表示する際の名前を入力します。
  3. [event_valueのパラメータ]一覧で、手順2で定義したレポートフィールド(指標)にデフォルトでマッピングするアプリ内イベントパラメータを選択します。
    • 選択中のアプリで、指定したアプリ内イベントに設定されているパラメータを選択できます。
  4. デフォルトのマッピングは、アプリやイベントによって異なる場合があります。その場合は、以下の操作を行います。
    1. [例外を追加]ボタンをクリックします。
    2. レポートフィールドのマッピングを変更するアプリとイベントを選択します。
    3. このアプリとイベントの組み合わせで、レポートフィールドにマッピングするアプリ内イベントパラメータを選択します。
    4. 設定する例外の数だけ、この操作を繰り返します。
  5. 抽出する指標のマッピングを設定したら、event_valueから別の指標も抽出する場合は[保存してさらに追加]を、メイン画面に戻る場合は[保存]をクリックします。

抽出した指標を編集する手順:

  1. [ソースの指標]または[レポート指標]一覧で、編集する指標名にカーソルを合わせます。
  2. 指標の右側に表示されるmore_options_button.pngボタンをクリックします。
  3. [抽出したフィールドを編集]を選択します。
  4. 必要に応じて、[レポートフィールド]の名前やパラメータのマッピングを変更します。
  5. [保存]をクリックして変更を保存します。

抽出した指標を削除する手順:

  1. [ソースの指標]または[レポート指標]一覧で、削除する指標名にカーソルを合わせます。
  2. 指標の右側に表示されるmore_options_button.pngボタンをクリックします。
  3. [フィールドを削除]を選択します。
    • 注意:[レポート指標]一覧から抽出したフィールドを削除すると、そのフィールドの定義も削除されます。定義を残してレポートからのみ除外するには、フィールドを選択し、[削除]ボタンで一覧から戻してください。

レポート指標の選択

レポートに含める指標を選択する手順:

  1. 左側の[ソースの指標]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[レポート指標]一覧に追加します。
    • 一覧内の指標は、検索バーで検索できます。
  2. [レポート指標]一覧の各指標について、以下のいずれかの集計方法を選択します。
    • 数値の合計
    • 重複を除いた値の件数
  3. 指標を除外するには、[レポート指標]一覧で選択し、[削除]ボタンを使って[ソースの指標]一覧に戻します。
  4. レポートに含めたい指標をすべて追加するまで、この操作を繰り返します。

[任意]指標の表示名の変更

デフォルトでは、アプリ内イベントデータまたはカスタムソース内の指標名が、そのままレポートに表示されます。レポート用に指標名を変更することもできます。

指標の表示名を変更する手順:

  1. [レポート指標]一覧で、表示名を変更する指標名にカーソルを合わせます。
  2. 指標の右側に表示される編集ボタンedit_button.pngをクリックします。
  3. レポートに表示する名前を入力します(最大50文字)。
  4. [OK]で表示名を保存するか、[X]でキャンセルします。

注意:抽出した指標の名前を変更する場合は、前述の編集手順を使用してください。

[任意]件数を集計する識別子の選択

デフォルトでは、レポートの各行の末尾に、その行にまとめられたAppsFlyer IDのユニーク数を示す列が追加されます。

ソース内の他の識別子についてもユニーク数の列を追加するには、以下の操作を行います。

  1. 左側の[ソースの識別子]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[ユニーク数を集計する識別子]一覧に追加します。
    • 一覧内の識別子は、検索バーで検索できます。
  2. 識別子を除外するには、[ユニーク数を集計する識別子]一覧で選択し、[削除]ボタンを使って[ソースの識別子]一覧に戻します。
  3. レポートで件数を集計したい識別子をすべて追加するまで、この操作を繰り返します。

レポート設定と保存

スケジュール(カスタムソースを使用しないレポートのみ)

カスタムソースを使用しないレポートは、指定したスケジュールに従って実行されます。

レポートのスケジュールを設定する手順:

  1. 日次で実行するか、毎週指定した1つ以上の曜日に実行するかを選択します。
  2. 実行する時刻を選択します(タイムゾーンはUTC)。

重要

カスタムソースを使用するレポートでは、スケジュール設定は無効になります。このレポートは、使用するすべてのカスタムソースの新しいバージョンが検出されるたびに実行されます。

  • データウェアハウス(BigQuery、Snowflake)にあるソースでは、ソーステーブルのv列に新しい値が検出されると、新しいバージョンが作成されたと認識されます。
    • 重要:レポートの完全性を確保するため、この列の値を変更する際は、必ずソーステーブルに一式のデータをすべて格納してください。
  • クラウドストレージのバケット(Amazon S3、GCS)にあるソースでは、対応する_SUCCESSファイルとともにソースファイルの新しいバージョンがアップロードされたことを検出すると、新しいバージョンが作成されたと認識されます。

AppsFlyerは、当日とその2日前までのソースについて、新しいバージョンを継続的にスキャンします。

レポートの出力先

DCRは、AppsFlyer Data Lockerを使って、選択したクラウドサービスにレポートを配信します。そのため、出力先を指定する際は、Data Lockerのデータ接続を選択するか、新たに作成します。

  • 注意:DCRレポートを受信するために、Data Lockerのプレミアム契約は必要ありません。 Data Lockerで他のAppsFlyerレポートも受信したい場合は、担当のCSMに連絡するか、hello@appsflyer.comにメールでお問い合わせください。

レポートの出力先を設定して保存する手順:

  1. AppsFlyerアカウントで利用できるData Lockerのデータ接続の一覧から選択します。
    • アカウントにデータ接続が設定されていない場合:
      • ブラウザーの新しいタブにAppsFlyerのData Lockerページが開きます。
      • [新しいデータ接続]ダイアログが開きます。こちらの手順に従って、データ接続を作成します。
    • 既存のデータ接続があっても、新たに作成する場合は、次のdcr_new_connection_data_locker_button.pngボタンをクリックします。
      • ブラウザーの新しいタブにAppsFlyerのData Lockerページが開きます。
      • [新しいデータ接続]ダイアログが開きます。こちらの手順に従って、データ接続を作成します。
    • データ接続を作成したら、ブラウザーのDCRのタブに戻り、Data Lockerの一覧から新しいデータ接続を選択します。
  2. [保存]をクリックしてレポートを保存します。
  3. Data Clean Roomの[レポート]タブに、新しいレポートが表示されます。

リファレンス

デフォルトのアプリ内イベントディメンション

event_valueから抽出したディメンションや、カスタムソースのディメンション(該当する場合)に加え、以下のアプリ内イベントディメンションでレポートをグループ化できます。

  • media_source(デフォルトでレポートのディメンションに含まれます)
  • ad
  • ad_id
  • ad_type
  • adset_id
  • adset_name
  • app_id
  • app_version
  • attributed_touch_type
  • brand
  • campaign
  • campaign_id
  • channel
  • city
  • conversion_type
  • country
  • device_type
  • dma
  • engagement_type
  • event_name
  • event_revenue_currency
  • geo_region
  • is_attributed
  • keywords
  • match_type
  • model
  • partner
  • platform
  • site_id

デフォルトのアプリ内イベント指標

event_valueから抽出した指標や、カスタムソースの指標(該当する場合)に加え、以下のアプリ内イベント指標をレポートに含められます。

  • event_revenue
  • event_revenue_u_s_d