> ## 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.

# 実験の露出、カスタムデータ、コンバージョンイベントの確認

> 特定の訪問者に対して実験の露出、カスタムデータ、コンバージョンイベントが取り込まれたことを確認するため、Data API をクエリします。

Kameleoon の Data API は、[外部ユーザーに固有のデータの保存と取得](./storing-and-retrieving-external-data-to-target-users)、[オフラインゴールコンバージョンの管理](./processing-offline-goal-conversions-in-experiments)など、複数の機能を提供する REST API です。Data API を使用して、Kameleoon が自動的に送信した訪問イベント、または Activation API や SDK メソッドを通じて送信した訪問イベントを受信したかどうかを判別できます。この記事では、[Data API の GET visit/visitor エンドポイント](/api-reference/visit/get-visitor-data) を使用して、特定のイベントタイプが Kameleoon によって取り込まれたかどうかを確認する方法を説明します。この検証は、トラッキングコードをテストする際に特に役立ちます。以下のセクションでは、これらのイベントをプログラム的に確認する方法を説明します。

* **[実験の露出イベント](#実験の露出)**
* **[カスタムデータイベント](#カスタムデータ)**
* **[コンバージョンイベント](#コンバージョン)**

## イベントパラメーター

前述のとおり、すべてのリクエストは [Data API の GET visit/visitor エンドポイント](/api-reference/visit/get-visitor-data) に対して行う必要があります。

**実験の露出**、**カスタムデータ**、**コンバージョン** イベントリクエストの標準パラメーターには次のものが含まれます。

いずれか:

* **visitorCode (string)**: 訪問者に対する Kameleoon の一意の ID。***`mappingValue` が指定されていない場合は必須です。***

または

* **mappingValue (string)**: 該当する場合、マッピング識別子(訪問者のクロスデバイス ID として機能)として設定されたカスタムデータの値。***`visitorCode` が指定されていない場合は必須です。***

* **siteCode (string)**: Kameleoon プロジェクトを識別する英数字の一意の文字列。[このリンク](/user-manual/faq#how-do-i-find-my-sitecode)からこのコードを取得します。

* **currentVisit (string | optional)**: 現在の訪問に関連するデータを受信するには `true` に設定します。**Feature Experimentation を利用しているユーザーのみがアクティブな訪問のデータをリクエストできます。**

* リクエストされる特定のイベントに応じて、各リクエストには `true` に設定された 1 つの追加のブール値パラメーター(`experiment`、`customdata`、または `conversion` のいずれか)を含める必要があります。以下の例で示しています。

## イベントリクエスト

以下は、各イベントに固有のリクエストとレスポンスの形式の例です。

<Important>
  クエリで使用するドメインは地理的位置によって異なります。ヨーロッパでは `eu-data.kameleoon.(eu|io)`、北米では `na-data.kameleoon.(eu|io)` を使用します。
</Important>

<Note>
  よりユーザーフレンドリーな出力を得るには、リクエストヘッダーに `prettyPrint=true` パラメーターを含めます。
</Note>

### 実験の露出

***リクエスト***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&experiment=true'
```

***レスポンス***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"experimentEvents": [
                {
                    "itp": false,
                    "tabId": -218793282,
                    "time": 1748977476606,
                    "data": {
                       "id": 250830,
                       "variationId": 978588
                    }
                }
            ]
    	}
	]
}

```

<Note>
  レスポンス例で、`id` は実験の ID、`variationId` は訪問者が露出された実験の特定のバリエーションを表します。
</Note>

### カスタムデータ

***リクエスト***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&customdata=true'
```

***レスポンス***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"customDataEvents": [
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 1,
                   "valuesCountMap": {
                      "true":1
                      },
                    "overwrite": true,
                    "mappingIdentifier": false
                },
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 3,
                   "valuesCountMap": {
                      "1": 1},

                },
                "overwrite": false,
                "mappingIdentifier": false
            ]
    	}
	]
}

```

<Note>
  レスポンス例で、`index` はカスタムデータの一意の ID です。
</Note>

### コンバージョン

***リクエスト***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&conversion=true'
```

***レスポンス***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"conversionEvents": [
            	{
                	"itp": false,
                	"time": 1748912914969,
                	"data": {
                    	"goalId": 361517,
                    	"revenue": 23.5,
                    	"negative": false,
                    	"metadata": {}
                	}
            	}
        	]
    	}
	]
}

```