Skip to main content
カスタムデータを作成すると、ユーザーアカウント情報など、すでに利用可能なデータに従って訪問者をターゲットにできます。 すべてのカスタムデータは Settings > Custom data で利用可能で、カスタムデータの作成とカスタムデータの管理ができます。

​
新しいカスタムデータの作成

新しいカスタムデータを作成するには:
  1. Settings > Custom data をクリックします。
  2. ページの右上にある New custom data をクリックします。
カスタムデータを設定するには、いくつかのフィールドに入力する必要があります。

​
作成ポップインの構造

  1. 新しいカスタムデータに名前を付けます。
  2. プロジェクトを選択します。
  3. Kameleoon にカスタムデータを取得する方法を指示します。

​
カスタムデータ名

カスタムデータに簡単に識別できる名前を付けます。 複数の Web サイトを選択する場合は、すべてのサイトからカスタムデータを取得するようにしてください。 最大 255 個のアクティブなカスタムデータポイントを持つことができます。

​
値の取得

​
Retrieval method

ドロップダウンメニューからカスタムデータの値の取得方法を選択します。 主なタグ管理ツールは以下のとおりです:
  • GTM データレイヤー (dataLayer)
  • Commanders Act データレイヤー (tc_vars)
  • Tealium (utag.data & utag_data)
  • Adobe Tags (データ要素)
これらのタグマネージャーでは、取得したい変数名を指定する必要があります。 GTM dataLayer を使用する場合、値を取得するには以下のように進めます:
  • キーが dataLayer のレベル 1 にある場合、Variable Name フィールドに name を入力します。
  • キーが dataLayer のレベル 2 にある場合、Variable Name フィールドに properties.countryCode を入力します。
Adobe Tags を選択した場合、Kameleoon は訪問者のブラウザから Adobe Tags のデータ要素の値を読み取ります。値を取得するためにカスタム JavaScript を書く必要はありません。 Adobe Tags からの値の取得を設定するには、次の手順に従います:
  1. データ要素がページ上で値を返すことを確認します。ブラウザのコンソールを開き、_satellite.getVar("dataElementName") を実行します。dataElementName は、データ要素の名前に置き換えてください。
  2. Retrieval method ドロップダウンメニューで Adobe Tags を選択します。同じデータ要素の名前を Variable Name フィールドに入力します。
  3. ブラウザのコンソールで値を確認します。Page および Visit スコープでは Kameleoon.API.CurrentVisit.customData、Visitor スコープでは Kameleoon.API.Visitor.customData を使用します。Kameleoon Debug Assistant Chrome 拡張機能 を使って値を確認することもできます。
たとえば、Adobe Tags のデータ要素の名前が General - Marketing Event - ID の場合、Variable Name フィールドに General - Marketing Event - ID を入力します。Kameleoon は _satellite.getVar("General - Marketing Event - ID") を呼び出して値を読み取ります。値は 154862 のようになることがあります。 Kameleoon Activation API を選択した場合、Web サイトの JavaScript(通常はグローバルスクリプト)から、Activation API の setCustomData() メソッドを使用して値を設定します。 Kameleoon SDK method を選択した場合、Kameleoon SDK の addData() メソッドを使用して値を設定します。Kameleoon Feature Experimentation で訪問者をターゲットにする場合、この取得方法を使用します。 Custom JavaScript code を選択した場合、コードをこのフィールドに直接入力します。コードは 2 つのキーを持つオブジェクトを返す必要があります: このカスタムデータに提供したい値を持つ value、および(オプションで)ブール値を持つ override(デフォルトは false)。Kameleoon はコードを最初の呼び出し後 3 秒間は 100 ミリ秒ごと、その後は 3 秒ごとに再実行します。 例:
この取得方法はできるだけ避けてください。このフィールドのコードは同期的に実行され、すぐに値を返す必要があるため、retrieveDataFromRemoteSource() などの非同期メソッドを呼び出すことはできません。代わりに、タグマネージャー、外部スクリプトファイル、HTML インラインスクリプトコードなど、別の場所に JavaScript を記述し、Kameleoon Activation API の取得方法を使用してカスタムデータを設定します。

​
Type

ドロップダウンメニューから取得するデータの構造を選択します。 データタイプは以下のいずれかです:
  • single (例: 127)
  • list (例: 126, 127, 128; shoes, dress, coat)
  • count list of (例: shoes: 3, dress: 1, coat: 1)

​
Format

ドロップダウンメニューから取得するデータのフォーマットを選択します。 データフォーマットは以下のいずれかです:
  • string (例: woman dress)
  • boolean (例: female = "true/false")
  • number (例: cart amount = "127")

​
Scope

ドロップダウンメニューからカスタムデータのスコープを選択します:
  • Page: 新しいページごとに、Kameleoon はデータ値をリセットします。たとえば、カート金額。
  • Visit: Kameleoon は新しい訪問ごとにデータ値をリセットします。たとえば、地理位置情報。
  • Visitor: データの単位は訪問ではなく訪問者に関連します。たとえば、female = true。

​
オプション

Next をクリックして、カスタムデータで利用可能なオプションにアクセスします。

​
Use this data only locally for targeting purposes

カスタムデータをターゲティング専用に使用する場合、サーバーに保存する必要はありません。このシナリオでは、LocalData API を使用します。LocalData API は 255 個のアクティブなカスタムデータポイント制限にカウントされないため、サーバー領域の節約になります。ただし、LocalData API 経由で管理されるカスタムデータは、Results ページのレポートに使用できません。 カスタムデータをサーバーに保存することを選択した場合、機密情報を保存しないように注意してください。また、サーバーに送信するカスタムデータの値は、1,000 文字を超えることはできません。

​
Use this custom data as input for AI Targeting

プロジェクトで AI Targeting が有効になっている場合、このカスタムデータを予測モデルの入力として含めるかどうかを選択できます。Kameleoon はローカルデータをサーバーに送信しないため、Use this data only locally for targeting purposesオプションが有効になっているカスタムデータをモデルの入力として使用することはできません。カスタムデータが高度にターゲットされている場合(たとえば、個々の訪問者または非常に小さなセグメントに固有)、このオプションを有効にしないでください。 モデルが受け入れるのは Number および Boolean タイプのカスタムデータのみです。日付、タイムスタンプ、ユニーク訪問者識別子(メールアドレスや顧客アカウント番号など)などの機密データを追加しないでください。これらの要素は予測モデルには適していません。 デバイスタイプなどのカテゴリを使用するには、値ごとに Boolean カスタムデータを作成し(たとえば is_mobile、is_tablet、is_desktop)、訪問者ごとにそのうちの 1 つだけを 1(true)、残りを 0(false)に設定します。テキスト値を数値に割り当てると、値の間に存在しない順序が生まれます。根拠と具体例については、テキスト値をBooleanカスタムデータとしてエンコードするを参照してください。

​
Use this custom data as a unique identifier for cross-device history reconciliation

このオプションを有効にすると、Kameleoon はこのカスタムデータを訪問者のユニーク識別子として扱い、複数の Kameleoon の訪問をユニークユーザーにマッピングするために使用します。詳細については、クロスデバイスエクスペリメンテーションを参照してください。 タイプがsingleで、フォーマットがstringまたはnumberのカスタムデータのみ、ユニーク識別子にできます。このオプションでは、Kameleoonはlist、count list、booleanのカスタムデータを受け付けません。 一意の識別子には、スコープがVisitorである必要があります。スコープがPageまたはVisitのカスタムデータでは、Kameleoonはこのオプションを受け付けません。

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

このオプションを使用すると、セグメントビルダーでこのカスタムデータに利用できる特定の値リストを定義できます。 New custom data ポップイン(作成フローの最初のページ)で、Paste a sample code をクリックするとコード例が取得できます。 コードは同期的に JavaScript オブジェクトの配列を返す必要があります。この配列の各オブジェクトはカスタムデータの可能な値を表す必要があり、以下を含む必要があります:
  • 実際のデータを含む value キー(タイプはカスタムデータの定義されたタイプと一致する必要があります)。
  • その値の文字列説明を提供する label キー。
例:
フォーマットが正しくない場合、Next をクリックするとエラーメッセージが表示されます。 JavaScript を入力したら、Next > Create をクリックします。 セグメントビルダーでカスタムデータ値を使用する方法については、セグメントを作成する記事を参照してください。

​
ターゲティング条件としてカスタムデータを定義する

新しいセグメントにカスタムデータを追加するには:
  1. Conditions 列の Custom data タブで目的のデータを選択します。
  2. ドロップダウンメニューで、ユーザーをターゲットにするために必要なカスタムデータの値を設定します。
  3. カスタムデータ条件を満たす訪問者を含める、または除外します。
カスタムデータのタイプによって、ターゲティング条件の設定が変わります(“is true/is false”、“contains”、“is equal to”)。 セグメントを作成せずに、パーソナライゼーションの Specific visitors ターゲティングルールで、カスタムデータをターゲティング条件として直接選択することもできます。詳細については、パーソナライゼーションを設定して起動する を参照してください。

​
Results ページでカスタムデータでフィルターまたはブレイクダウン

エクスペリメントのResults ページで、エクスペリメントに関連付けられたカスタムデータに従って結果をフィルターまたはブレイクダウンできます。 開発者ドキュメントのカスタムデータについて

​
FAQ

  1. Settings > Custom data > New custom data をクリックします。
  2. セットアップ手順に従い、Next をクリックします。
  3. Use this custom data as a unique identifier for cross-device history reconciliation を ON に切り替えます。
  4. Create をクリックします。