Skip to main content
CRMやカスタマーデータプラットフォームには、セグメントや商品への関心など、Kameleoonだけでは読み取れないビジターの詳細情報が保存されていることがよくあります。Data APIのMap エンドポイントは、キー(通常はビジターコードまたは社内のユーザー ID)ごとにそのデータを保存します。カスタムデータポイントは、ウェブサイト上で保存された各値を受け取ります。その結果、セグメントには特定の値を持つビジターだけを含めることができます。

ユーザーデータをKameleoonに送信する

1 つ以上のキーのデータを保存するには、キーごとに 1 つのエントリを含む JSON オブジェクトを POST /map/maps エンドポイントに送信します。各エントリには、userSegment や categoryAffinities など、複数のフィールドを含めることができます。Map エンドポイントを使って、キーに保存されたデータを取得することもできます。
サードパーティ製ツールからKameleoonに送信されたユーザーデータと、そのユーザーデータを利用できるウェブ実験、ウェブパーソナライゼーション、フィーチャー実験を示す表。
Example of payload:
Example of request:

Kameleoonでユーザーデータを取得する

保存されたデータをキャンペーンで使用するには、カスタムデータポイントを作成したうえで、ウェブサイトのグローバルスクリプトから、KameleoonのActivation APIが提供するretrieveDataFromRemoteSourceメソッドを使って値を設定します。KameleoonのすべてのSDKは、同じメソッドを使用します。

カスタムデータポイントを作成する

ユーザーデータを受け取るには、Kameleoon Activation APIの取得方法を使ってカスタムデータポイントを作成します。
  1. Settings > Custom Data をクリックし、次に New custom data をクリックします。
  2. カスタムデータに名前を付けます。
  3. プロジェクトを選択します。
  4. 取得方法として Kameleoon Activation API を選択します。
  5. 型として List を、形式として String を選択します。
  6. スコープとして Page を選択します。
  7. Next をクリックします。
Kameleoon Activation APIの取得方法、List型、String形式、Pageスコープを選択したNew custom dataのポップイン。
このデータには、Custom JavaScript codeの取得方法を使用しないでください。Custom JavaScript codeの取得方法では、値を同期的に返す必要があるため、非同期のretrieveDataFromRemoteSourceメソッドを呼び出せません。

グローバルスクリプトからカスタムデータを設定する

このコードを、すべてのページで読み込まれるウェブサイトのグローバルスクリプトに追加します。NAME_OF_YOUR_CUSTOMDATAをカスタムデータの名前に、NAME_OF_YOUR_USER_IDをMap エンドポイントで保存したキーに置き換えます。
この例では、保存されたデータのuserSegmentフィールドを設定しています。ターゲティングする各フィールドについて、個別のカスタムデータポイントを作成します。

Save the values for the targeting condition associated with the custom data point

segment builderで値を選択するには、Options ステップで Save the values for the targeting condition associated with the custom data point をオンにします。コードフィールドで、オブジェクトの配列を返します。各オブジェクトには、カスタムデータの型に一致する必要があるvalueと、segment builderに表示されるlabelがあります。segment builderに表示させたい値ごとに、1 つのオブジェクトを追加します。
Save the values for the targeting condition associated with the custom data pointのトグルがオンになっており、値を並べたコードフィールドがあるOptionsステップ。
Next > Create をクリックします。詳細は、カスタムデータの作成を参照してください。

セグメントを作成する

プロジェクトの新しいセグメントを作成する

カスタムデータを使用するセグメントを作成するには、まずセグメントを作成してから、カスタムデータを条件として追加します。
  1. Settings > Segments をクリックし、次に New segment をクリックします。
  2. セグメントに名前を付けます。
  3. プロジェクトを選択します。
  4. Campaign type を選択し、次に All types を選択します。
  5. Next をクリックします。
セグメント名、プロジェクト、Campaign type、説明のフィールドがあるNew segmentのポップイン。

セグメントにカスタムデータの条件を追加する

カスタムデータでビジターをターゲティングするには、セグメントの条件としてカスタムデータを使用します。segment builderで、Conditions 列の Technical を展開してから、カスタムデータの条件をダブルクリックして追加します。Include visitors with フィールドで、カスタムデータポイントを選択し、is among the values を選択します。セグメントに含める値ごとにチェックを入れます。一覧には、カスタムデータの作成時に保存した値が表示されます。
カスタムデータの条件(is among the valuesに設定)と保存された値の一覧を表示するsegment builder。

キャンペーンでセグメントを使用する

セグメントは、キャンペーンに含めるビジターを制御します。実験の場合は、finalization panelの Targeting ステップで Target a segment を選択します。パーソナライゼーションの場合は、Targeting ステップの Segments パネルで Target a segment をクリックします。詳細な手順は、キャンペーンでセグメントを設定するを参照してください。