> ## 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.

# Snowplow

> Kameleoon の実験エクスポージャーイベントを Snowplow の行動データプラットフォームに送信し、バリエーションレベルの実験データでデータパイプラインを強化します。

[Snowplow](https://snowplowanalytics.com/) は行動データプラットフォームです。Snowplow を使用すると、次のことが可能です。

* 高品質な行動データセットを生成します。
* ソリューションのあらゆる段階で構築されたガバナンスツールにより、データの品質とコンプライアンスを管理します。
* Snowplow BDP Console で安全に管理される、カスタマイズ可能なインクリメンタル Web およびモバイルモデルで行動データをモデリングし、価値創出までの時間を短縮します。

**主なメリット:**

* 個々の顧客やイベントにズームインできます。
* ズームアウトしてコホート間や時間を超えた行動を比較できます。
* 行動でオーディエンスをセグメント化できます。
* レコメンデーションやパーソナライゼーションのエンジンを開発できます。

当社の Snowplow 統合により、Kameleoon のキャンペーンイベントをあらゆる [Snowplow Collector](https://docs.snowplowanalytics.com/docs/getting-started-on-snowplow-open-source/setup-snowplow-on-aws/setup-the-snowplow-collector/) で利用できるようになります。

## Kameleoon で Snowplow を有効化する

最初のステップは、Snowplow を有効化することです。手順は以下の通りです。

1. Kameleoon アプリにログインします。
2. **Admin** > **Integrations** > **Install the tool** をクリックします。
3. Snowplow を設定したいプロジェクトを選択します。
4. **Validate** をクリックします。

ツールの行の右側に **ON** トグルが表示され、ツールが設定されているプロジェクトの数が表示されます。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-03-08-a-14.28.58.png)
</Frame>

データは [Snowplow の JavaScript Tracker](https://docs.snowplow.io/docs/collecting-data/collecting-from-own-applications/javascript-trackers/javascript-tracker/) を使用して、自動的に Snowplow に送信されます。

<Note>
  当社のネイティブブリッジの動作を変更する必要がある場合は、[カスタム analytics ブリッジを作成](../analytics/custom-analytics-integration)し、[当社の GitHub リポジトリ](https://github.com/Kameleoon/custom-analytics-integrations/tree/main/snowplow)の Snowplow サンプルコードを使用できます。
</Note>

### Kameleoon Snowplow イベントディスパッチャー

Kameleoon イベントが複数のソースから生成される場合、当社の Snowplow イベントディスパッチャー統合の方がこのようなユースケースに適しています。

この統合は、当社のイベントストリーミング層に直接プラグインされます。プロジェクト ID に関連するエクスポージャーイベントを抽出し、HTTP コールを介して Snowplow Stream Collector に送信します。

特定のプロジェクトに対してディスパッチャーをセットアップするには、以下の情報をテクニカルアカウントマネージャーに提供してください。

* Snowplow Stream Collector の URL
* Iglu スキーマレジストリのホストと Snowplow API キー

スキーマレジストリと API キーは、Kameleoon エクスポージャーイベントタイプのカスタムスキーマを Snowplow パイプラインに通知するために使用され、その後送信されるデータをシステムが正しく解釈できるようにします。そのため、API キーは 1 回のみ使用されます。

レジストリにプッシュされる Kameleoon エクスポージャーイベントのスキーマは以下の通りです。

```json theme={null}
    {
        "$schema": "http://iglucentral.com/schemas/com.snowplowanalytics.self-desc/schema/jsonschema/1-0-0#",
        "self": {
            "vendor": "kameleoon",
            "name": "kameleoon_experiment_exposure",
            "format": "jsonschema",
            "version": "1-0-0"
        },
        "type": "object",
        "properties": {
            "nonce": {
                "type": "number"
            },
            "visitor_code": {
                "type": "string"
            },
            "timestamp": {
                "type": "number"
            },
            "experiment_id": {
                "type": "number"
            },
            "variation_id": {
                "type": "number"
            }
        },
        "required": ["nonce","visitor_code","timestamp","experiment_id","variation_id"],
        "additionalProperties": false
    }
```

各フィールドの説明:

* `nonce` はイベント UUID に相当します
* `visitor_code` は一意のユーザー識別子で、Snowplow に送信される JSON イベントの `user_id` として使用されます
* `timestamp` はイベントのタイムスタンプです
* `experiment_id` はユーザーが接触した Kameleoon 実験の一意の ID です
* `variation_id` はその実験内でユーザーが接触したバリエーションの一意の ID です

Kameleoon エクスポージャーイベントは、カスタム自己記述 JSON として HTTP コール本文にバッチ化されます。この形式には、セットアップ時に Kameleoon が Snowplow Iglu スキーマレジストリにプッシュした、上記の記述スキーマへの参照が含まれています。

たとえば、標準の Snowplow イベントで使用しているビジター ID を Kameleoon のビジターセッションに紐付けるために、プロジェクトにマッピング識別子を設定している場合があります。その場合、このマッピング識別子は、Kameleoon のビジターコードの代わりに、Snowplow に送信される自己記述イベント JSON の `user_id` パラメータとして使用されます。

Snowplow にイベントを送信するための HTTP 形式の詳細については、[Snowplow Tracker Protocol 仕様](https://docs.snowplow.io/docs/collecting-data/collecting-from-own-applications/snowplow-tracker-protocol/)を参照してください。

## Snowplow を Kameleoon キャンペーンに関連付ける

### グラフィック/コードエディタで

1. 仕上げパネルで **Integrations** をクリックします。
2. **Snowplow** を選択します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-11-20-a-15.55.59.png)
</Frame>

公開前のサマリーポップインに Snowplow が表示されます。Kameleoon は自動的にデータを Snowplow に送信し、ツール上で直接結果を確認できます。

### パーソナライゼーション作成ページで

A/B テストと同じ方法で、パーソナライゼーションのレポートツールの中から Snowplow を選択できます。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-destination/cdp/snowplow/Capture-decran-2023-06-12-a-10.11.12.png)
</Frame>

### 結果ページで

Snowplow が実験のレポートツールとして設定されると、Kameleoon の結果ページから選択（または選択解除）できます。手順は以下の通りです。

1. **Reporting Tools** > **Edit** をクリックします。
2. Snowplow を選択または選択解除します。
3. **Validate** をクリックします。

### フィーチャーフラグで

[サードパーティ analytics 統合の管理方法を学ぶ](../../../experimentation/feature-experimentation/track-your-feature-experiments/managing-third-party-integrations)
