概要:データウェアハウス(BigQuery、Snowflake)やクラウドストレージのバケット(Amazon S3、GCS)を1つ以上設定し、Data Clean Roomとデータを共有してレポートを受信します。
概要
Data Clean Room(DCR)の利用には、以下の設定が必要です。
- 自社システムのファーストパーティデータ(カスタムデータソース)をDCRが読み込むクラウドサービスと保存場所。これらを使って入力用のデータ接続を作成します。
- DCRが処理後のレポートを配信するクラウドサービスと保存場所。これらを使って出力用のデータ接続を作成します。
入力用・出力用のデータ接続は、次の2段階で作成します。
- 手順1:選択したクラウドサービスの管理画面で、DCRと連携するための準備を行います(この記事で説明)。
- 手順2:AppsFlyer上で、クラウドサービスとDCRを接続します。詳しくは、「Data Clean Room | データ接続の管理」をご覧ください。
注意
データソースの要件の詳細は、「Data Clean Room | ソースの管理」をご覧ください。
- データ形式(すべてのデータソース)
- テーブルの列(データウェアハウス内のソース)
- ファイル名と形式(クラウドストレージのバケット内のソース)
対応するクラウドサービス
DCRへの入力用・出力用のデータ接続には、次の2種類のクラウドサービスを利用できます。
- データウェアハウス:BigQuery、Snowflake
- クラウドストレージのバケット:Amazon S3(AWS)、GCS
入力用・出力用のデータ接続に、いずれか1つのサービスを使用することも、複数を組み合わせることもできます。
重要
- 1つのレポートに複数のカスタムデータソースを使用する場合は、クラウドストレージのバケットに配置する必要があります。
- Amazon S3やGCSの同じバケットを入力用と出力用の両方に使用する構成は、一般的です。必ずこの構成用の手順に従ってください。
入力用のデータ接続に使うクラウドサービスの設定
以下の各タブの手順に従って、選択したクラウドサービスをDCRの入力用のデータ接続に使えるよう準備します。
データウェアハウス | BigQueryとSnowflake
BigQuery
注意:以下の操作は、Google Cloudの管理者が行う必要があります。
データセットを作成し、DCRに権限を付与する手順:
- Google Cloudコンソールにログインします。
- BigQueryのページに移動します。
- 新規または既存のGoogle Cloudプロジェクトに、DCR専用のデータセットを作成します。
-
左側のパネルで、プロジェクトIDの右側にある[View actions]ボタン
をクリックします。
-
[Create dataset]を選択します。
- 表示された右側のパネルで、データセット名を入力し、必要に応じて他のオプションを設定します。
- 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
- 推奨:入力用のデータ接続で使用することが分かる名前にします。
- テーブルの有効期限が切れるとDCRがソースを読み込めなくなるため、[Enable table expiration]は使用しないことを強くおすすめします。
- 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
-
ボタンをクリックします。
-
左側のパネルで、プロジェクトIDの右側にある[View actions]ボタン
- データセットに対する権限をDCRに付与します。
-
左側のパネルで、作成したデータセットの右側にある[View actions]ボタン
をクリックします。
- [Share]を選択します。
- 表示された右側のパネルで、
ボタンをクリックします。
-
[Add principals]セクションの[New principals]欄に、以下のアカウントを入力します。
appsflyer-dcr@dcr-report.iam.gserviceaccount.com -
[Assign roles]セクションで、[BigQuery > BigQuery Data Viewer]を選択します。
- [Save]をクリックします。
- [CLOSE]をクリックし、右側のパネルを閉じます。
-
左側のパネルで、作成したデータセットの右側にある[View actions]ボタン
Snowflake
注意:以下の操作は、SnowflakeのAccountadminが行う必要があります。
DCRで使用するプライベート共有を作成する手順:
- DCRに共有するデータがあるSnowflakeアカウントにログインします。
- ロールをAccountadminに切り替えます。
- 左側のパネルで[Private Sharing]を選択します。
-
表示されたページで、[Shared By Your Account]タブを選択します。
-
[Share]ボタンをクリックします。 表示された一覧で[Create a Direct Share]を選択します。
- DCRに共有するテーブルやビューを選択し、[Done]をクリックします。
- 必要に応じて[Secure Share Identifier]を変更し、説明を追加します(任意)。
-
[Add accounts in your region by name]欄に、Snowflakeアカウントのリージョンに応じて、以下のAppsFlyer Snowflakeアカウントを入力します。
リージョン AppsFlyerのアカウント 欧州西部(eu-west-1) QL63117 米国東部 | バージニア北部(us-east-1) MWB70410 米国東部 | オハイオ(us-east-2) BM15378 - [Create Share]ボタンをクリックします。
クラウドストレージのバケット | Amazon S3とGCS
DCRへのデータアップロードには、Amazon S3、GCS、または両方で、1つ以上のバケットを使用できます。ただし、多くの場合、単一のクラウドサービスに1つのバケットを用意する構成が最も管理しやすくなります。
- こちらの手順に従うと、同じバケットを入力用と出力用の両方に設定できます。
以下の要件は、両方のクラウドサービスのバケットに適用されます。
- 用途:バケットはAppsFlyer Data Clean Room専用にする必要があります。他のサービスからこのバケットにデータを書き込むことはできません。
- 権限:AppsFlyerのDCRサービスに、バケットへのアクセス権限を付与する必要があります。権限の付与方法は、以下のクラウドサービス別のタブをご覧ください。
-
名前:バケット名は、
af-dcr-またはaf-datalocker-で始める必要があります。- 例:
af-dcr-example-bucket
- 例:
-
DCRの命名要件:バケット、フォルダー、ファイルなど、DCRのすべてのデータ要素に以下の要件が適用されます。
- 最大長:200文字
- 使用できる文字:
- 英字
(A-Z, a-z) - 数字
(0-9)。名前の先頭には使用できません。 - ハイフン
(-)。名前の先頭には使用できません。 - 使用できない文字:
- スペース
- 上記以外の記号や特殊文字すべて
- 特定の用途でのみ使用できる文字:
-
- 等号
(=)。日付・バージョンフォルダーの名前に必要な箇所でのみ使用できます。 - アンダースコア
(_)。分割GZIPファイルの各部分を識別する場合、または_SUCCESSファイルの名前にのみ使用できます。 - ドット
(.)。ファイルの拡張子(.csv, .gzip)の直前にのみ使用できます。
- 等号
-
- 英字
Amazon S3
注意:以下の操作は、AWSの管理者が行う必要があります。
バケットを作成し、AppsFlyerに権限を付与する手順:
- AWSコンソールにログインします。
- S3サービスに移動します。
- バケットを作成します。
- [Create bucket]をクリックします。
-
[Bucket name]に、
af-dcr-またはaf-datalocker-に任意の文字列を続けた名前を入力します。上記のDCRの命名要件に従ってください。 - [Create bucket]をクリックします。
- AppsFlyerにバケットへの権限を付与します。
- 作成したバケットを選択します。
- [Permissions]タブに移動します。
-
[Bucket policy]セクションで[Edit]
をクリックします。[Edit bucket policy]ウィンドウが開きます。 - 以下のコードスニペットを貼り付けます。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AF-DCR-DL", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::195229424603:user/product=dcr-reporter__envtype=prod__ns=default", "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default" ] }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:DeleteObject", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::af-dcr-mybucket", "arn:aws:s3:::af-dcr-mybucket/*" ] } ] }
-
スニペット内の
af-dcr-mybucket(2か所)を、作成したバケットの名前に置き換えます。
注意:バケット名を置き換える際、2か所目の名前に続く/*を上書きしないよう注意してください。 -
[Save changes]をクリックします。
GCS
注意:以下の操作は、Google Cloudの管理者が行う必要があります。
バケットを作成し、AppsFlyerに権限を付与する手順:
- GCSコンソールにログインします。
- Cloud Storage Browserのページに移動します。
- バケットを作成します。
- [Create bucket]をクリックします。
-
[Create a bucket]ページで、バケットの情報を入力します。バケット名には、
af-dcr-またはaf-datalocker-に任意の文字列を続けた名前を指定します。上記のDCRの命名要件に従ってください。 - [Continue]をクリックします。
- [Create]をクリックします。
- AppsFlyerにバケットへの権限を付与します。
- 作成したバケットを選択します。
- [Permissions]タブに移動します。
-
[Permissions]セクションで[+ Add]をクリックします。
[Add members]ウィンドウが開きます。 -
[New members]欄に、以下のアカウントを入力します。
appsflyer-dcr@dcr-report.iam.gserviceaccount.com -
[Role]一覧から、[Cloud storage] > [Storage Admin]を選択します。
- [Save]をクリックします。
出力用のデータ接続に使うクラウドサービスの設定
DCRは、AppsFlyer Data Lockerを使って、選択したクラウドサービスにレポートを配信します。
- 注意:DCRレポートを受信するために、Data Lockerのプレミアム契約は必要ありません。 Data Lockerで他のAppsFlyerレポートも受信したい場合は、担当のCSMに連絡するか、hello@appsflyer.comにメールでお問い合わせください。
入力用と同じサービスを使用するかどうかにかかわらず、DCRレポートはクラウドサービス上の1つ以上の場所に配信できます。以下の各タブの手順に従って、出力用のデータ接続に使えるよう準備します。
データウェアハウス | BigQueryとSnowflake
BigQuery
注意:以下の操作は、Google Cloudの管理者が行う必要があります。
データセットを作成し、Data Lockerに権限を付与する手順:
- Google Cloudコンソールにログインします。
- BigQueryのページに移動します。
- 新規または既存のGoogle Cloudプロジェクトに、Data Locker専用のデータセットを作成します。
-
左側のパネルで、プロジェクトIDの右側にある[View actions]ボタン
をクリックします。
-
[Create dataset]を選択します。
- 表示された右側のパネルで、データセット名を入力し、必要に応じて他のオプションを設定します。
- 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
- 推奨:出力用のデータ接続で使用することが分かる名前にします。
- テーブルの有効期限が切れるとData Lockerがデータセットにレポートを書き込めなくなるため、[Enable table expiration]は使用しないことを強くおすすめします。
- 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
-
ボタンをクリックします。
-
左側のパネルで、プロジェクトIDの右側にある[View actions]ボタン
- データセットに対する権限をData Lockerに付与します。
-
左側のパネルで、作成したデータセットの右側にある[View actions]ボタン
をクリックします。
- [Share]を選択します。
- 表示された右側のパネルで、
ボタンをクリックします。
-
[Add principals]セクションの[New principals]欄に、以下のアカウントを入力します。
datalocker-bq-admin-prod@datalocker-bq-prod.iam.gserviceaccount.com -
[Assign roles]セクションで、[BigQuery > BigQuery Data Editor]を選択します。
- [Save]をクリックします。
- [CLOSE]をクリックし、右側のパネルを閉じます。
-
左側のパネルで、作成したデータセットの右側にある[View actions]ボタン
Snowflake
クラウドストレージのバケット | Amazon S3とGCS
クラウドストレージのバケットを出力用に準備する手順は、入力用のデータ接続の準備とほぼ同じです。両方のクラウドサービスに共通する要件も同様です。
以下の各タブは、バケットを出力用にのみ使用する場合の手順です。
- 同じバケットを入力用と出力用の両方に使う場合は、この構成用の手順に従ってください。
Amazon S3
入力用のAmazon S3バケットの作成手順を、そのまま実施します。
GCS
入力用のGCSバケットの作成手順に従います。その手順4では、[New members]欄に以下のアカウントを入力します。af-data-delivery@af-raw-data.iam.gserviceaccount.com
同じクラウドストレージのバケットを入力用・出力用の両方に設定する方法
前述のとおり、Amazon S3やGCSの同じバケットを入力用と出力用の両方に使う構成は一般的です。
設定手順は、入力用のデータ接続の手順と一部のみ異なります。 ただし、以下のどちらに該当するかによって、手順が異なります。
- DCRの入力用・出力用のデータ接続に使う新しいバケットを作成する場合、または
- Data Locker専用だったバケットを、DCRの入力用・出力用の両方に使うよう変更する場合
それぞれの手順を、以下の各タブで説明します。
Amazon S3
入力用・出力用の新しいバケットの作成
入力用のAmazon S3バケットの作成手順を、そのまま実施します。
Data Locker専用だった既存バケットの変更
Data Locker専用だった既存バケットを変更するには、DCRとData Lockerの両方からアクセスできるよう、バケットの権限を変更する必要があります。
バケットの権限を変更する手順:
- AWSコンソールにログインします。
- S3サービスに移動します。
- Data Locker専用だったバケットを選択します。
- [Permissions]タブに移動します。
-
[Bucket policy]セクションで[Edit]
をクリックします。[Edit bucket policy]ウィンドウが開きます。 -
ウィンドウの内容を以下のコードスニペットで置き換えます。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AF-DCR-DL", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::195229424603:user/product=dcr-reporter__envtype=prod__ns=default", "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default" ] }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:DeleteObject", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::af-dcr-mybucket", "arn:aws:s3:::af-dcr-mybucket/*" ] } ] }- スニペット内の
af-dcr-mybucket(2か所)を、作成したバケットの名前に置き換えます。 -
注意:バケット名を置き換える際、2か所目の名前に続く
/*を上書きしないよう注意してください。
- スニペット内の
- [Save changes]をクリックします。
GCS
入力用・出力用の新しいバケットの作成
入力用のGCSバケットの作成手順に従います。手順4を変更し、[New members]欄に以下の2つのアカウントを入力します。appsflyer-dcr@dcr-report.iam.gserviceaccount.comaf-data-delivery@af-raw-data.iam.gserviceaccount.com
Data Locker専用だった既存バケットの変更
Data Locker専用だった既存バケットを変更するには、DCRとData Lockerの両方からアクセスできるよう、バケットの権限を変更する必要があります。
バケットの権限を変更する手順:
- GCSコンソールにログインします。
- Cloud Storage Browserのページに移動します。
- Data Locker専用だったバケットを選択します。
- [Permissions]タブに移動します。
- [Permissions]セクションで、[+ Add]をクリックします。
[Add members]ウィンドウが開きます。 -
[New members]欄に、以下のアカウントを入力します。
appsflyer-dcr@dcr-report.iam.gserviceaccount.com -
[Role]一覧から、[Cloud storage] > [Storage Admin]を選択します。
- [Save]をクリックします。