Configuration
Configuration オブジェクトには、このサイトでの Kameleoon の現在の構成に関連するグローバル定数値が含まれています。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| siteCode | String | サイトに設置された Kameleoon アプリケーションファイルに対応する一意のサイトコードです。10 文字のランダムな文字列(小文字の英字と数字)です。 |
| singlePageSupport | Boolean | Single Page Support が設定されている場合は true に設定します。グローバルには Kameleoon アプリで設定するか、Kameleoon.API.Core.enableSinglePageSupport() を使用して設定します。Single Page Support により、URL の変更がブラウザでのページ再読み込みなしに Kameleoon.API.Core.load() をトリガーします。 |
| goals | Array | このサイトで有効な(設定済みの)すべてのゴールを表す Goal オブジェクトのリストです。 |
| generationTime | Number | Kameleoon アプリケーションファイルの最後の生成時刻 (UTC 形式 - 1970 年 1 月 1 日からのミリ秒)。 |
Visitor
Visitor オブジェクトには、特定の訪問とは無関係な訪問者スコープのデータが含まれます。このオブジェクトには、訪問者のすべての Visit オブジェクト のリストが含まれます。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| code | String | ランダムに生成された訪問者コード。Kameleoon サーバーサイド SDK を介してサーバー上でカスタム値が特別に設定されていない限り、16 個のランダムな文字 (小文字と数字) からなる文字列です。 |
| numberOfVisits | Number | 訪問者の合計訪問数。この値は visits.length を超えることがあります。Activation API は最新の 25 件の訪問のみを保持するためです。 |
| firstVisitStartDate | Number | 最初の訪問の開始日 (UNIX ミリ秒)。この値は visits[0].startDate と一致しない場合があります。Activation API は最新の 25 件の訪問のみを保持するためです。 |
| visits | Array | この訪問者が Web サイトで行ったすべての Visit オブジェクト のリスト (最大 25 件)。この訪問者が 25 件を超える訪問を行った場合、このプロパティを通じて最新の 25 件のみが利用可能です。 |
| currentVisit | Object | 現在進行中のビジットに対応する Visit オブジェクトです。このプロパティは Kameleoon.API.CurrentVisit と同じオブジェクトを参照します。 |
| previousVisit | Object | 前回の訪問に対応する Visit オブジェクト。前回の訪問がない場合 (つまり、現在の訪問が最初のもの) 、このプロパティは null になります。 |
| customData | Object | VISITOR スコープのすべてのカスタムデータのマップ。マップのキーは定義されたカスタムデータ名です。このマップには、Kameleoon アプリで VISITOR スコープで定義したカスタムデータのみが含まれます。他のカスタムデータには Visit オブジェクトからアクセスできます。 |
| experimentLegalConsent | Boolean | true の場合、エンジンはビジターが実験を有効にすることについて法的同意を取得しているか(または同意が不要)です。ビジターが同意も拒否もしていない場合、このプロパティは null になります。 |
| personalizationLegalConsent | Boolean | true の場合、エンジンはビジターがパーソナライゼーションを有効にすることについて法的同意を取得しているか(または同意が不要)です。ビジターが同意も拒否もしていない場合、このプロパティは null になります。 |
Visit
Visit オブジェクトは、単一の訪問を表し、Kameleoon が収集したリアルタイム情報を含みます。データポイントには、訪問コンテキスト (デバイス、位置)、観察された行動 (継続時間、ページビュー)、およびトリガーされた実験やパーソナライゼーションなどの Kameleoon の操作が含まれます。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| index | Number | 訪問のインデックス。特定の訪問者の最初の訪問のインデックスは 0 です。Activation API は最新の 25 件の訪問のみを保持するため、Kameleoon.API.Visitor.visits[0].index は 0 と等しくない場合があります。 |
| startDate | Number | 訪問開始の日付 (UTC 形式 - 1970 年 1 月 1 日からのミリ秒)。 |
| duration | Number | このビジットの継続時間(ms)です。現在のビジットの場合、この値は常に最新です(エンジンは読み取るたびに再計算します)。 |
| pageViews | Number | ビジット中に閲覧されたページ数です。SPA では、Kameleoon.API.Core.load() を呼び出すとこの数が増加します。Single Page Support を有効にしている場合、URL の変更によりこの呼び出しが自動的に行われます。 |
| locale | String | 訪問者のブラウザのロケール。 |
| device | Object | この訪問の訪問者のデバイスに対応する Device オブジェクト。 |
| geolocation | Object | この訪問の訪問者の位置に対応する Geolocation オブジェクト。 |
| weather | Object | この訪問の訪問者の天気に対応する Weather オブジェクト。 |
| activatedExperiments | Array | このビジットでエンジンが有効にしたすべての実験に対応する ExperimentActivation オブジェクトのリストです。 |
| activatedPersonalizations | Array | このビジットでエンジンが有効にしたすべてのパーソナライゼーションに対応する PersonalizationActivation オブジェクトのリストです。 |
| conversions | Object | このビジットで行われたコンバージョンのマップです。マップのキーは定義されたゴール ID です。値は、2 つのキーを持つオブジェクトです。count(このビジットでそのゴールがコンバージョンした回数)と revenue(このビジットでのそのゴールの総売上)です。 |
| customData | Object | PAGE または VISIT スコープのすべてのカスタムデータのマップ。マップのキーは定義されたカスタムデータ名です。このマップには、Kameleoon アプリで PAGE または VISIT スコープで定義したカスタムデータのみが含まれます。他のカスタムデータには Visitor オブジェクトからアクセスできます。 |
| currentProduct | Object | 現在の製品ページに表示されている製品に対応する Product オブジェクトです。ビジターが製品ページにいない場合、このプロパティは null です。 |
| products | Array | このビジットが閲覧したすべての製品ページに対応する Product オブジェクトのリストです(該当する場合は currentProduct を含みます)。 |
| acquisitionChannel | String | ビジットの獲得チャネルの名前です。獲得チャネルの一覧と、その特性(主に Kameleoon が URL パラメータなどからどのように判別するか)は、Kameleoon アプリで定義します。 |
| landingPageURL | String | 訪問の最初のページの URL。通常はランディングページと呼ばれます。 |
| initialConversionPredictions | Object | Kameleoon Conversion Scores (KCS) のマップ。マップのキーは定義されたキーモーメント名です。値は 0 から 100 の範囲で、指定されたキーモーメントの KCS を表します。(注: Kameleoon は最近、Kameleoon アプリで「key moment」を「triggers」に変更しました。) |
kameleoonConversionScores プロパティは、Contextual Bandit & AI Targeting Premium アドオンでのみ利用可能です。Device
Device オブジェクトには、特定の訪問のデバイスに関するデータが含まれます。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| browser | String | ブラウザの名前。可能な値: Chrome、Chromium、Firefox、Safari、Microsoft Edge、Internet Explorer、Opera、Android、iPhone、iPad、iPod、Samsung Internet for Android、Opera Coast、Yandex Browser、UC Browser、Maxthon、Epiphany、Puffin、Sleipnir、K-Meleon、Windows Phone、Vivaldi、Sailfish、SeaMonkey、Amazon Silk、PhantomJS、SlimerJS、BlackBerry、WebOS、Bada、Tizen、QupZilla、Googlebot、Blink、Gecko、Webkit。 |
| browserVersion | String | ブラウザのバージョン。 |
| os | String | OS の名前。可能な値: Windows、Mac、Linux、Android、iOS、Chrome OS、Windows Phone。 |
| type | String | デバイスのタイプ。可能な値: Desktop、Tablet、Phone。 |
| screenHeight | Number | デバイスの画面の高さ (ピクセル単位)。 |
| screenWidth | String | デバイスの画面の幅 (ピクセル単位)。 |
| windowHeight | Number | ブラウザのウィンドウの高さ (ピクセル単位)。 |
| windowWidth | String | ブラウザのウィンドウの幅 (ピクセル単位)。 |
| adBlocker | Boolean | このデバイスにアクティブな広告ブロッカーがある場合は true、そうでない場合は false に等しいブール値。 |
| timeZone | String | ブラウザのタイムゾーン。値は TZ データベースのタイムゾーン に対応する文字列 (例: “Europe/Paris”) です。 |
Geolocation
Geolocation オブジェクトには、特定の訪問の訪問者の物理的な位置に関するデータが含まれます。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| country | String | 国名 (英語)。 |
| region | String | 地域の名前 (国の優先言語)。 |
| city | String | 市の名前 (国の優先言語)。 |
| postalCode | String | 郵便番号。 |
| latitude | Number | 緯度 (度単位)。 |
| longitude | Number | 経度 (度単位)。 |
Weather
Weather オブジェクトには、訪問時に発生した天気の状態に関するデータが含まれます。 プロパティ| 名前 | 型 | 説明 |
|---|---|---|
| temperature | String | 温度 (ケルビン)。 |
| humidity | String | 湿度 (パーセンテージ、0 から 100)。 |
| pressure | String | 大気圧 (hPa)。 |
| windSpeed | String | 風速 (メートル/秒)。 |
| cloudiness | Number | 雲量 (パーセンテージ、0 から 100)。 |
| sunrise | Number | 日の出時刻 (UTC 形式 - 1970 年 1 月 1 日からのミリ秒)。 |
| sunset | Number | 日の入り時刻 (UTC 形式 - 1970 年 1 月 1 日からのミリ秒)。 |
| conditionCode | Number | 天気状態の ID コード。完全なリファレンスリストはこちらで入手できます。 |
| conditionDescription | String | conditionCode と一致する天気状態の説明。たとえば、conditionCode が 800 の場合、conditionDescription は clear sky になります。 |