Snowflakeをデスティネーションとして使用する

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

Kameleoonは、お客様が所有する Snowflake データベースにキャンペーンイベントを書き込めます。書き込まれたイベントは SQLでクエリできます。連携では、デフォルトで実験の露出イベントを書き込みます。また、コンバージョンとカスタムデータのイベントも書き込むことができます。それぞれのイベントは、Snowflakeのセットアップで作成した KAMELEOON_EVENTS スキーマ内の専用テーブルに保存されます。この方向では、デスティネーションがパスワード認証をサポートしていないため、キーペア認証を使用してください。

Snowflakeをデスティネーションとして有効化する

プロジェクトで Snowflake 連携を有効化したら、Use Snowflake as a destination を有効にして、Kameleoonのイベントを Snowflakeへの書き込みを開始できます。

手順は次のとおりです：

選択したプロジェクトの設定で、Use Snowflake as a destination をクリックして展開します。

Use Snowflake as a destination セクションが展開され、Warehouse フィールドと Confirm ボタンが表示されている。

Snowflakeのセットアップで Kameleoon ロールに付与したウェアハウスの名前を Warehouse フィールドに入力し、Confirm をクリックします。
Validate をクリックして、設定を保存し、適用します。

「Use Snowflake as a destination」が行うこと

Use Snowflake as a destination を有効にすると、Kameleoonのイベントを Snowflakeへの書き込みが開始されます。 Kameleoonは、作成した KAMELEOON データベースの KAMELEOON_EVENTS スキーマにイベントを保存します。セットアップ中に Kameleoon ロールに付与したテーブル作成権限により、この保存が可能になります。3 種類のイベントタイプには、それぞれ専用のテーブルがあります。

Kameleoonは、実験の露出イベントを kameleoon_experiment_eventに保存します：

CREATE TABLE kameleoon_experiment_event (
    nonce               BIGINT PRIMARY KEY,  -- unique identifier of the event
    timestamp           BIGINT,              -- timestamp in millis of the event
    visitor_code        VARCHAR(255),        -- Kameleoon visitor identifier
    custom_visitor_id   VARCHAR(255),        -- visitor identifier used by your company
    experiment_id       BIGINT,              -- Kameleoon id of the experiment
    variation_id        BIGINT               -- Kameleoon id of the variation
);

Kameleoonは、コンバージョンイベントを kameleoon_conversion_eventに保存します：

CREATE TABLE kameleoon_conversion_event (
    nonce                   BIGINT PRIMARY KEY,  -- unique identifier of the event
    timestamp               BIGINT,              -- timestamp in millis of the event
    visitor_code            VARCHAR,             -- Kameleoon visitor identifier
    custom_visitor_id       VARCHAR,             -- visitor identifier used by your company
    goal_id                 BIGINT,              -- Kameleoon id of the goal
    revenue                 FLOAT,               -- revenue associated with the conversion
    negative                BOOLEAN,             -- negative set to true means that this event cancels a previous conversion
    metadata_id_to_values   OBJECT               -- map of goal metadata IDs to the set of values taken by that metadata
);

Kameleoonは、カスタムデータイベントを kameleoon_custom_data_eventに保存します：

CREATE TABLE kameleoon_custom_data_event (
    nonce                   BIGINT PRIMARY KEY,  -- unique identifier of the event
    timestamp               BIGINT,             -- timestamp in millis of the event
    visitor_code            VARCHAR(255),        -- Kameleoon visitor identifier
    custom_visitor_id       VARCHAR(255),        -- visitor identifier used by your company
    index                   BIGINT,              -- index of the custom data
    count_by_value          OBJECT,              -- map of values taken by this custom data to their occurrence counts
    overwrite               BOOLEAN,             -- whether the value overwrites previous data within the session
    mapping_identifier      BOOLEAN              -- whether the index uses a mapping identifier
);

Cross Device Reconciliationのカスタムデータを設定している場合、Kameleoonはそのデータから custom_visitor_id フィールドを設定します。 Kameleoonは、実験の露出イベントをデフォルトで有効にしています。コンバージョンとカスタムデータのイベントの収集は新しい機能で、変更される可能性があります。これらは UIから有効にすることはできません。有効にするには、Kameleoon サポートチームにお問い合わせください。

デスティネーションの制限事項

Kameleoonはこれらのテーブルに行を挿入するだけです。Snowflakeから変更を読み戻すことはありません。そのため、テーブル内の修正や削除は、Kameleoonがすでに書き込んだイベントを変更しません。 Kameleoonはこれらのテーブルのスキーマを監視しません。列を変更しても、Kameleoonはその変更を検出しません。

連携

​Snowflakeをデスティネーションとして有効化する

​「Use Snowflake as a destination」が行うこと

​デスティネーションの制限事項

Snowflakeをデスティネーションとして有効化する

「Use Snowflake as a destination」が行うこと

デスティネーションの制限事項