概要:アトリビューションデータレポートを作成し、インストール / リターゲティングイベントからのユーザーレベルのデータをシステムのデータと照合します。
アトリビューションデータレポートの作成
アトリビューションデータレポートを作成するには、以下のタブに記載されている手順に従います。
注意:これらの手順は、読みやすくするためにタブに分割されています。レポートを作成するには、すべての手順を完了する必要があります。
準備手順
- Data Clean Roomのレポートタブに移動します。
- + 新しいレポートボタンをクリックします。
- ソースデータの種類として アトリビューションデータ を選択し、画面の右下隅にある 次へ をクリックします。
- レポートの名前を入力してください。
- これには、DCRプラットフォームでレポートを識別するのに役立つ任意の名前を指定できます。
- 重要!レポート名がアカウント内の他のすべてのレポートと異なることを確認してください。そうでない場合はレポートを保存できません。
- レポート名の要件:
- 文字数:2-80文字
- 利用可能な有効文字:
- 半角アルファベット(A-Z, a-z)
- 数字(0-9) - 最初の文字には使用できません
- ハイフン(-) - 最初の文字には使用できません
- 無効な文字:
- スペース
- その他すべての記号または特殊文字
ソースの選択
レポートに使用するデータを指定します:
計測データソース
- アプリ:AppsFlyerアカウント内のアプリを1つ以上選択します。
-
アトリビューションタイプ:レポートに使用するアトリビューションデータの種類を1つ以上選択します:
インストール 「インストール」は、ユーザーがアプリをインストールし、初回起動したときに記録されます。 再インストール 「再インストール」は、ユーザーがアプリを一度インストールしたがアンインストールし、リアトリビューション期間中にアプリを再インストールしたときに記録されます。 - 注記:リアトリビューション期間は、AppsFlyer管理画面 左メニュー 設定 > アプリ設定画面で確認・設定できます。
リエンゲージメント 「リエンゲージメント」は、ユーザーがリターゲティングキャンペーンに接触し、その後アプリを起動したときに記録されます。 リアトリビューション 「リアトリビューション」は、ユーザーが一度アンインストールしたがリターゲティングキャンペーンに接触し、その後再インストールしたときに記録されます。 オーガニックインストール 「オーガニックインストール」は、特定のメディアソースに紐付けられなかったインストールです。 - 注記:レポートにオーガニックインストールを含めると、スキャンされる行の数が大幅に増加する可能性があります。
- データ期間:DCRでカスタムソースイベントに一致するアトリビューションイベントを検索する過去データの日数を選択します(1〜180日)。
カスタムソース
レポート構造を定義するときに、設定した任意のカスタムソースからのデータを使用することを選択できます。
レポートソースの突合
ソース間でデータを突合するには、レポートで使用される各カスタムソースに、アトリビューションデータのキー識別子にマッピングされた識別子が含まれている必要があります。
キー識別子とは何ですか?
これらのアトリビューションデータ識別子のいずれかにキー識別子としてマッピングできます:
-
AppsFlyer ID (af_id):インストール時にAppsFlyerによって生成される一意のアプリ識別子。
- このIDは、AppsFlyerによって記録されたすべてのイベントに付随されています。
- アプリを削除して再インストールすると、新しいAppsFlyer IDが採番されます。
-
カスタマーユーザーID(CUID):通常、会員登録時などに事業者によって生成および設定される一意のユーザー識別子。
- CUIDを使用してデータをマッピングするには、SDKまたはサーバー間 API (S2S) を介して CUIDをAppsFlyerに送信するようにアプリ側で実装されている必要があります。
重要!
すべてのメディアソースにおいてCUIDを使用した照合が許可されているわけではないため、AppsFlyer IDを使用することを強くお勧めします。
マッピングスキーム(ダイレクト / インダイレクト)
レポートで複数のカスタムソースを使用している場合、アトリビューションデータキー識別子に直接マッピングする必要があるのはそのうちの 1つだけです。その他のカスタムソースは、次の例に示すように 直接的または間接的にマッピングできます:
例
上記のシナリオでは、次のようになります:
- カスタムソース #1 識別子 AppsFlyer は、アトリビューションデータデータキー識別子 af_id に直接マッピングされます。
- カスタムソース #2 は間接的にマッピングされます: user_code -> AppsFlyer --> af_id
- カスタムソース #3 は間接的に (より長いチェーンを通じて) マッピングされます:
user_id --> user_code --> AppsFlyer --> af_id. - カスタムソース #4 識別子 ID は、アトリビューションデータのキー識別子 af_idに直接マッピングされます。
- 代わりに間接的に(カスタムソース#3識別子user_idを介して)マッピングすることもできますが、どちらのオプションも正常に機能することに注意してください。
✓ このマッピングスキームは、各カスタムソースがアトリビューションデータキー識別子 af_id に直接的または間接的にマッピングされるため、すべてのソース間でデータを照合するように機能します。
複数の一致するイベントの処理を決定
注
このレポートで選択したアトリビューションタイプに非オーガニックインストールやオーガニックインストールのみが含まれている場合、このセクションは関係ありません。ディメンションの選択にスキップしてください。
レポートで選択したアトリビューションタイプに再インストール、リエンゲージメント、またはリアトリビューションが含まれている場合、選択した期間に同じキー識別子を持つ複数のイベントがアトリビューションデータに含まれる可能性があります。この場合、レポートに含める必要がある一致するイベントを DCRに指示する必要があります。
すべてのイベントの突合
最も包括的な突合方法では、一致するすべてのイベントをレポートに含めることができます。この結果を得るには、レポートのカスタムソースの 1 つにある識別子をアトリビューションデータ識別子 install_time にマッピングする必要があります。
- install_time にマップされるソース内の識別子は、yyyy-MM-dd HH:mm:ss の形式である必要があります。
-
注記:アトリビューションデータ識別子の名前は
install_timeですが、再インストール、リエンゲージメント、またはリアトリビューションイベントを指す場合は、実際にはevent_timeを意味します。
1つのイベントの照合
レポートに選択されたアトリビューションタイプに再インストール、リエンゲージメント、またはリアトリビューションが含まれているが、install_time にマッピングされた識別子がない場合、適格な候補から単一のイベントのみを選択できます。
AppsFlyerのアトリビューションデータソースが単独で使用される場合と、カスタムソースと結合される場合で、シングルイベントマッチングの動作が異なります。
- アトリビューションデータソースが単独で使用されると、AppsFlyerは特定のキー識別子に一致する時間枠内で最新の
event_timeと一致するイベントを選択します。 - カスタムソースと結合されたアトリビューションデータソースでは、レポートで last または first のいずれかの一致イベントを使用することを選択する必要があります。
- 最後のイベント:レポートに含まれるアトリビューションイベントは、特定のキー識別子に一致する期間内の最後のイベントです(時系列)。
-
最初のイベント:レポートに含まれるアトリビューションイベントは、特定のキー識別子に一致する期間内で最も最初の
event_timeを持つイベントです。
この選択は、レポートから取得する分析情報に最も関連があると考えられるイベントに基づいて行います。
注
レコードの重複がある場合、DCRは同じ appsflyer_id レコードを重複排除し、event_time に基づいて最新のイベントを選択します。
ディメンションの選択
ユーザーレベルのデータはDCRによってレポーティングできないことに注意してください。代わりに、選択したディメンションでデータを集計(またはグループ化)することで、必要な意思決定の分析情報を提供します。
ディメンションは通常、アプリユーザーを分類するための属性です(地域、インストール日、キャンペーンなど)。
レポートディメンションの選択
アトリビューションデータレポートのディメンションには、次のものが含まれます:
- いずれかの使用可能なアトリビューションデータディメンション
- レポートのカスタムソース内で ディメンションとして分類されているフィールド
レポートに含めるディメンションを選択する:
- 左側の ソースからのディメンションリストで 1つ以上のディメンションを選択し、画面中央の追加ボタンを使用してレポートディメンションの一覧に追加します。
- 検索バーを使用して、リスト内のディメンションを検索できます。
- ディメンションを削除するには、レポートディメンションリストからディメンションを選択し、削除ボタンを使用してソースからのディメンションリストに戻します。
- レポートに含める各ディメンションを追加するまで、このプロセスを繰り返します。
注記:デフォルトでは、すべてのレポートはアトリビューションデータディメンション media_source でグループ化されます。レポートでこのディメンションを使用しない場合は、レポートディメンションリストから削除できます。
[オプション] ディメンション表示名のカスタマイズ
デフォルトでは、ディメンション名はアトリビューションデータまたはカスタムソースで名前が付けられているとおりにレポートに表示されます。必要に応じて、レポートのディメンション名をカスタマイズできます。
ディメンションの表示名をカスタマイズする:
- レポートディメンションリストで、表示名を編集するディメンションの名前にカーソルを合わせます。
- ディメンションの右側に表示される編集ボタン
をクリックします。
- 名前をレポートで使用するディメンション表示名に変更します(最大50文字)。
- OKをクリックして表示名を保存するか、X をクリックしてキャンセルします。
ディメンションでグループ化(再グループ化)する際のプライバシー保護:
データセットのサイズ、選択したディメンションの数、その他の要因によっては、レポートに、ユーザーが少なすぎてレポートを作成できないグループが 1つ以上存在する場合があります。データがこのようにレポートされた場合、ユーザーレベルのデータの提供に対する制限に違反しています。
- 重要!レポートを許可するために必要な最小ユーザー数は、メディアソースによって異なります。
ただし、DCRは、レポートからデータを完全に削除または非表示にする代わりに、 再グループ化メカニズムを使用して、ユーザーのプライバシーを維持しながら可能な限り詳細なデータを提供します。
再グループ化の例
次のディメンションに従ってレポートを以下の順番通りに設定したとします:
-
アトリビューションデータのディメンション:
- media source
- campaign
- adset_name
- ad_id
-
カスタムソースのディメンション:
- user_type
再グループ化の前
データの初期分析後、DCRはデータが次のように分類されると判断します:
| media source |
campaign | adset name |
ad id |
user type |
rev D0 |
rev D7 |
count(合計回数) | 出力可否 |
|---|---|---|---|---|---|---|---|---|
| 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 | lkh12 | 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)を "削除" します。次に、データを再度分析して、レポート可能な行を確認します。
再グループ化の後
再グループ化ロジックを適用すると、レポートは次のように表示されます:
| media source |
campaign | adset name |
ad id |
user type |
rev D0 |
rev D7 |
count(合計回数) | 出力可否 |
|---|---|---|---|---|---|---|---|---|
| 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 は反復的にデータを分析し続け、次のいずれかになるまで次々にディメンションを削除します:
- すべての行をレポートできるようになる、もしくは
- 排除するアトリビューションデータディメンションを使い果たします
注記:デフォルトでは、DCRは アトリビューションデータディメンションにのみ再グループ化を適用します(カスタムソースディメンションには適用されません)。アトリビューションデータディメンジョンでグループ化されたデータのユーザーが 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接続のリストから選択します。
- 保存をクリックしてレポートを保存します。
- 新しいレポートがData Clean Roomのレポートタブに表示されます。
レポートはいつ実行されますか?
レポートを作成して保存すると、使用するすべてのカスタムソースの新しいバージョンが検出されるたびにレポートが実行されます。
-
データウェアハウス(BigQuery および Snowflake)のソースの場合、DCR は、ソースのテーブルの
v列に新しい値が検出されると、ソースの新しいバージョンが作成されたことを認識します。- 重要!レポートを完全なものにするには、列の値が変更されるたびに、ソースのテーブルに完全なデータを入力するようにしてください。
- DCRは、接続されたクラウドアカウントに新しいバージョンのソースファイルがアップロードされたことを検出したときに、ソースの新しいバージョンが作成されたことを認識します。その際、付随する_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
¹ リエンゲージメントおよびリアトリビューションの場合、レポートのこれらのフィールドは空白になります。