概要:インストールやリターゲティングイベントのユーザーレベルデータと、自社システムのデータを照合するアトリビューションデータレポートを作成します。
アトリビューションデータレポートの作成
以下の各タブに記載された手順に従って、アトリビューションデータレポートを作成します。
注意:読みやすさのため、手順を複数のタブに分けて説明しています。レポートを作成するには、すべての手順を完了する必要があります。
事前準備
- DCRの[レポート]タブに移動します。
- [+ 新しいレポート]ボタンをクリックします。
- ソースデータの種類として[アトリビューションデータ]を選択し、画面右下の[次へ]をクリックします。
- レポート名を入力します。
- DCR上でレポートを識別しやすい名前を指定してください。
- 重要:同じアカウント内の他のレポートと異なる名前を指定してください。名前が重複していると、レポートを保存できません。
- レポート名の要件:
- 長さ:2~80文字
- 使用できる文字:
- 英字(A-Z、a-z)
- 数字(0-9)。名前の先頭には使用できません。
- ハイフン(-)。名前の先頭には使用できません。
- 使用できない文字:
- スペース
- 上記以外の記号や特殊文字すべて
ソースの選択
レポートに使用するデータを指定します。
アトリビューションデータのソース
- アプリ:AppsFlyerアカウント内のアプリを1つ以上選択します。
-
アトリビューションの種類:レポートに使用するアトリビューションデータの種類を1つ以上選択します。
インストール ユーザーがモバイルアプリをダウンロード、インストールし、起動すると、インストールが記録されます。 再インストール ユーザーがアプリをインストールした後にアンインストールし、リアトリビューション期間内に再度インストールすると、再インストールが記録されます。 - 注意:リアトリビューション期間の長さは、[設定] > [アプリ設定]で設定します。
リエンゲージメント 特定のアプリを利用していなかったユーザーが、そのアプリのリターゲティングキャンペーンに接触し、その後アプリを起動すると、リエンゲージメントが記録されます。 リアトリビューション 特定のアプリをアンインストールした過去のユーザーが、そのアプリのリターゲティングキャンペーンに接触し、その後アプリを再インストールすると、リアトリビューションが記録されます。 オーガニックインストール 特定の媒体にアトリビューションされないインストールです。 - 注意:オーガニックインストールをレポートに含めると、スキャンする行数が大幅に増える場合があります。
- 対象期間:カスタムソースのイベントに一致するアトリビューションイベントをDCRが検索する際、何日前までのデータを対象にするかを1~180日で指定します。
カスタムソース
レポートの構成を定義する際は、設定済みのカスタムソースのデータを選択して使用できます。
ソースの結合
ソース間のデータを照合するには、レポートで使用する各カスタムソースに、アトリビューションデータの照合キーとなる識別子にマッピングされた識別子が必要です。
照合キーとなる識別子とは
アトリビューションデータの以下のいずれかの識別子を、照合キーとしてマッピングできます。
-
AppsFlyer ID(af_id):アプリのインストール時にAppsFlyerが生成する、一意の識別子です。
- AppsFlyerが記録するすべてのイベントに含まれます。
- アプリを削除して再インストールすると、新しいAppsFlyer IDが生成されます。
-
顧客ユーザーID(CUID):通常、ユーザー登録時にアプリ所有者が生成・設定する、ユーザー固有の識別子です。
- CUIDでデータをマッピングするには、SDKまたはサーバー間API(S2S)を通じてCUIDをAppsFlyerに送信するよう、アプリを設定する必要があります。
重要
CUIDによる照合を許可していない媒体もあります。 AppsFlyer IDの使用を強くおすすめします。
マッピング方法(直接/間接)
カスタムソースを複数使用するレポートでは、いずれか1つをアトリビューションデータの照合キーに直接マッピングすれば構いません。他のカスタムソースは、次の例のように直接または間接的にマッピングできます。
例
上図の例:
- カスタムソース#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に指定する必要があります。
一致するすべてのイベントの照合
最も包括的な方法では、一致するすべてのイベントをレポートに含められます。この方法を使用するには、レポートのカスタムソースのいずれかの識別子を、アトリビューションデータの識別子install_timeにマッピングする必要があります。
- install_timeにマッピングするソースの識別子には、yyyy-MM-dd HH:mm:ss形式を使用してください。
-
注意:識別子の名前は
install_timeですが、再インストール、リエンゲージメント、リアトリビューションについては、実際にはイベントの発生日時を意味します。
一致するイベントを1件だけ選択
再インストール、リエンゲージメント、リアトリビューションを含め、install_timeに識別子をマッピングしない場合は、条件に一致する候補のうち1件のイベントのみを選択できます。
イベントを1件だけ選択する際の動作は、AppsFlyerのアトリビューションデータソースのみを使用する場合と、カスタムソースを結合する場合で異なります。
- アトリビューションデータソースのみを使用する場合、指定期間内に特定の照合キーに一致するイベントのうち、
event_timeが最も新しいものが選択されます。 - カスタムソースを結合する場合は、一致する最後または最初のイベントのどちらをレポートに使用するかを選択します。
-
最後のイベント:指定期間内に特定の照合キーに一致するアトリビューションイベントのうち、
event_timeが最も新しいものを使用します。 -
最初のイベント:指定期間内に特定の照合キーに一致するアトリビューションイベントのうち、
event_timeが最も古いものを使用します。
-
最後のイベント:指定期間内に特定の照合キーに一致するアトリビューションイベントのうち、
レポートから得たい知見に最も関連するイベントに基づいて選択してください。
注意
レコードが重複している場合、DCRは同じappsflyer_idを持つレコードの重複を排除し、event_timeに基づいて最新のイベントを選択します。
ディメンションの選択
DCRは、ユーザーレベルのデータをレポートとして出力できません。選択したディメンションでデータを集計・グループ化し、意思決定に必要な知見を提供します。
ディメンションとは、地域、インストール日、キャンペーンなど、アプリユーザーを分類するための属性です。
レポートのディメンションの選択
アトリビューションデータレポートでは、以下をディメンションとして使用できます。
- 利用可能なアトリビューションデータのディメンション
- レポートのカスタムソース内でディメンションに分類したフィールド
レポートに含めるディメンションを選択する手順:
- 左側の[ソースのディメンション]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[レポートのディメンション]一覧に追加します。
- 一覧内のディメンションは、検索バーで検索できます。
- ディメンションを除外するには、[レポートのディメンション]一覧で選択し、[削除]ボタンを使って[ソースのディメンション]一覧に戻します。
- レポートに含めたいディメンションをすべて追加するまで、この操作を繰り返します。
注意:デフォルトでは、すべてのレポートがアトリビューションデータのディメンションmedia_sourceでグループ化されます。このディメンションを使用しない場合は、[レポートのディメンション]一覧から除外できます。
[任意]ディメンションの表示名の変更
デフォルトでは、アトリビューションデータまたはカスタムソース内のディメンション名が、そのままレポートに表示されます。レポート用にディメンション名を変更することもできます。
ディメンションの表示名を変更する手順:
- [レポートのディメンション]一覧で、表示名を変更するディメンション名にカーソルを合わせます。
- ディメンションの右側に表示される編集ボタン
をクリックします。
- レポートに表示する名前を入力します(最大50文字)。
- [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として出力されます。
- カスタムソースのディメンションにも再グループ化を適用する詳細設定については、以下をご覧ください。
[任意]ディメンションの優先度の管理
デフォルトでは、[レポートのディメンション]一覧の下から順に、アトリビューションデータのディメンションが除外されます。重要なディメンションを残せるよう、この順序を変更したり、選択したカスタムソースのディメンションにも再グループ化を適用したりできます。
ディメンションを除外する順序を変更する手順:
- [ディメンション優先度を管理]ボタンをクリックします。
- ディメンションを選択し、一覧内の目的の位置にドラッグします。右側の矢印ボタンでも移動できます。
- 一覧の最上部にある[最も高い優先順位]のディメンションは、再グループ化が必要になった場合、最後に除外されます。
- [任意]カスタムソースのディメンションに再グループ化を適用する手順:
- [詳細設定で再グループ化を調整]をクリックします。
- 再グループ化を適用するカスタムソースのディメンションを選択します。
- 選択したディメンションが[ディメンション優先度を管理]の一覧に追加されます。
- デフォルトでは、一覧の末尾に[最も低い優先順位]として追加されます。アトリビューションデータのディメンションと同様、前述の方法で並べ替えることができます。
-
[OK]をクリックして変更を保存します。
- メイン画面の[レポートのディメンション]一覧の表示順は変わりませんが、変更した優先順位は保存されています。選択内容を確認・編集するには、[ディメンション優先度を管理]ボタンを再度クリックします。
指標の選択
指標とは、収益、アプリの起動回数、LTVなど、アプリユーザーに関して収集した数値データです。ソース内で指標に分類した数値フィールドを使用できます。
レポートに含める指標を選択する手順:
- 左側の[ソースの指標]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[レポート指標]一覧に追加します。
- 一覧内の指標は、検索バーで検索できます。
-
[レポート指標]一覧の各指標について、以下のいずれかの集計方法を選択します。
- 数値の合計
- 重複を除いた値の件数
- 指標を除外するには、[レポート指標]一覧で選択し、[削除]ボタンを使って[ソースの指標]一覧に戻します。
- レポートに含めたい指標をすべて追加するまで、この操作を繰り返します。
[任意]指標の表示名の変更
デフォルトでは、アトリビューションデータまたはカスタムソース内の指標名が、そのままレポートに表示されます。レポート用に指標名を変更することもできます。
指標の表示名を変更する手順:
- [レポート指標]一覧で、表示名を変更する指標名にカーソルを合わせます。
- 指標の右側に表示される編集ボタン
をクリックします。
- レポートに表示する名前を入力します(最大50文字)。
- [OK]で表示名を保存するか、[X]でキャンセルします。
[任意]件数を集計する識別子の選択
デフォルトでは、レポートの各行の末尾に、その行にまとめられたAppsFlyer IDのユニーク数を示す列が追加されます。
ソース内の他の識別子についてもユニーク数の列を追加するには、以下の操作を行います。
- 左側の[ソースの識別子]一覧で1つ以上選択し、画面中央の[追加]ボタンを使って[ユニーク数を集計する識別子]一覧に追加します。
- 一覧内の識別子は、検索バーで検索できます。
- 識別子を除外するには、[ユニーク数を集計する識別子]一覧で選択し、[削除]ボタンを使って[ソースの識別子]一覧に戻します。
- レポートで件数を集計したい識別子をすべて追加するまで、この操作を繰り返します。
レポートの出力先の設定と保存
DCRは、AppsFlyer Data Lockerを使って、選択したクラウドサービスにレポートを配信します。そのため、出力先を指定する際は、Data Lockerのデータ接続を選択するか、新たに作成します。
- 注意:DCRレポートを受信するために、Data Lockerのプレミアム契約は必要ありません。 Data Lockerで他のAppsFlyerレポートも受信したい場合は、担当のCSMに連絡するか、hello@appsflyer.comにメールでお問い合わせください。
レポートの出力先を設定して保存する手順:
- AppsFlyerアカウントで利用できるData Lockerのデータ接続の一覧から選択します。
- アカウントにデータ接続が設定されていない場合:
- ブラウザーの新しいタブにAppsFlyerのData Lockerページが開きます。
- [新しいデータ接続]ダイアログが開きます。こちらの手順に従って、データ接続を作成します。
- 既存のデータ接続があっても、新たに作成する場合は、次の
ボタンをクリックします。
- ブラウザーの新しいタブにAppsFlyerのData Lockerページが開きます。
- [新しいデータ接続]ダイアログが開きます。こちらの手順に従って、データ接続を作成します。
- データ接続を作成したら、ブラウザーのDCRのタブに戻り、Data Lockerの一覧から新しいデータ接続を選択します。
- アカウントにデータ接続が設定されていない場合:
- [保存]をクリックしてレポートを保存します。
- Data Clean Roomの[レポート]タブに、新しいレポートが表示されます。
レポートが実行されるタイミング
レポートを作成して保存すると、使用するすべてのカスタムソースの新しいバージョンが検出されるたびに実行されます。
-
データウェアハウス(BigQuery、Snowflake)にあるソースでは、ソーステーブルの
v列に新しい値が検出されると、新しいバージョンが作成されたと認識されます。- 重要:レポートの完全性を確保するため、この列の値を変更する際は、必ずソーステーブルに一式のデータをすべて格納してください。
- 接続先のクラウドアカウントにソースファイルの新しいバージョンと対応する_SUCCESSファイルがアップロードされると、新しいバージョンが作成されたと認識されます。
AppsFlyerは、当日とその2日前までのソースについて、新しいバージョンを継続的にスキャンします。
リファレンス
利用可能なアトリビューションデータのディメンション
カスタムソースのディメンションに加え、以下のアトリビューションデータのディメンションでレポートをグループ化できます。
- media_source(デフォルトでレポートのディメンションに含まれます)
- ad
- ad_id
- ad_type
- adset_id
- adset_name
- app_id
- app_version
- attributed_touch_type
- brand
- campaign
- campaign_id
- channel
- city
- contributor_1_campaign¹
- contributor_1_engagement_type¹
- contributor_1_match_type¹
- contributor_1_media_source¹
- contributor_1_partner¹
- contributor_1_touch_type¹
- contributor_2_campaign¹
- contributor_2_engagement_type¹
- contributor_2_match_type¹
- contributor_2_media_source¹
- contributor_2_partner¹
- contributor_2_touch_type¹
- contributor_3_campaign¹
- contributor_3_engagement_type¹
- contributor_3_match_type¹
- contributor_3_media_source¹
- contributor_3_partner¹
- contributor_3_touch_type¹
- conversion_type
- country
- customer_id
- device_type
- dma
- engagement_type
- geo_region
- keywords
- match_type
- media_source
- model
- original_url
- partner
- platform
- site_id
¹ リエンゲージメントとリアトリビューションでは、これらのフィールドは空欄になります。