> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snowflake をソースとして使用する — オーディエンスターゲティング

> データインジェスチョンタスクを設定して、Snowflake から Kameleoon にオーディエンスデータを取り込み、キャンペーンのターゲティング条件として使用します。

Snowflake 連携により、ターゲットキャンペーンやパーソナライズされたユーザー体験のためのデータ取得を効率化できます。

**主なメリット：**

* 正確なデータ収集が可能になり、特定のオーディエンスのニーズや嗜好に合わせてカスタマイズされたキャンペーンのオーディエンスターゲティングを改善します。
* データインジェスチョンタスクを設定し、Snowflake からデータを効率的に抽出します。

<Note>
  データウェアハウス連携は、当社の Web Experimentation および Feature Experimentation モジュールのプレミアムアドオンとしてご利用いただけます。詳細については、カスタマーサクセスマネージャーまでお問い合わせください。
</Note>

[プロジェクトで Snowflake 連携を有効化](./setting-up-snowflake)した後、**Snowflake をソースとして使用** を有効にすると、Snowflake に保存されたデータに Kameleoon キャンペーン内でアクセスして利用できます。

**Use Snowflake as a source** を有効にすると、データインジェスチョンタスクを設定することで Snowflake のデータを活用できます。これらのタスクは、定義した SQL クエリと頻度に基づいて、Snowflake から特定のデータを定期的に取得します。これらのタスクで収集したデータは、Kameleoon キャンペーンのターゲティング条件として使用できます。

1. **機能を有効化する：** 選択したプロジェクトの設定で、**Use Snowflake as a source** とラベル付けされたチェックボックスをオンにします。
2. **[データインジェスチョンタスクを作成する](#データインジェスチョンタスク)：** 機能を有効化したら、データインジェスチョンタスクを作成できます。これらのタスクは、定義した SQL クエリと頻度に基づいて、Snowflake から特定のデータを定期的に取得します。新しいデータインジェスチョンタスクを作成するには、**Add new task** をクリックします。
3. **検証する：** データインジェスチョンタスクに必要な情報を入力したら、**Confirm** をクリックしてタスクを作成します。タスクの命名、SQL クエリの定義、頻度の設定を繰り返すことで、追加のタスクを作成できます。タスクを設定したら、**Validate** をクリックして設定を保存・適用します。
4. **[カスタムデータを作成する](#インポートしたオーディエンスをターゲティングする)：** データインジェスチョンタスクを作成すると、当社のサーバーは設定された頻度に基づいて Snowflake インスタンスでクエリを実行し、データの収集を開始します。収集したデータを利用するには、カスタムデータを作成する必要があります。
5. **セグメントを作成する：** 収集したデータに基づいてユーザーをターゲティングするための最後のステップは、カスタムデータに基づいてセグメントを作成することです。

## データインジェスチョンタスク

データインジェスチョンタスクは、Kameleoon 内の Snowflake 連携の重要なコンポーネントです。データインジェスチョンタスクで収集したデータは、Kameleoon キャンペーンのターゲティング条件として使用できます。

### データインジェスチョンタスクを作成する

データインジェスチョンタスクを作成するには：

1. **Add new task** をクリックします。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/data-warehouses/snowflake/use-snowflake-as-a-source-audience-targeting/snwoflake-integration-2-768x386.png)
</Frame>

2. フォームに入力します：
   * **Name（必須）：** 目的が識別できるよう、タスクに一意でわかりやすい名前を付けます。
   * **Warehouse（必須）：** データウェアハウスの名前を指定します。
   * **Database（必須）：** インジェスト対象のデータを含む Snowflake データベースの名前です。
   * **Frequency（必須）：** BigQuery からデータを取得するためにタスクを実行する頻度を指定します（例：1 日 1 回）。
   * **Query（必須）：** Snowflake データベースからオーディエンスを取得する SQL クエリを入力します。クエリは次の特定の形式に従う必要があります：`SELECT visitor_id, attribute_1, .. attribute_N FROM your_events_table`。
   * **`attribute_` フィールド：** これらは任意で、高度なターゲティングシナリオに使用できます。これらの高度なユースケースについては、[こちら](../target-your-imported-audiences)をご覧ください。
   * **`visitor_id`：** この列は訪問者の一意の識別子を表します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/data-warehouses/snowflake/use-snowflake-as-a-source-audience-targeting/Capture-decran-2024-01-17-a-15.54.27-2.png)
</Frame>

<Note>
  列名には英字、数字、アンダースコア（`_`）のみを含めることができます。数字で始めることは**できません**。

  連携が正しく機能するためには、列は指定された正確な順序（`visitor_id`、その後に任意の属性）で並んでいる必要があります。
</Note>

3. 情報を入力したら、**Confirm** をクリックしてデータインジェスチョンタスクを作成します。

### インジェスチョン前にクエリを実行する

インジェスチョンタスクを保存する前に、Kameleoon で直接クエリをテストできます。テストにより以下が可能になります：

* リアルタイムで接続を確認する。
* 認証情報とアクセス権が正しいことを確認し、最初のデータインポートを待たずに問題を即座に検出できるようにする。
* データの構造とアクセス可能性を検証する。

シンプルなクエリを実行して、Kameleoon が適切なデータベースとテーブルにアクセスできることを確認できます。また、データセットの小さなサンプルをダウンロードして、スキーマ、権限、内容が期待どおりであることを確認することもできます。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/data-warehouses/query-testing/query-testing-2.png)
</Frame>

### インジェスチョン時間枠

Kameleoon は、イベント発生時刻のタイムスタンプに基づいてメトリクスをポーリングします。デフォルトでは、Kameleoon はイベントが発生してからデータウェアハウスで利用可能になるまで最大 1 時間を許容します。この遅延がユースケースに不十分な場合は、カスタマーサクセスマネージャーに連絡してカスタマイズしてください。

### データインジェスチョンタスクを更新する

データインジェスチョンタスクを更新するには：

1. **タスクを選択する：** ドロップダウンメニューからデータインジェスチョンタスクを選択します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/data-warehouses/snowflake/use-snowflake-as-a-source-audience-targeting/snowflake-data-warehouse-2.png)
</Frame>

2. **タスクの詳細を編集する：** タスクの名前、頻度、Snowflake プロジェクト ID、リージョン、クエリなど、更新したいフィールドを変更します。
3. **変更を確定する：** **Confirm** をクリックしてデータインジェスチョンタスクへの変更を保存します。

### データインジェスチョンタスクを削除する

データインジェスチョンタスクを削除するには：

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/data-warehouses/snowflake/use-snowflake-as-a-source-audience-targeting/snowflake-data-warehouse-2-1-768x405.png)
</Frame>

1. **タスクを選択する：** ドロップダウンメニューからデータインジェスチョンタスクを選択します。
2. **削除を開始する：** **Delete ingestion task** をクリックします。
3. **削除を確定する：** **Confirm** をクリックして選択したデータインジェスチョンタスクを削除します。

データインジェスチョンタスクを作成すると、Kameleoon プラットフォームはウェアハウスのポーリングを開始し、データはすぐに Kameleoon キャンペーンでユーザーをターゲティングするために利用可能になります。Web 実験では[アクティベーション API](../../../../developer-docs/apis/activation-api-js/api-reference/api-reference) を、フィーチャー実験では[当社の SDK](../../../../developer-docs/feature-experimentation/get-started/overview) を使用して、ポーリングされたデータを活用できます。

## インポートしたオーディエンスをターゲティングする

[ウェアハウスオーディエンスのターゲティング方法を学ぶ](../target-your-imported-audiences)
