imagino

​

imaginoのワークフローでの位置づけ

• Kameleoonへのimaginoデータの送信：imaginoをKameleoonサイトに接続し、データ構造を定義して、属性をKameleoonにマッピングします。
• Kameleoonでのimaginoデータの取得：検索キーを選択し、imaginoが送信するデータを理解して、サイト上で各属性を読み取るカスタムデータを作成します。
• imaginoセグメントによる訪問者のターゲティング：カスタムデータからセグメントを作成し、実験で使用します。

​

始める前に

• Client ID
• Client-Secret
• Site code

​

imaginoデータをKameleoonに送信する

​

imaginoで接続を設定する

1. 顧客のKameleoonインスタンスとの接続を設定します。

2. データを受信するプロジェクトを選択します。

​

送信するデータ構造を定義する

​

imaginoのデータをKameleoonにマッピングする

1. Kameleoonにプッシュするimaginoオーディエンスデータを有効化します。

2. オーディエンスデータのマッピングを編集して、imaginoのフィールドと、Kameleoonが想定するフィールド（事前に構成した構造）を定義します。

​

Kameleoonがデータを受信していることを確認する

​

Kameleoonでimaginoデータを取得する

• imaginoが、既知の顧客ごとに属性とコホートを算出します。
• imaginoは、顧客識別子（検索キー）をインデックスとして、属性とコホートをKameleoonに送信します。
• サイト上では、Kameleoonが同じ識別子を読み取り、Data APIに問い合わせて属性を取得します。
• Kameleoonは属性をカスタムデータとして保存し、セグメントでターゲティングとレポーティングに使用します。

​

検索キーを選択する

• DataLayer：window.dataLayer[0].userId
• 既存のカスタムデータ：Kameleoon.API.Visitor.customData["Account ID"]
• ファーストパーティCookie：document.cookie から抽出した値

​

imaginoが送信するデータを理解する

{
  "USER_CAGNOTTE": 55,
  "SEGMENT_NAME": "Birthday",
  "USER_IS_PLUS_MEMBER": "TRUE",
  "USER_IS_PLUS_STATUS": "active"
}

• 送信前に、imagino側でデータを暗号化またはハッシュ化します。Kameleoonは暗号化された値のみを受信し、ターゲティングはその値に対して実行されます。
• カスタムデータで Use this data only locally for targeting purposes を有効にします。値は訪問者のデバイスに保存されたままとなり、Kameleoonのレポーティングサーバーに送信されることはありません。

​

カスタムデータを作成する

• 単一の属性
• 複数の属性

imagino属性が1つだけ必要な場合に使用します。すべてのロジックはカスタムデータ内に置かれるため、グローバルスクリプトを変更する必要はありません。次の設定でカスタムデータを作成します：

• Retrieval method: Custom JavaScript code
• Type and Format: 属性と同じもの（以下の例では Single / String）
• Scope: Page

// 1. Lookup key: the identifier imagino uses to send the data
var lookupKey = window.dataLayer && window.dataLayer[0] && window.dataLayer[0].userId;

// No identifier yet: return nothing, Kameleoon runs the code again
if (!lookupKey) return;

window.kImagino = window.kImagino || {};

// 2. Only one Data API call per page
if (!window.kImagino.requested) {
  window.kImagino.requested = true;
  Kameleoon.API.Data.retrieveDataFromRemoteSource(lookupKey, function (data) {
    window.kImagino.data = data || {};
  });
}

// 3. Response not received yet: return nothing, Kameleoon runs the code again
if (!window.kImagino.data) return;

// 4. Return the attribute you need
var value = window.kImagino.data["USER_HOTEL_SEGMENTATION_CLUSTER"];
return (value === undefined || value === null)
  ? { "value": null }
  : { "value": String(value), "overwrite": true };

imagino属性が複数必要な場合に使用します。Kameleoonは、ページごとにData APIを1回だけ呼び出し、その1つのレスポンスからすべてのカスタムデータに値を設定します。プロジェクトの Global custom script に次のブロックを追加し、MAPPING オブジェクトを属性に合わせて調整します：

(function () {
  // 1. Map each imagino attribute to the name of a Kameleoon custom data
  var MAPPING = {
    "USER_CAGNOTTE":       "Imagino cagnotte",
    "SEGMENT_NAME":        "Imagino segment",
    "USER_IS_PLUS_MEMBER": "Imagino PLUS MEMBER",
    "USER_IS_PLUS_STATUS": "Imagino PLUS STATUS"
  };

  window.kImagino = { loaded: false, data: {} };

  // 2. Wait until the lookup key is available on the page
  Kameleoon.API.Core.runWhenConditionTrue(function () {
    return !!(window.dataLayer && window.dataLayer[0] && window.dataLayer[0].userId);
  }, function () {
    // 3. A single Data API call for the whole page
    Kameleoon.API.Data.retrieveDataFromRemoteSource(window.dataLayer[0].userId, function (data) {
      window.kImagino.data = data || {};
      window.kImagino.loaded = true;

      // 4. Fill all the mapped custom data in a single pass
      Object.keys(MAPPING).forEach(function (attribute) {
        var value = window.kImagino.data[attribute];
        if (value === undefined || value === null) return;
        Kameleoon.API.Data.setCustomData(MAPPING[attribute], String(value));
      });
    });
  }, 200);
})();

次に、MAPPING のエントリごとにカスタムデータを1つ作成します。それぞれ次の設定にします：

• Retrieval method: Kameleoon Activation API
• Type and Format: 属性と同じもの
• Scope: Page

その後、Custom data の一覧に、マッピングした属性ごとに1つのエントリが値とともに表示されます。

カスタムデータの一覧に値ではなく属性名が含まれている場合は、コードが data[attribute] を読み取る代わりに Object.keys(data) を保存しています。

​

imaginoセグメントで訪問者をターゲティングする

​

imaginoのカスタムデータからセグメントを作成する

1. Settings > Segments > New segment をクリックします。
2. 必要な情報を入力し、Continue をクリックします。
3. Custom data ドロップダウンでカスタムデータを選択します。
4. Create をクリックします。