Data Clean Room — ソースの管理

プレミアム機能

概要: Data Clean Room (DCR) にアップロードするデータソースを設定して、AppsFlyerのアトリビューションデータとDCRレポート作成で強化します。

始める前に: Data Clean Room - クラウドストレージとデータファイルのセットアップを読み、クラウドストレージ設定とソースファイルの要件を理解してください。

はじめに

ソースデータファイルを作成したら、次の手順では、AppsFlyer DCR プラットフォームでソースを設定します。
ソースの定義は、次の 2つの主要な要素で構成されます:

既存のすべてのソースのリストは、Data Clean Roomの [ソース] タブで確認できます。

ソースの場所

ソースの場所は、クラウドストレージバケット(コネクタと呼ばれます)と、DCRが更新されるたびにソースファイルを読み取る基になるファイルパスで構成されます。

このバケットとファイルパスは、選択したクラウドサービスのインターフェイスを使用して作成されます。
例を含むこのプロセスの完全な手順について:
詳細はこちら

コネクタ

コネクタは、DCRデータが格納されているクラウドサービスバケット (AWS または GCS のいずれか) を識別します。これは、ソースデータのアップロード元とレポートの配信先の場所です。

  • 一般に、すべての DCRソースとレポートに同じバケットを使用するのが最も簡単です。ただし、バケットとクラウドサービスを AppsFlyer DCRプラットフォームでコネクタとして定義する限り、任意の組み合わせを使用できます。

コネクターを定義するには、次の手順に従ってください:

  1. Data Clean Roomのメインページから、右上隅にある コネクターの管理 をクリックします。
  2. 新しいコネクタ ダイアログで、クラウドサービスで作成したバケット名を正確に入力します。

ソースの場所がわからない場合はどうすればよいですか?

ソース構造を定義する前に、ソースの場所を指定するのがベストプラクティスです。
ただし、これはすべてのケースで可能とは限りません。
 例:クラウドストレージ構造がまだ確定していない場合など
ソースの場所を特定する前にソース構造の定義を続行する場合は、コンピューターからプロトタイプのソースファイル(ローカルファイル)をアップロードできます。

 重要!

ソースの場所が指定されるまで、ソースは保存できません。

ソースの場所がわかる前にソースを保存するには、 一時的な(動作していない場合でもソースの場所を使用してソースを保存します
ただし、DCR がこのソースを使用するレポートの処理を開始するには、 後で編集をクリックしてソースの実際の(作業中の)場所を指定する必要があります。

ソースの構造

処理のために DCRにアップロードするすべてのソースについて、AppsFlyer は、レポートを作成する目的で各データ項目をどのように使用するかを知る必要があります。
ソース構造の定義は、ソースファイルをロードし、各項目を以下のいずれかのタイプに分類することで構成されます。

  • 識別子: アプリのユニークユーザーを識別する項目(例:CUID, AppsFlyer IDなどが含まれます)
    • DCRのコンテキストにおける識別子の主な目的は、対応するユーザーレベルのデータを一致させることができるようにデータソースを結合することです。
  • ディメンション: アプリユーザーを分類する属性(例: 地域、インストール日、キャンペーンなど)
  • メトリック: アプリユーザーに関して収集した数値データ(収益、アプリ起動数、LTV など)
    • メトリックとして識別されるデータ項目には、 数値のみを含めることができます。

ソースの作成

ソースを作成するプロセスは、 以下で説明するすべてのステップで構成されます。
これらは、読みやすくするためにタブに分かれています。

準備手順

ソースを作成するには、次の手順に従います:

  1. Data Clean Roomソース タブに移動します。
  2. + 新しいソース ボタンをクリックします。
    新しいソース ページが開きます。
  3. ソースの名前を入力します。
    • これには、DCRプラットフォームでソースを識別するのに役立つ任意の一意の名前を指定できます。ファイル名と一致する必要はありません。
    • 重要! ソース名がアカウント内の他のすべてのソースと異なることを確認してください。そうでない場合、ソースを保存できません。
    • ソース名の要件:
      • 長さ:2-80文字
      • 利用可能な有効文字:
        • 半角アルファベット - (A-Z, a-z)
        • 数字 (0-9) - 名前の最初の文字にすることはできません
      • 無効な文字:
        • スペース
        • その他すべての記号または特殊文字
  4. AppsFlyerが項目をロードするためにソースファイルを読み込む必要がある場所に基づいて、以下の関連する手順に従ってください。

ソースの場所から項目を読み込む

ソースの場所から項目をロードするには:

  1. ソースの場所から項目を読み込む を選択します。ソースの場所とフォーマット ダイアログが開きます。
  2. ソースファイルパスがある コネクター を選択します。
    • アカウントにコネクターが定義されていない場合は、 [新しいコネクタ] ダイアログが開き、コネクタを作成するように求められます。
    • 既存のコネクタがあるが、新しいコネクタを使用する場合は、[ソースの場所と形式] ダイアログの右上にある [+ 新しいコネクタ] ボタンをクリックします。
  3. ソースフォルダのパスを入力します。
  4. ソースファイルをアップロードする形式を選択します。
  5. 適用をクリックして保存します。

ローカルファイルからの項目のロード

ローカルファイルから項目をロードするには:

  1. ローカルファイルから項目をロード を選択します。
  2. ファイルのアップロードダイアログが開きます。
  3. クリックしてアップロードをクリックし、プロトタイプソースファイルを選択します。
  4. 適用をクリックして保存します。

ソース構造の定義

以下のステップに従って、ソース構造を定義します:

  1. 上記の手順(ソースの場所またはローカルファイルから項目を読み込む)を完了すると、AppsFlyer がファイルを分析し、すべてのデータ項目(列)の一覧が 使用可能な項目リストに表示されます。
  2. 左側の 使用可能な項目リストで 1 つ以上の項目を選択し、画面中央のボタンを使用して、 識別子、ディメンション、またはメトリックとして分類します。
    • 項目を分類すると、画面右側の関連カテゴリ一覧に表示されます。
    • 検索バーを使用して、リスト内の項目を検索できます。
  3. 以前に割り当てられていたカテゴリから項目を削除するには、関連するカテゴリリストでその項目を選択し、削除ボタンを使用して 使用可能な項目 リストに戻ります。
  4. DCR レポートに含める各項目を分類するまで、このプロセスを繰り返します。
    • 使用可能な項目リスト内のすべての項目を分類する必要はありません。ただし、後でレポートで使用するには、項目を分類する必要があります。
    • 後でこのソースからの追加項目を使用することにした場合は、 ソース構造を編集することで使用できます。ただし、以前に分類されていない項目は、使用可能な項目リストに自動的には読み込まれないことに注意してください。これらの項目を操作するには、ソースの場所またはローカルファイルから項目を再ロードする必要があります。

ソースの保存

 注記

ソースを保存するには、ソースの場所を指定する必要があります。
永続的な場所をまだ指定できない場合でも、 ローカルファイルから項目を読み込む場合の以下の手順に進みますが、永続的な場所ではなく一時的な場所を指定します。一時的な場所は、作業場所である必要はありません
重要:このソースを使用するレポートの処理を DCR が開始するようにデータのアップロードを開始する場合は、ソースを編集して永続的な場所を指定する手順に従います。

ソースを保存するには、以下のステップに従ってください:

  1. ソースの場所から項目をロードした場合は、 保存をクリックします。
  2. ローカルファイルから項目をロードした場合:
    1. ソースの場所を設定をクリックします。ソースの場所とフォーマット ダイアログが開きます。
    2. ソースファイルパスがあるコネクタを選択します。
      1. アカウントにコネクターが定義されていない場合は、 [新しいコネクタ] ダイアログが開き、コネクタを作成するように求められます。
      2. このソースに新しいコネクタを使用する場合は、+ 新しいコネクタ ボタンをクリックします。
    3. ソースフォルダのパスを入力します。
      1. バケットとDCRキーフォルダが自動的に表示されます。
      2. DCRキーフォルダーに続く完全なパスを、2次レベルのデータソースフォルダを含むパスまで完全に入力します。
      3. ソースフォルダのパスは次のようになります。
        s3://af-dcr-example-bucket/01bcc5fb/input/BI-data/
    4. ソースファイルをアップロードする形式を選択します。
      • 重要!ここで選択したファイル形式がアップロードされたソースファイルの実際のファイル形式と一致しない場合、DCR処理は失敗します。
    5. 適用 をクリックして、ソースの場所を適用します。
    6. 保存 をクリックしてソースを保存します。
    7. 新しいソースがData Clean Roomの ソース タブに表示されます。

ソースの編集または削除

ソースを編集(または削除)するには、いくつかの方法があります。

  • ソース名の編集
  • ソースの場所またはファイル形式の編集
  • ソース構造の編集
  • ソースの削除(レポートに使用されていない場合)

ソース名の編集

ソース名を編集するには:

  1. Data Clean Roomソース タブに移動します。
  2. ソースのリストで、編集するソースの行にカーソルを合わせます。
  3. 行の右側に表示される編集ボタン edit_button.png をクリックします。
  4. ソースの編集ページで、ソースの名前を編集します。
  5. 更新 ボタンをクリックしてソースを新しい名前で保存するか、変更を破棄 で元に戻します。

ソースの場所またはファイル形式の編集

ソースの場所を編集するには:

  1. Data Clean Roomソース タブに移動します。
  2. ソースのリストで、編集するソースの行にカーソルを合わせます。
  3. 行の右側に表示される編集ボタン edit_button.png をクリックします。
  4. ソースの編集ページで、ソースの場所 セクションまで下にスクロールします。
  5. 現在のソースの場所の横にある編集ボタン edit_button.png をクリックします。
  6. [ソースの場所と形式] ダイアログで必要な変更を行います。
  7. [適用] をクリックして、変更を適用します。
  8. [更新] ボタンをクリックしてソースを新しい場所 / ファイル形式で保存するか、 [変更を破棄] で元に戻します。

ソース構造の編集

ソース構造を編集するには:

  1. Data Clean Roomソース タブに移動します。
  2. ソースのリストで、編集するソースの行にカーソルを合わせます。
  3. 行の右側に表示される編集ボタン edit_button.png をクリックします。
  4. [ソースの編集] ページでは、以前に識別子、ディメンション、または指標 として分類されていた項目が、画面の右側にある関連するカテゴリリストに表示されます。
  5. 以前に分類した項目を別のカテゴリに移動するには、ソースファイルから項目を再読み込みする必要はありません。これを行うには、次を参照してください:
    1. まず、関連するカテゴリリストから選択し、削除ボタンを使用して 使用可能な項目 リストに戻ります。
    2. 次に、使用可能な項目リストから選択し、画面中央のボタンを使用して識別子、ディメンション、またはメトリックとして分類します。
  6. まだ分類されていないソースファイル内の項目を処理するには、ソースの場所またはローカルファイルから項目を再ロードする必要があります。この選択を行うには、使用可能な項目リストの下部にある関連するボタンをクリックします。
  7. AppsFlyerがファイルを分析し、以前に分類されていないすべてのデータ項目(列)の一覧が 使用可能な項目リストに表示されます。
    • 以前に識別子、ディメンション、または指標として分類されていた項目は、画面の右側にある関連するカテゴリリストに表示されます。
    • 以前に分類された項目がリロードされたソースファイルで見つからない場合でも、関連するカテゴリリストに表示されますが、エラーアイコンでマークされます。
  8. 新しい項目を分類するには、左側の 使用可能な項目リストで 1 つ以上を選択し、画面中央のボタンを使用して識別子、ディメンション、またはメトリックとして分類します。
  9. 必要な変更をすべて行ったら、[更新] ボタンをクリックしてソースを更新された構造で保存するか、変更を破棄して元に戻します。

 重要!

このソースが使用されているレポートで、新しいソース構造を反映した対応する変更を行うことを忘れないでください。

  • 削除された項目、未分類の項目、または以前のカテゴリから変更された項目は、使用されているすべてのレポートから自動的に削除されます。
  • 新しく追加または分類された項目は、レポート定義を編集して含めるまで、既存のレポートに自動的には含まれません。

ソースの削除

  1. Data Clean Roomソース タブに移動します。
  2. ソースのリストで、編集するソースの行にカーソルを合わせます。
  3. 行の右側に表示される削除ボタン delete_button.png をクリックします。
  4. ダイアログで、ソースを削除することを確認します。
    • レポートで使用されているソースは削除できません。この場合、ソースが使用されているレポートがメッセージにリストされます。ソースを削除するには、次のいずれかを実行します:
      • 使用されているレポートを削除します。または、
      • ソース項目は、それらが使用されているレポートの定義から除去します。