Data Clean Room - アプリ内イベントレポートの作成

1. Data Clean Roomのレポートタブに移動します。
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によって採番される一意のアプリ識別子 –
  • このIDは、AppsFlyerによって記録されたすべてのイベントに表示されます。
  • アプリを削除して再インストールすると、新しいAppsFlyer IDが生成されます。
• カスタマーユーザー ID (CUID)：通常、ユーザー登録時にアプリの所有者によって生成・設定される一意のユーザー識別子。
  • CUIDを使用してデータをマッピングするには、SDKまたはサーバー間 API (S2S) を介して CUIDをAppsFlyerに送信するようにアプリが構成されている必要があります。

マッピングスキーム（ダイレクト / インダイレクト）

レポートで複数のカスタムソースが含まれる場合、アプリ内イベントキー識別子に直接マッピングする必要があるのはそのうちの 1つだけです。その他のカスタムソースは、次の例に示すように 直接的または間接的にマッピングできます。

ユーザーレベルのデータはDCRによってレポートできないことを思い出してください。代わりに、選択したディメンションでデータを集計（またはグループ化）することで、必要な意思決定の分析情報を提供します。

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

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

アプリ内イベントがSDKまたはS2S APIを介してAppsFlyerに報告されると、ローデータの多くはevent_valueと呼ばれる単一のフィールドに含まれます。この構造化データフィールドには、アプリからAppsFlyerに送信されるイベントに対して設定された、特定のアプリ内イベントパラメータがすべて含まれています。

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

DCRレポートで使用するために event_valueフィールドからディメンションを抽出します。

1. ソースからのディメンションリストで、ボタンをクリックします。

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

2. レポートフィールド ボックスに、レポートに表示する抽出ディメンションの名前を入力します。
3. Event_valueパラメータリストから、手順2で定義したレポートフィールド（ディメンション）にデフォルトでマッピングするアプリ内イベントパラメータを選択します。
   • 使用可能なパラメーターには、選択したアプリの選択したアプリ内イベントで設定されたパラメーターが含まれます。
4. デフォルトのマッピングはアプリやイベントによって異なる可能性があります。この場合は、次のようにします。
   1. [ 例外を追加する ] ボタンをクリックします。
   2. レポートフィールドを異なる方法でマッピングするアプリとイベントを選択します。
   3. このアプリ/イベントの組み合わせのレポートフィールドにマッピングするアプリ内イベントパラメータを選択します。
   4. 設定する例外の数だけ、これらの手順を行ってください。
5. 抽出されたディメンションのマッピング設定が完了したら、保存して別のディメンションを追加をクリックしてevent_valueフィールドから別のディメンションを抽出するか、保存をクリックしてメイン画面に戻ります。

抽出したディメンションの編集

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

抽出したディメンションの削除

1. ソースからのディメンションまたはレポートのディメンションリストで、削除したいディメンション名にカーソルを合わせます。
2. ディメンションの右側に表示される ボタンをクリックします。
3. フィールドの削除を選択します。
   • 警告！　レポートディメンションリストから抽出したフィールドを削除すると、抽出されたフィールドの定義も削除されます。定義を保持したままレポートからフィールドを削除する場合は、フィールドを選択し、代わりに 削除ボタンを使用します。

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

アプリ内イベントレポートのディメンションには、次のものが含まれます：

• event_valueから抽出したディメンション
• デフォルトのアプリ内イベントのディメンション
• レポートのカスタムソース内で ディメンションとして分類されているフィールド（該当する場合）

レポートに含めるディメンションの選択

1. 左側の ソースからのディメンションリストで 1つ以上のディメンションを選択し、画面中央の追加ボタンを使用してレポートディメンションの一覧に追加します。
   
   • 検索バーを使用して、リスト内のディメンションを検索できます。
2. ディメンションを削除するには、レポートディメンションリストからディメンションを選択し、削除ボタンでソースからのディメンションリストに戻します。
3. レポートに含める各ディメンションを追加するまで、このプロセスを繰り返します。

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

[オプション] ディメンション表示名のカスタマイズ

デフォルトでは、ディメンション名はアプリ内イベントデータまたはカスタムソースで名前が付けられているとおりにレポートに表示されます。必要に応じて、レポートのディメンション名をカスタマイズできます。

ディメンションの表示名をカスタマイズする：

1. レポートディメンションリストで、表示名を編集するディメンションの名前にカーソルを合わせます。
2. ディメンションの右側に表示される編集ボタン をクリックします。
3. 名前をレポートで使用するディメンション表示名に変更します（最大50文字）。
4. OKをクリックして表示名を保存するか、X をクリックしてキャンセルします。

注： 抽出されたディメンション名を変更する場合は、上記の抽出されたディメンションを編集する手順を使用します。

ディメンションでグループ化（再グループ化）する際のプライバシー保護：

データセットのサイズ、選択したディメンションの数、その他の要因によっては、レポートに、ユーザーが少なすぎてレポートを作成できないグループが 1つ以上存在する場合があります。データがこのように報告された場合、ユーザーレベルのデータの提供に対する制限に違反しています。

ただし、DCRは、レポートからデータを完全に削除または非表示にする代わりに、 再グループ化メカニズム を使用して、ユーザーのプライバシーを維持しながら可能な限り詳細なデータを提供します。

[オプション] ディメンションの優先度の管理

デフォルトでは、アプリ内イベントディメンションは レポートディメンションリストに表示される順序とは逆の順序で削除されます。ただし、デフォルトの順序を変更したり、選択したカスタムソースディメンション（該当する場合）に再グループ化を適用して、最も重要なディメンションを保持することができます。

ディメンションを削除する順序を変更する：

1. ディメンション優先度の管理 ボタンをクリックします。
2. ディメンションを選択し、リスト内の目的の位置にドラッグします（または、右側の矢印ボタンを使用して移動します）。
   • 優先度：最高 とラベル付けされたディメンション（リストの一番上）は、再グループ化が必要な場合に一番最後に削除されるディメンションであることを意味します。
3. [オプション] カスタムソースディメンションに再グループ化を適用します（カスタムソースを使用するレポートの場合）
   1. 詳細オプションを使用して再グループ化を絞り込む をクリックします。
   2. 再グループ化を適用するカスタムソースディメンションを選択します。
   3. 選択したディメンションが ディメンション優先度の管理 リストに追加されます。
      • デフォルトでは、これらのディメンションはリストの一番下に再グループ化の優先度：最低 として追加されます。ただし、上記のようにアプリ内イベントディメンションと同様に並べ替えることができます。
4. OK をクリックして変更を保存します。
   • メイン画面の レポートディメンションリストは元の順序のままですが、修正された順序は保存されています。
     （選択内容を確認または編集する場合は、ディメンション優先度の管理 ボタンをもう一度クリックします。）

指標は、アプリユーザーに関して収集した数値データ（収益、アプリ起動数、LTVなど）であり、指標として分類したソースからの任意の数値データ項目を使用できます。

event_valueからのメトリックの抽出

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

DCRレポートで使用するために event_valueフィールドからディメンションを抽出します。

1. ソースからのメトリックリストで、ボタンをクリックします。

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

2. レポートフィールド ボックスに、レポートに表示する抽出メトリック名を入力します。
3. Event_valueパラメータリストから、手順2で定義したレポートフィールド（メトリック）にデフォルトでマッピングするアプリ内イベントパラメータを選択します。
   • 使用可能なパラメーターには、選択したアプリの選択したアプリ内イベントで設定されたパラメーターが含まれます。
4. デフォルトのマッピングはアプリやイベントによって異なる可能性があります。この場合は、次のようにします。
   1. [ 例外を追加する ] ボタンをクリックします。
   2. レポートフィールドを異なる方法でマッピングするアプリとイベントを選択します。
   3. このアプリ/イベントの組み合わせのレポートフィールドにマッピングするアプリ内イベントパラメータを選択します。
   4. 設定する例外の数だけ、これらの手順を行ってください。
5. 抽出されたメトリックのマッピング設定が完了したら、保存して別のディメンションを追加をクリックしてevent_valueフィールドから別のメトリックを抽出するか、保存をクリックしてメイン画面に戻ります。

抽出したメトリックの編集

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

抽出したメトリックの削除

1. ソースからのメトリックまたは レポートのメトリックのリストで、削除するメトリック名にカーソルを合わせます。
2. メトリックの右側に表示される ボタンをクリックします。
3. フィールドの削除を選択します。
   • 警告！レポートのメトリックリストから抽出したフィールドを削除すると、抽出されたフィールドの定義も削除されます。定義を保持したままレポートからフィールドを削除する場合は、フィールドを選択し、代わりに 削除ボタンを使用します。

レポートの指標を選択する

レポートに含める指標を選択する：

1. 左側の ソースからのメトリックリストで 1つ以上のメトリックを選択し、画面中央の追加ボタンを使用して、レポートメトリックの一覧に追加します。
   • 検索バーを使用して、リスト内のディメンションを検索できます。
2. レポートメトリックリストのメトリックごとに、データを次のいずれかとしてレポートするかどうかを選択します：
   • 数値の合計、または
   • 個別の値の数
3. メトリックを削除するには、レポートメトリックリストからメトリックを選択し、削除ボタンを使用して ソースからのメトリックリストに戻します。
4. レポートに含める各メトリックを追加するまで、このプロセスを繰り返します。

[オプション] メトリック表示名のカスタマイズ

デフォルトでは、メトリック名はアプリ内イベントデータまたはカスタムソースで名前が付けられているとおりにレポートに表示されます。必要に応じて、レポートのメトリック名をカスタマイズできます。

メトリックの表示名をカスタマイズする：

1. レポートメトリックリストで、表示名を編集するメトリックの名前にカーソルを合わせます。
2. ディメンションの右側に表示される編集ボタン をクリックします。
3. 名前をレポートで使用するディメンション表示名に変更します（最大50文字）。
4. OKをクリックして表示名を保存するか、X をクリックしてキャンセルします。

注： 抽出されたメトリックの名前を変更する場合は、上記の抽出されたメトリックを編集する手順を使用します。

[オプション] カウントする識別子を選択する

デフォルトでは、レポートの各行は、その行のデータにグループ化された個別のAppsFlyer IDの数を含む列が最後（一番右）で終わります。

ソースからの他の識別子の個別のカウントの列を追加する場合は、次のようにします：

1. 左側の ソースの識別子リストで 1つ以上の識別子を選択し、画面中央の追加ボタンを使用して、それらを個別のカウント識別子の一覧に追加します。
   • 検索バーを使用して、リスト内の識別子を検索できます。
2. 識別子を削除するには、個別のカウント識別子リストから識別子を選択し、削除ボタンを使用してソースからの識別子リストに戻します。
3. レポートにカウントする各識別子を追加するまで、このプロセスを繰り返します。

スケジュール（カスタムソースのないレポートのみ）

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

レポートスケジュールの定義

1. レポートを毎日実行するか、毎週 1 日以上実行するかを選択します。
2. レポートを実行する時刻を選択します (タイムゾーンは UTC)。

レポート接続先

DCRは AppsFlyer Data Lockerを使用して、選択したクラウドサービスにレポートを配信します。したがって、レポートの送信先を指定するには、Data Lockerの接続を選択または作成する必要があります。

• 注意： DCRレポートの受信にData Lockerのプレミアムサブスクリプションは必要ありません。Data Lockerによるその他のAppsFlyerレポートの受信についての詳細は、CSMにお問い合わせいただくか、 hello@appsflyer.com にメールを送信してください。

レポートの接続先を設定してレポートを保存する：

1. AppsFlyerアカウントで利用可能なデータロッカー接続のリストから選択します。
   • アカウントに接続が定義されていない場合:
     • ブラウザに新規タブが開きます（AppsFlyerのData Lockerページが表示されます）。
     • 新規接続 ダイアログが開きます。こちらの手順に従って作成してください。
   • 既存の接続があっても新規接続を使用したい場合は、ボタンをクリックします。
     • ブラウザに新規タブが開きます（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_time
• attributed_touch_type
• brand
• campaign
• campaign_id
• channel
• city
• conversion_type
• country
• device_type
• dma
• event_name
• event_revenue_currency
• event_time
• geo_region
• install_time
• is_attributed
• Keywords
• match_type
• model
• partner
• platform
• site_id

event_value から抽出されたメトリックとカスタムソースからのメトリック（該当する場合）に加えて、次のアプリ内イベントのメトリックをレポートに含めることができます。

• event_revenue
• event_revenue_u_s_d