BigQuery をセットアップする

BigQuery 統合を使用すると、Kameleoonは、オーディエンスターゲティングとレポートのためにBigQuery プロジェクトからデータを読み取り、実験の露出イベントをBigQueryに送り返せます。 Kameleoonは、次のプロバイダーからのデータウェアハウス統合をサポートしています:

• BigQuery
• Snowflake
• Redshift
• Databricks

​

BigQuery プロジェクトをKameleoonに接続する

​

前提条件

この統合を設定するには、次のものが必要です:

• Google Cloud アカウント: Google BigQueryにアクセスし、必要な認証情報を生成するために、有効な Google Cloud アカウントが必要です。
• Google サービスアカウント: BigQueryにアクセスし、認証情報を作成するための適切な権限を持つ Google サービスアカウントが必要です。
• BigQuery プロジェクト: データを保存およびクエリするためのGoogle BigQuery プロジェクトを設定しておく必要があります。
• 認証情報ファイル: BigQueryへの安全なアクセスに使用される認証情報ファイルを、Google サービスアカウントから生成します。

​

サービスアカウントを作成する

Kameleoon 用のサービスアカウントをプロジェクトに作成し、BigQuery Data Viewer ロールを付与します。

1. グローバル検索バーにservice accountsと入力し、候補として表示された結果をクリックします。

2. Create service accountをクリックします。
3. 必須フィールドに入力し、Create and continueをクリックします。
4. Select a role フィールドに「BigQuery data viewer」と入力し、ドロップダウン検索にBigQuery Data Viewerが表示されたらクリックします。

5. Continueをクリックしてから、Doneをクリックします。

​

新しいデータセットを作成する

プロジェクトに「kameleoon」という名前の新しいデータセットを作成します。 用途に合ったリージョンまたはマルチリージョンを選択します。

​

サービスアカウントに権限を付与する

​

「kameleoon」データセットで、サービスアカウントにBigQuery Data Owner ロールを付与する

「kameleoon」データセットのBigQuery Data Owner ロールを、Kameleoon サービスアカウントに付与します。

1. BigQuery ダッシュボードで、左側のExplorer バーにある kameleoon データセットをクリックします。
2. Sharing > Permissionsをクリックします。

3. Add principalをクリックします。
4. New principals フィールドに、Kameleoon サービスアカウント名を入力します。

5. Assign roles フィールドに「BigQuery Data Owner」と入力します。
6. Saveをクリックして完了します。

​

カスタムロールを作成する

​

bigquery.jobs.create 権限を持つカスタムロールを作成する

bigquery.jobs.create 権限を付与するカスタムロールを作成すると、サービスアカウントはBigQueryジョブを作成できるようになります。

1. Rolesに移動します。
   • コンソールのグローバル検索フィールドに「Roles」と入力すると、Rolesを見つけられます。

2. Create roleをクリックします。
3. ロールのタイトルと ID を入力します。例：Job Creator Role、CustomRole。

4. Add permissionsをクリックし、ポップインウィンドウに表示されるドロップダウンリストから bigquery.jobs.createを追加します。
5. Addをクリックします。

6. Createをクリックして、カスタムロールを確定します。

​

作成したサービスアカウントにカスタムロールを追加する

カスタムロールをKameleoon サービスアカウントに割り当てます。

1. Google Cloud コンソールのサイドバーでIAMに移動します。
2. Principalsの一覧が表示されます。サービスアカウントはPrincipalです。一覧でKameleoon サービスアカウントを見つけ、ペンアイコンをクリックしてプリンシパルを編集します。

3. 右側に設定サイドバーが表示されます。Add another roleをクリックし、ドロップダウンメニューで、bigquery.jobs.create 権限用に作成したカスタムロール（この例ではJob Creator Role）を探します。

4. Saveをクリックします。

​

サービスアカウントのJSON キーを作成する

Kameleoon サービスアカウントのJSON キーを作成します。Kameleoonは、作成したキーファイルを使用して BigQueryに接続します。

1. Google Cloud コンソールでService accounts ページを開きます。
2. プロジェクトを選択します。
3. Kameleoon サービスアカウントのメールアドレスをクリックします。
4. Keys タブを開きます。
5. Add key ドロップダウンメニューを開き、Create new keyを選択します。
6. Key typeをJSONに設定し、Createをクリックします。

Createをクリックすると、Google Cloudがキーファイルをコンピューターに保存します。キーは再度ダウンロードできないため、ファイルは安全な場所に保管してください。

​

プロジェクトの統合を有効化する

Kameleoonの統合設定で、サービスアカウントの認証情報ファイルを使用して BigQuery 統合を有効化します。

1. Kameleoon アカウントにログインし、Admin > Integrationsをクリックします。

2. BigQueryを選択します。
3. BigQueryを有効化したいプロジェクトを選択します。
4. Upload fileをクリックし、JSON ファイルを選択します。
5. Validateをクリックして変更を保存します。

​

複数プロジェクトを管理する

複数のプロジェクトがあり、それぞれにBigQuery 統合を構成する場合は、同じ Kameleoon アカウントから行えます。プロジェクトの構成を切り替えるには、統合設定内のプロジェクトのドロップダウンメニューを使用します。ドロップダウンメニューでは、各プロジェクトの統合設定を選択して管理できます。 プロジェクトごとに構成設定が異なる点に注意してください。各プロジェクトには固有のJSON 認証情報ファイルをアップロードする必要があります。ただし、1つの認証情報ファイルで付与された権限が複数のプロジェクトに適用される場合は、同じ認証情報ファイルを再利用できます。 次のいずれかの方法で、有効化した統合を使用できます:

• BigQuery をソースとして使用する — オーディエンスターゲティングを使用すると、キャンペーンのターゲティング条件として BigQueryのデータを使用できます。
• BigQuery をソースとして使用する — レポート用のイベント取得を使用すると、BigQueryのイベントをKameleoonのレポートに取り込めます。
• BigQuery をデスティネーションとして使用するを使用すると、実験の露出イベントをGoogle BigQueryに送信できます。

​

データリージョン

Kameleoonは、BigQuery 統合のデータを、お客様のアカウントのKameleoonデータリージョン（米国またはEU）に保存します。