> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration and visitor objects

> Configuration、Visitor、Visit、Device、Geolocation、Weather オブジェクトのリファレンスです。

これらのオブジェクトは、サイトの設定とビジターを説明します。Visitor オブジェクトには、そのビジターについて Kameleoon が記録したすべてのビジットが含まれます。

## 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 オブジェクト](https://docs.kameleoon.com/ja/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#goal)のリストです。 |
| generationTime | Number | Kameleoon アプリケーションファイルの最後の生成時刻 (UTC 形式 - 1970 年 1 月 1 日からのミリ秒)。 |

## Visitor

Visitor オブジェクトには、特定の訪問とは無関係な訪問者スコープのデータが含まれます。このオブジェクトには、訪問者のすべての [Visit オブジェクト](#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 オブジェクト](#visit) のリスト (最大 25 件)。この訪問者が 25 件を超える訪問を行った場合、このプロパティを通じて最新の 25 件のみが利用可能です。 |
| currentVisit | Object | 現在進行中のビジットに対応する [Visit オブジェクト](#visit)です。このプロパティは **Kameleoon.API.CurrentVisit** と同じオブジェクトを参照します。 |
| previousVisit | Object | 前回の訪問に対応する [Visit オブジェクト](#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 オブジェクト](#device)。 |
| geolocation | Object | この訪問の訪問者の位置に対応する [Geolocation オブジェクト](#geolocation)。 |
| weather | Object | この訪問の訪問者の天気に対応する [Weather オブジェクト](#weather)。 |
| activatedExperiments | Array | このビジットでエンジンが有効にしたすべての実験に対応する [ExperimentActivation オブジェクト](https://docs.kameleoon.com/ja/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#experimentactivation)のリストです。 |
| activatedPersonalizations | Array | このビジットでエンジンが有効にしたすべてのパーソナライゼーションに対応する [PersonalizationActivation オブジェクト](https://docs.kameleoon.com/ja/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#personalizationactivation)のリストです。 |
| conversions | Object | このビジットで行われたコンバージョンのマップです。マップのキーは定義されたゴール ID です。値は、2 つのキーを持つオブジェクトです。**count**(このビジットでそのゴールがコンバージョンした回数)と **revenue**(このビジットでのそのゴールの総売上)です。 |
| customData | Object | **PAGE** または **VISIT** スコープのすべてのカスタムデータのマップ。マップのキーは定義されたカスタムデータ名です。このマップには、Kameleoon アプリで **PAGE** または **VISIT** スコープで定義したカスタムデータのみが含まれます。他のカスタムデータには Visitor オブジェクトからアクセスできます。 |
| currentProduct | Object | 現在の製品ページに表示されている製品に対応する [Product オブジェクト](https://docs.kameleoon.com/ja/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product)です。ビジターが製品ページにいない場合、このプロパティは **null** です。 |
| products | Array | このビジットが閲覧したすべての製品ページに対応する [Product オブジェクト](https://docs.kameleoon.com/ja/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product)のリストです(該当する場合は **currentProduct** を含みます)。 |
| acquisitionChannel | String | ビジットの獲得チャネルの名前です。獲得チャネルの一覧と、その特性(主に Kameleoon が URL パラメータなどからどのように判別するか)は、Kameleoon アプリで定義します。 |
| landingPageURL | String | 訪問の最初のページの URL。通常はランディングページと呼ばれます。 |
| initialConversionPredictions | Object | Kameleoon Conversion Scores (KCS) のマップ。マップのキーは定義されたキーモーメント名です。値は 0 から 100 の範囲で、指定されたキーモーメントの KCS を表します。(注: Kameleoon は最近、Kameleoon アプリで「key moment」を「triggers」に変更しました。) |

> [!NOTE]
>
> `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 データベースのタイムゾーン](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) に対応する文字列 (例: "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 コード。[完全なリファレンスリストはこちらで入手できます。](https://openweathermap.org/weather-conditions) |
| conditionDescription | String | `conditionCode` と一致する天気状態の説明。たとえば、`conditionCode` が **800** の場合、`conditionDescription` は **clear sky** になります。 |