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

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

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

作成ポップインの構造

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

カスタムデータ名

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

値の取得

取得方法

ドロップダウンメニューからカスタムデータの値の取得方法を選択します。 主なタグ管理ツールは以下のとおりです:
  • GTM データレイヤー (dataLayer)
  • Commanders Act データレイヤー (tc_vars)
  • Tealium (utag.data & utag_data)
これらのタグマネージャーでは、取得したい変数名を指定する必要があります。 GTM dataLayer を使用する場合、値を取得するには以下のように進めます:
  • キーが dataLayer のレベル 1 にある場合、Variable Name フィールドに name を入力します。
  • キーが dataLayer のレベル 2 にある場合、Variable Name フィールドに properties.countryCode を入力します。
Kameleoon Activation API を選択した場合、Web サイトの JavaScript(通常はグローバルスクリプト)から、Activation API の setCustomData() メソッドを使用して値を設定します。 Kameleoon SDK メソッドを選択した場合Kameleoon SDKaddData() メソッドを使用して値を設定します。Kameleoon Feature Experimentation で訪問者をターゲットにする場合、この取得方法を使用します。 カスタム JavaScript コードを選択した場合、コードをこのフィールドに直接入力します。コードは 2 つのキーを持つオブジェクトを返す必要があります: このカスタムデータに提供したい値を持つ value、および(オプションで)ブール値を持つ override(デフォルトは false)。Kameleoon はコードを最初の呼び出し後 3 秒間は 100 ミリ秒ごと、その後は 3 秒ごとに再実行します。 例:
この取得方法はできるだけ避けてください。このフィールドのコードは同期的に実行され、すぐに値を返す必要があるため、retrieveDataFromRemoteSource() などの非同期メソッドを呼び出すことはできません。代わりに、タグマネージャー、外部スクリプトファイル、HTML インラインスクリプトコードなど、別の場所に JavaScript を記述し、Kameleoon Activation API の取得方法を使用してカスタムデータを設定します。

タイプ

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

フォーマット

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

スコープ

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

オプション

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

このデータをターゲティング目的のためにローカルでのみ使用する

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

このカスタムデータを AI Predictive Targeting への入力として使用する

プロジェクトで AI Predictive Targeting が有効になっている場合、このカスタムデータを予測モデルの入力として含めるかどうかを選択できます。Kameleoon はローカルデータをサーバーに送信しないため、このデータをターゲティング目的でローカルのみで使用オプションが有効になっているカスタムデータをモデルの入力として使用することはできません。カスタムデータが高度にターゲットされている場合(たとえば、個々の訪問者または非常に小さなセグメントに固有)、このオプションを有効にしないでください。 モデルが受け入れるのは Number および Boolean タイプのカスタムデータのみです。日付、タイムスタンプ、ユニーク訪問者識別子(メールアドレスや顧客アカウント番号など)などの機密データを追加しないでください。これらの要素は予測モデルには適していません。

このカスタムデータをクロスデバイス履歴の調整のためのユニーク識別子として使用する

このオプションを有効にすると、Kameleoon はこのカスタムデータを訪問者のユニーク識別子として扱い、複数の Kameleoon の訪問をユニークユーザーにマッピングするために使用します。詳細については、クロスデバイスエクスペリメンテーションを参照してください。

カスタムデータポイントに関連付けられたターゲティング条件の値を保存する

このオプションを使用すると、セグメントビルダーでこのカスタムデータに利用できる特定の値リストを定義できます。 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”)。

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

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