ソース内のデータは、次の要件を満たしている必要があります：

• 日付 (のみ): yyyy-mm-dd（例：2023-04-18）
• 日時：
  • フォーマット: yyyy-MMM-dd hh:mm:ss (例、2023-APR-18 15:30:35)
  • タイムゾーン: UTC
• 数値： 小数点以下は最大2桁まで
• 文字列の長さ： 最大256文字
• 文字の制限：
  • フィールド名（列ヘッダー）: スペースや特殊文字は使用できません
  • その他すべてのデータ: 制限なし（すべての文字が有効です）

BigQuery または Snowflake のソース表には、処理のために共有されるデータに加えて、日付用の列とバージョン用の列の 2 つの追加列を含める必要があります

• 日付：
  • 列ヘッダー: dt
  • 列タイプ: date
  • データ形式: yyyy-mm-dd（例、2023-04-18）
  • 追加：BigQuery の表は、この列で パーティション分割する必要があります
• バージョン：
  • 列ヘッダー: v
  • 列タイプ: 文字列
  • データ形式: 数値（例: 1、2、3、10）
  • 重要！ DCR がこの列で新しい値を検出するたびに、新しいバージョンのレポートがトリガーされます。 レポートの完全性を確保するため、列の値が変更されるたびに、ソース表に完全なデータセットを投入してください。

Amazon S3 または GCS に保存されているソースファイルは、以下のファイル名および形式の要件を満たしている必要があります：

• ファイル名は DCR の命名要件に準拠している必要があります
• CSV または GZIP 形式
  • GZIP 圧縮の基になるファイルは CSV ファイルである必要があります。
• データフォルダごとのデータソースファイル数：
  • CSV: 最大 1
  • GZIP: 最大 1 つの単一パートファイル。 マルチパート GZIP ファイルは、次のように命名されている場合にサポートされます: filename_part01.csv.gz、filename_part02.csv.gz など。

1. AppsFlyerで、サイドメニューから Collaborate > Data Clean Room を選択します。
    

   

2. （メインページまたは［Sources］タブで）［+ New source］をクリックします。
    

   

3. Proceed with the New source walkthrough steps：

ソース名を入力します。 ソースを識別しやすい任意の一意の名前を付けることができます。 また、ソースに何が含まれているかを簡単に識別できるよう、任意で説明を追加することもできます（例: 「2025年のすべての購入」）。

要件とガイドライン

• ソース名が、アカウント内の他のすべてのソースと重複しない一意の名前であることを確認してください。 重複していると、ソースを保存できません。
• クラウド連携の場合、名前はファイル名と一致する必要はありません。
• ソース名の要件：
  • 長さ: 2-80文字
  • 有効な文字：
    • 英字 (A-Z, a-z)
    • 数字 (0-9)、名前の先頭文字には使用できません。
    • アンダースコア "_"
  • 無効な文字：
    • スペース
    • その他すべての記号または特殊文字

ソースの場所を指定するには：

1. ソースが作成される（または作成された）接続を選択します。
   • アカウントに接続が定義されていない場合は、New connectionダイアログが開き、接続を作成するように求められます。 こちらの手順に従って作成してください。
   • 既存の接続がある場合でも新しい接続を使用したい場合は、+ New connectionをクリックし、こちらの手順に従って作成してください。
2. ソースのデータの場所に応じて、以下の該当する手順に進みます。

注: データ量が多い場合に最適なパフォーマンスを得るため、データの一部が別途保存されることがあります。 このデータは、ソースが更新されるたびに更新され、ソースが削除されると削除されます。

BigQueryにおけるソースの場所

BigQueryのソースの場所の指定を完了するには：

1. ソースの表があるデータセットを選択します。
2. ソースデータがある表を選択します。

これらの選択を行うリストには、接続作成時に指定したBigQueryプロジェクトで使用可能なデータセットと表がそれぞれ含まれています。

Snowflakeのソースの場所

Snowflakeのソースの場所の指定を完了するには：

1. ソースデータを含む共有を選択します。
2. ソースの表があるスキーマを選択します。
3. ソースデータがある表を選択します。

これらの選択を行うリストには、接続作成時に指定したSnowflakeアカウントで利用可能な共有、スキーマ、表がそれぞれ含まれています。

クラウドストレージバケット内のソースの場所

Amazon S3またはGCSのソースの場所は、接続によって指定されたクラウドストレージバケットと、DCRが更新されるたびにソースファイルを読み込む基となるフォルダパスで構成されます。 

接続を指定すると、AppsFlyerはソース作成プロセスの一部として、必要な基となるフォルダパスを自動的に生成できます。

• AppsFlyerでフォルダを生成できるようにすると、プロセスが簡単になります。 ただし、こちらで詳しく説明されている手順に従って、代わりに手動で作成することもできます。

AppsFlyerがフォルダを作成する場合、必要な追加情報はソースフォルダに付ける名前だけです （これは最上位レベルのフォルダで、新しいレポートバージョンを実行するためにソースを使用するたびに、ソースを更新します。） また、ソースフォルダを親フォルダ– 多くの場合はinput.という名前のフォルダの下に作成するかどうかを指定することもできます

クラウドストレージバケット内のソースの場所の指定を完了するには、ソースフォルダ名を入力します。

• デフォルトでは、表示されるソースフォルダ名は次のようになっています：
  • ソースに付けた名前に基づいています。 フォルダ名は、DCRの名前付け要件に準拠している限り、必要に応じて変更できます。
  • input.という名前の親フォルダ内に生成されることを示します。 このフォルダは、DCR にアップロードするすべてのソースの親フォルダとして利用されます。
    • input フォルダは必須ではなく、DCRの名前付け要件に準拠している限り、削除したり、別の名前を付けたりできます。
    • このフォルダは必須ではありませんが、inputフォルダ（または別の名前の同等のフォルダ）を用意することがベストプラクティスとされています。 データファイルのアップロード（入力）とレポートの受信（出力）の両方に同じクラウドストレージバケットを使用している場合には、さらに強く推奨されます。

ローカルファイルとしてのソースの場所 

ローカルファイルを使用してソースデータをアップロードすることもできます。 ただし、ソースの場所としてクラウドサービスを設定することを強く推奨します（大規模なデータセットや自動更新では特に重要です）。 ローカルファイルは主に、テスト目的やプラットフォームの機能に慣れるために使用されます。 

ローカルファイルを使用してソースデータをアップロードするには： 

ソースの場所を選択する際に、［Local file system］、次に［Next］をクリックすると、デバイスからローカルファイルをアップロードするオプションが追加されます。 

Data Collaboration Platform（DCP）でソースを設定する際は、そのソースの更新をどのように処理するかを選択する必要があります。 DCPは2つの同期方法（SnapshotとAppend）をサポートしています。 各方法は、異なるユースケースやデータフローに適しています：

• Snapshot - この方法では、ソースが更新されるたびにデータセット全体をアップロードし、毎回古いデータセットを新しいデータセットで完全に置き換えます。 ファイルのアップロードに常に完全かつ最新のデータセットが含まれている場合にのみ、この方法を選択してください。
• Append - この方法では、データセット全体ではなく、新規または変更されたデータのみをアップロードします。 古いデータセットは削除も更新もされません。 日次レポートや週次レポートのような定期的なアップロードに最適です。 メリットとして、アップロードサイズの縮小（クラウドストレージのコスト低減につながる可能性があります）、データアップロードのパフォーマンス向上、レコード管理の簡素化などが挙げられます。

Snapshotアップロードの要件

この方法は、ソースが更新されるたびに以前のデータセットを完全に置き換える、完全で自己完結型のファイルをアップロードする場合に使用します。

サポートされているクラウドサービス

• Amazon S3
• Google Cloud Storage（GCS）
• BigQuery
• Snowflake

Snapshot更新方法については、以下のガイドラインに従ってください：

1. ソースフォルダのパス

   DCPでクラウドストレージのソースを登録すると、そのソースのルートパス（例: input/my_source_folder/）が定義されます。 データセットを更新するたびに、現在のすべての行を含むファイルである完全スナップショットをこのフォルダにアップロードします。 これにより、DCPは常に最新かつ完全なデータビューを処理できます。

2. 完全スナップショットファイルのアップロード

/v=1/data/

/v=1/

フォルダ構成：

s3://af-dcr-xyz/abcd9876/input/source_name1/dt=2025-mm-dd/v=1/data/\n└ bucket ┘ └ tenant ┘ └ingestion┘ └source┘└snapshot date┘└ver┘└files┘

2日分のスナップショット構造の例：

source_name1/
  dt=2025-08-10/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS
  dt=2025-08-11/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS

2日分のソースファイルの完全なスナップショットをアップロードした後（および、プログラムで日付 / バージョン / データフォルダと _SUCCESS ファイルを作成した後）、バケット / フォルダ構造は次のようになります：
 

Appendのアップロード要件

この方法は、前回のアップロード以降に変更または追加されたデータのみをアップロードする場合に使用します。

Appendを使用する理由？

• 効率性 – アップロードサイズを小さくできます
• データ整合性 – 時系列分析のために完全な変更履歴を保持します
• プライバシーコンプライアンス – レコードの削除 & 同意管理を簡素化します

サポートされているクラウドサービス: AWS S3 と Google Cloud Storage（GCS）
注: BigQuery と Snowflake は Append メソッドではサポートされていないため、Snapshot メソッドを使用する必要があります。

Append 更新方法については、次のガイドラインに従ってください：

1. ソースフォルダの設定

2. 追加（差分）ファイルのアップロード

フォルダーの構成：

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/
└ バケット ┘ └ テナント ┘ └ 取り込み ┘ └ ソース ┘ └ 日別パーティション ┘

週次差分フォルダー構造の例：

source_name/
  dt=2025-08-04/
  dt=2025-08-05/
  dt=2025-08-06/
  dt=2025-08-07/
  dt=2025-08-08/
  dt=2025-08-09/
  dt=2025-08-10/

経験則チートシート：

重要なポイント: 週次でアップロードする場合でも、データは必ず日付ごとのdt=YYYY‑MM‑DDフォルダーに整理してください。

ソースフィールドをDCPフィールドにマッピングし、テストして、設定したデータを保存します：

1. ソースフィールドを読み込む
2. ソースフィールドを設定
3. EUユーザーの対象範囲を確認
4. ソースデータをテスト
5. ソースを保存します

1. ソースフィールドを読み込みます

ソースフィールドは自動的に読み込まれます。 手動での読み込みが必要な場合は、ソースの場所に応じて以下の手順に従ってください：

データウェアハウスのソース

データウェアハウス（BigQuery または Snowflake）にあるソースからフィールドを読み込むには、［ソースからフィールドを読み込む］をクリックします。

クラウドストレージバケットのソース

クラウドストレージバケット（Amazon S3 または GCS）にあるソースからフィールドを読み込むには、プロトタイプソースファイルをアップロードする必要があります。

ソースフィールドをDCPフィールドにマッピングする目的： 

• ローカルファイルからソースのプロトタイプ版をアップロードできます。
  • このオプションを選択すると、AppsFlyer は常にソースフォルダパスを自動的に作成します。

                                                                - または -

• 接続済みのクラウドストレージバケットからソースファイルのプロトタイプ版を直接アップロードできます。
  • このオプションを選択すると、追加で選択する項目が1つあります：
    • AppsFlyerがソースファイル用のクラウドフォルダを自動的に生成することを許可する、または
    • ソースファイル用のクラウドフォルダを手動で作成する

プロトタイプのソースファイルをアップロードするには、以下の該当するタブの手順に従います：

2. ソースフィールドを設定する

ソースフィールドを読み込むと、各ソースフィールド（列）にDCPフィールドが表示されます。 各ソース項目を確認し、横のドロップダウンリストからそれぞれを適切なDCP項目にマッピングします。 考慮事項：

項目を削除するには：

• 削除する項目の右側にカーソルを合わせ、ホバー時に表示されるごみ箱アイコンをクリックします。

項目を手動で追加するには：

このオプションを使うと、現在データソースに存在しない項目をオーディエンスに含めることができます。

1. + New fieldをクリックします。 空の項目が追加されます。
2. 項目名を入力し、タイプを選択します。
    

項目タイプには次のものがあります: 

• 識別子
  • Android ID
  • AppsFlyer ID
  • CUID
  • メール
  • ハッシュ化されたメール
  • ハッシュ化されたメール（ドットなし）
  • IDFA
  • IPアドレス
  • ID5 ID
  • MediaMath Id
  • モバイル広告ID
  • 電話番号
  • ハッシュ化された電話番号（+なし）
  • プラットフォームID
  • SHA256でハッシュ化されたID
  • 電話番号のSHA256ハッシュ
  • ZIP+5コード
  • ZIP+4コード
  • LUID
  • 個人ID
• 識別子の一覧
  • ハッシュ化されたメールアドレス（ドットなし）
  • ハッシュ化された電話番号（プラス記号なし）
  • ハッシュ化されたメールアドレス
  • ハッシュ化された電話番号
  • メール
  • 電話番号
  • ID5 Ids
  • MediaMath Ids
  • モバイル広告Ids
  • IDFAs
  • Android IDs
  • IPアドレス
• ブール値
• 日時
  • 日時
  • 日付
• DMA
  • 広告のパーソナライズが有効
  • 広告のユーザーデータが有効
  • EU DMAが適用される
• 数
  • 倍精度浮動小数点数
  • 数値のリスト
  • Long
  • 数
• テキスト
  • テキスト
  • アプリID
  • テキストのリスト

識別子 vs. 識別子のリスト：

識別子タイプは、行ごとに単一の値（例：1行につきメールアドレス1件、またはCUID1件）を保持します。 識別子のリストタイプは、行ごとに値の配列を保持します（例：1行に複数のハッシュ化されたメールやデバイスIDを含めることができます）— 1レコードあたり複数の識別子で照合する必要があるソースに使用します。

ソースフィールドを再読み込み

データファイルのいずれかの設定が変更された場合は、変更内容を反映するようにソースファイルを更新できます。

ファイルから更新済みのフィールドを再読み込みするには：

1. ［フィールドを再読み込み］をクリックします。
2. ファイルの場所を選択します。
   • ローカルファイルの場合: ファイルをアップロードします。
   • クラウドサービス上のファイルの場合: ［クラウドのバケットから読み込む］をクリックし、指示に従います。
3. OK をクリックします。 更新されたファイルが表示されます。 

3. EUユーザーの含有を確認

• 次の質問に対して［はい］または［いいえ］を選択します: ソースには、EU DMA規制が適用される欧州のユーザーが含まれていますか？

EUデジタル市場法に関するプライバシー規制の詳細はこちら。

4. ソースデータをテスト

• [任意] ［テスト］をクリックして、ソースフィールドの形式や有効性にエラーがないかどうかチェックします。

5. ソースを保存します

• ［保存］をクリックしてソースを保存します。

確認後、新しいソースが［Sources］タブの下に追加されます。

1. Data Clean Roomのソースタブに移動します。
2. ソースの一覧で、編集するソースにカーソルを合わせ、行の末尾にある編集アイコン をクリックします。
3. ソースの編集ページで、以下の説明に従って該当する項目を編集します。
4. [保存] をクリックします

ソース名の編集

ソース名を編集する際は、これらの命名要件に従ってください。

 ソースの場所の編集

1. ソースの編集ページ > ソースの場所 で、別のデータ接続を選択します。
2. 該当する場所の詳細を選択します。
3. ［任意］ソースをテストします。
4. [保存] をクリックします

フィールドマッピングの編集

1. フィールドマッピングに移動し、必要な変更を行います。フィールドを変更するか、マッピング先のDCPフィールドを更新します。
2. [保存] をクリックします。

オーディエンスで使用されている場合を除き、任意のソースを削除できます。 その場合は、通知にそのソースを使用しているオーディエンスが表示されます。 ソースを削除できるようにするには、まずリンクされているオーディエンスを削除する必要があります。 共有されているソースは、ソースの所有者のみが削除できます。

1. Data Clean Roomの ソース タブに移動します
2. ソースのリストで、削除するソースの行にカーソルを合わせます。
3. 行の右側に表示される削除アイコン をクリックします。
4. ダイアログで、確認のため［削除］をクリックします。

一般に最も簡単な方法は、AppsFlyerがソース作成プロセスの一部として必要なフォルダ構造を自動的に生成できるようにすることです。 ただし、これらのフォルダを手動で作成したい場合は、次の手順に従ってください。

DCR キーフォルダの作成

最大限の安全性を確保するには、バケットの直下のフォルダ（「DCRキーフォルダ」）に、アカウントに割り当てられた8文字の英数字のDCRキー（例：01bcc5fb）を名前として付ける必要があります。 これは、AppsFlyerアカウントに関連付けられている他のパスワードやキーとは異なりますのでご注意ください。

DCR キーフォルダーは、通常、選択したクラウドサービスのインターフェイスを使用して手動で作成されます。

アカウントのDCRキーを取得するには：

• 右上の3点（アクション）メニューをクリックし、［DCR key］を選択します。

DCRキーフォルダを作成すると、バケット/フォルダ構造は次のようになります：

最上位のインプット用フォルダ

必須ではありませんが、ベストプラクティスとして、DCRキーフォルダの直下に最上位のインプット用フォルダを作成することを推奨します。 このフォルダは、DCRにアップロードするファイル専用です。

最上位のインプット用フォルダーは、通常、選択したクラウドサービスのインターフェイスを使用して手動で作成されます。

• この方法は、データファイルのアップロード（入力）とレポートの受信（出力）の両方に同じバケットを使用している場合には、さらに強く推奨されます。
• このフォルダーには、DCRの名称設定要件に準拠している限り、任意の名前を付けることができます。 識別を容易にするために、通常は input/ という名前が付けられています。

最上位の入力フォルダを作成した後、バケット/フォルダの構成は次のようになります：

各データソースの第2レベルのフォルダー

処理のために、さまざまなデータソースファイルを定期的に DCRにアップロードできます。 これらの各データソースには、個別のフォルダ（「データソースフォルダ」）を割り当てる必要があります。

たとえば、毎日 DCR に 2 つのファイルをアップロードして処理する予定の場合: BI-data.csv と CRM-data.gzip をそれぞれデータソースとして扱い、各データソースにフォルダを割り当てます。 これらのフォルダは、BI-data/ と CRM-data/ という名前にできます。

データソースフォルダは通常、選択したクラウドサービスのインターフェイスを使用して手動で作成します。

2つのデータソースフォルダを作成した後、バケット/フォルダの構成は次のようになります：

各データソースフォルダの下には、ソースが更新されるたびに、日付とバージョンごとのネストされたサブフォルダを作成する必要があります。

Google は、デジタル市場法（DMA）の施行の一環として、March 6, 2024 付で EU ユーザーの同意ポリシーを更新しました。 Google公式アプリアトリビューションパートナーとして、AppsFlyerは、広告主がGoogle広告のマーケティングチャネルから最大限の値を引き出せるようにしながら、同社のポリシー要件をサポートするために必要な変更を行いました。 

同意フィールドの追加

Google でのオーディエンス有効化を目的としたソースを設定する際、質問「Does your source involve European users subject to EU DMA regulations?」に対して Yes を選択した場合 以下の表にある追加の同意項目がソースファイルに含まれていることを確認してください。 これにより、AppsFlyerは有効化プロセス中に必要な情報をGoogleに送信できるようになります。

追加の同意項目とそのレスポンス値：

オーディエンスサイズへの潜在的なインパクト

Googleに送信される実際および推定のオーディエンスサイズは、同意を付与または拒否するユーザー数に応じて変動する場合があります。