どのようにお手伝いできますか?

Data Clean Room | クラウドサービスの設定 プレミアム機能

  • 更新

概要:データウェアハウス(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に権限を付与する手順: 

  1. Google Cloudコンソールにログインします。
  2. BigQueryのページに移動します。
  3. 新規または既存のGoogle Cloudプロジェクトに、DCR専用のデータセットを作成します。
    1. 左側のパネルで、プロジェクトIDの右側にある[View actions]ボタンBQ_view_actions_button.pngをクリックします。
    2. [Create dataset]を選択します。

      BQ_create_dataset.png

    3. 表示された右側のパネルで、データセット名を入力し、必要に応じて他のオプションを設定します。
      • 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
        • 推奨:入力用のデータ接続で使用することが分かる名前にします。
      • テーブルの有効期限が切れるとDCRがソースを読み込めなくなるため、[Enable table expiration]は使用しないことを強くおすすめします。
    4. BQ_create_dataset_button.pngボタンをクリックします。

  4. データセットに対する権限をDCRに付与します。
    1. 左側のパネルで、作成したデータセットの右側にある[View actions]ボタンBQ_view_actions_button.pngをクリックします。
    2. [Share]を選択します。
    3. 表示された右側のパネルで、BQ_add_principal_button.pngボタンをクリックします。
    4. [Add principals]セクションの[New principals]欄に、以下のアカウントを入力します。
      appsflyer-dcr@dcr-report.iam.gserviceaccount.com
    5. [Assign roles]セクションで、[BigQuery > BigQuery Data Viewer]を選択します。

      BQ_data_viewer.png

    6. [Save]をクリックします。
    7. [CLOSE]をクリックし、右側のパネルを閉じます。

Snowflake

注意:以下の操作は、SnowflakeのAccountadminが行う必要があります。

DCRで使用するプライベート共有を作成する手順:

  1. DCRに共有するデータがあるSnowflakeアカウントにログインします。
  2. ロールをAccountadminに切り替えます。
  3. 左側のパネルで[Private Sharing]を選択します。
  4. 表示されたページで、[Shared By Your Account]タブを選択します。

    snowflake_private_sharing.png

  5. [Share]ボタンをクリックします。 表示された一覧で[Create a Direct Share]を選択します。

    snowflake_create_direct_share.png

  6. DCRに共有するテーブルやビューを選択し、[Done]をクリックします。
  7. 必要に応じて[Secure Share Identifier]を変更し、説明を追加します(任意)。
  8. [Add accounts in your region by name]欄に、Snowflakeアカウントのリージョンに応じて、以下のAppsFlyer Snowflakeアカウントを入力します。
    リージョン AppsFlyerのアカウント
    欧州西部(eu-west-1) QL63117
    米国東部 | バージニア北部(us-east-1) MWB70410
    米国東部 | オハイオ(us-east-2) BM15378
  9. [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)。名前の先頭には使用できません。
      • ハイフン(-)。名前の先頭には使用できません。
      • 使用できない文字:
        • スペース
        • 上記以外の記号や特殊文字すべて
      • 特定の用途でのみ使用できる文字:

Amazon S3

注意:以下の操作は、AWSの管理者が行う必要があります。

バケットを作成し、AppsFlyerに権限を付与する手順: 

  1. AWSコンソールにログインします。
  2. S3サービスに移動します。
  3. バケットを作成します。
    1. [Create bucket]をクリックします。
    2. [Bucket name]に、af-dcr-またはaf-datalocker-に任意の文字列を続けた名前を入力します。上記のDCRの命名要件に従ってください。
    3. [Create bucket]をクリックします。
  4. AppsFlyerにバケットへの権限を付与します。
    1. 作成したバケットを選択します。 
    2. [Permissions]タブに移動します。 
    3. [Bucket policy]セクションで[Edit]
      をクリックします。
      [Edit bucket policy]ウィンドウが開きます。
    4. 以下のコードスニペットを貼り付けます。
      {
        "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/*"
            ]
          }
        ]
      }
      
  5. スニペット内のaf-dcr-mybucket(2か所)を、作成したバケットの名前に置き換えます。
    注意:バケット名を置き換える際、2か所目の名前に続く/*を上書きしないよう注意してください。

  6. [Save changes]をクリックします。

GCS

注意:以下の操作は、Google Cloudの管理者が行う必要があります。

バケットを作成し、AppsFlyerに権限を付与する手順: 

  1. GCSコンソールにログインします。
  2. Cloud Storage Browserのページに移動します。
  3. バケットを作成します。
    1. [Create bucket]をクリックします。
    2. [Create a bucket]ページで、バケットの情報を入力します。バケット名には、af-dcr-またはaf-datalocker-に任意の文字列を続けた名前を指定します。上記のDCRの命名要件に従ってください。
    3. [Continue]をクリックします。
    4. [Create]をクリックします。
  4. AppsFlyerにバケットへの権限を付与します。
    1. 作成したバケットを選択します。 
    2. [Permissions]タブに移動します。 
    3. [Permissions]セクションで[+ Add]をクリックします。
      [Add members]ウィンドウが開きます。
    4. [New members]欄に、以下のアカウントを入力します。
      appsflyer-dcr@dcr-report.iam.gserviceaccount.com
    5. [Role]一覧から、[Cloud storage] > [Storage Admin]を選択します。

      dcr_gcs_permissions.png

    6. [Save]をクリックします。

出力用のデータ接続に使うクラウドサービスの設定

DCRは、AppsFlyer Data Lockerを使って、選択したクラウドサービスにレポートを配信します。

  • 注意:DCRレポートを受信するために、Data Lockerのプレミアム契約は必要ありません。 Data Lockerで他のAppsFlyerレポートも受信したい場合は、担当のCSMに連絡するか、hello@appsflyer.comにメールでお問い合わせください。

入力用と同じサービスを使用するかどうかにかかわらず、DCRレポートはクラウドサービス上の1つ以上の場所に配信できます。以下の各タブの手順に従って、出力用のデータ接続に使えるよう準備します。

データウェアハウス | BigQueryとSnowflake

BigQuery

注意:以下の操作は、Google Cloudの管理者が行う必要があります。

データセットを作成し、Data Lockerに権限を付与する手順: 

  1. Google Cloudコンソールにログインします。
  2. BigQueryのページに移動します。
  3. 新規または既存のGoogle Cloudプロジェクトに、Data Locker専用のデータセットを作成します。
    1. 左側のパネルで、プロジェクトIDの右側にある[View actions]ボタンBQ_view_actions_button.pngをクリックします。
    2. [Create dataset]を選択します。

      BQ_create_dataset.png

    3. 表示された右側のパネルで、データセット名を入力し、必要に応じて他のオプションを設定します。
      • 英字、数字、アンダースコア(_)のみを使い、任意の名前を指定できます。
        • 推奨:出力用のデータ接続で使用することが分かる名前にします。
      • テーブルの有効期限が切れるとData Lockerがデータセットにレポートを書き込めなくなるため、[Enable table expiration]は使用しないことを強くおすすめします。
    4. BQ_create_dataset_button.pngボタンをクリックします。

  4. データセットに対する権限をData Lockerに付与します。
    1. 左側のパネルで、作成したデータセットの右側にある[View actions]ボタンBQ_view_actions_button.pngをクリックします。
    2. [Share]を選択します。
    3. 表示された右側のパネルで、BQ_add_principal_button.pngボタンをクリックします。
    4. [Add principals]セクションの[New principals]欄に、以下のアカウントを入力します。
      datalocker-bq-admin-prod@datalocker-bq-prod.iam.gserviceaccount.com
    5. [Assign roles]セクションで、[BigQuery > BigQuery Data Editor]を選択します。

      BQ_data_editor.png

    6. [Save]をクリックします。
    7. [CLOSE]をクリックし、右側のパネルを閉じます。

Snowflake

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の両方からアクセスできるよう、バケットの権限を変更する必要があります。

バケットの権限を変更する手順:

  1. AWSコンソールにログインします。
  2. S3サービスに移動します。
  3. Data Locker専用だったバケットを選択します。 
  4. [Permissions]タブに移動します。 
  5. [Bucket policy]セクションで[Edit]
    をクリックします。
    [Edit bucket policy]ウィンドウが開きます。
  6. ウィンドウの内容を以下のコードスニペットで置き換えます。
    {
      "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か所目の名前に続く/*を上書きしないよう注意してください。
  7. [Save changes]をクリックします。

GCS

入力用・出力用の新しいバケットの作成

入力用のGCSバケットの作成手順に従います。手順4を変更し、[New members]欄に以下の2つのアカウントを入力します。
appsflyer-dcr@dcr-report.iam.gserviceaccount.com
af-data-delivery@af-raw-data.iam.gserviceaccount.com

Data Locker専用だった既存バケットの変更

Data Locker専用だった既存バケットを変更するには、DCRとData Lockerの両方からアクセスできるよう、バケットの権限を変更する必要があります。

バケットの権限を変更する手順:

  1. GCSコンソールにログインします。
  2. Cloud Storage Browserのページに移動します。
  3. Data Locker専用だったバケットを選択します。 
  4. [Permissions]タブに移動します。
  5. [Permissions]セクションで、[+ Add]をクリックします。
    [Add members]ウィンドウが開きます。
  6. [New members]欄に、以下のアカウントを入力します。
    appsflyer-dcr@dcr-report.iam.gserviceaccount.com
  7. [Role]一覧から、[Cloud storage] > [Storage Admin]を選択します。

    dcr_gcs_permissions.png

  8. [Save]をクリックします。