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

# Goal, segment, trigger, and product objects

> Goal、Segment、Trigger、Product、Category、Param、Fashion、Color、Auto、Compatible オブジェクトのリファレンスです。

これらのオブジェクトは、ゴール、セグメント、トリガー、および製品メソッドで使用されるカタログアイテムを説明します。

## Goal

`Goal` オブジェクトは、Kameleoon アプリで定義された主要パフォーマンス指標 (KPI) を表します。

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| id | Number | ゴールの ID。 |
| name | String | ゴールの名前。 |
| type | String | ゴールのタイプ。可能な値: **CLICK**、**SCROLL**、**URL**、**ENGAGEMENT**、**CUSTOM**。 |

## Segment

`Segment` オブジェクトには、訪問がセグメントに属するために満たす必要のある基準が含まれます。Kameleoon プラットフォームでは、セグメントには年齢や位置などの定数条件と、ページ滞在時間やカート内容などのトリガー条件が含まれます。

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| id | Number | セグメントの ID。 |
| name | String | セグメントの名前。 |

## Trigger

Trigger オブジェクトには、訪問がトリガーを発火させるために満たす必要のある基準が含まれます。Kameleoon プラットフォームでは、トリガーには年齢や位置などの定数条件と、ページ滞在時間やカート内容などのトリガー条件が含まれます。

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| id | Number | トリガーの ID。 |
| name | String | トリガーの名前。 |

## Product

`Product` オブジェクトは、カタログ内のアイテムを記述します。ほとんどのプロパティはオプションで、**null** の可能性があります。

**プロパティ**

| 名前 | 型 | 必須 | 説明 |
| - | - | - | - |
| id | String | True | 商品の一意の ID。 |
| name | String | False | 商品の名前。 |
| sku | String | False | 商品の Stock Keeping Unit (SKU) 。 |
| categories | Array | False | [Category オブジェクト](#category) のリスト |
| imageURL | String | False | この商品のメイン画像の URL。 |
| price | Number | False | 商品の現在の価格。 |
| oldPrice | Number | False | 商品の元の価格。通常は割引やプロモーション前のもの。 |
| brand | String | False | 商品のブランド名。 |
| description | String | False | 商品のテキストによる説明。 |
| available | Boolean | False | 商品が在庫にあるかどうかの表示。 |
| availableQuantity | Number | False | 商品の現在の在庫量。 |
| rating | Number | False | 商品に付けられた評価 (通常は 0 から 5 ですが、任意の数値も可能)。 |
| tags | Array | False | この商品のタグのリスト (String として)。 |
| typePrefix | String | False | "mobile phone" や "washing machine" などの商品タイプ。検索アルゴリズムで使用されます。 |
| merchantID | String | False | Web サイトがマーケットプレイスを運営している場合、この商品の販売者/マーチャント ID。 |
| groupId | String | False | 商品のバリアントを 1 つのグループに結合するためにこのフィールドを使用します。 |
| model | String | False | 商品のモデル。 |
| leftovers | String | False | 特定の商品の在庫。次のいずれかの値を使用してください: `one` (1 個のみ利用可能)、`few` (限られた数量、最大 10 単位)、または `lot` (10 単位以上利用可能)。 |
| priceMargin | Number | False | 商品価格マージンの重み付け係数。0 から 100 の間。 |
| isFashion | Boolean | False | 衣料品の場合は `true` に設定します。 |
| isChild | Boolean | False | 子供向け商品の場合はこのフィールドを使用します。 |
| isNew | Boolean | False | 新商品の場合はこのフィールドを使用します。 |
| accessories | Array | False | 現在の商品の補完的または同等であり得る商品 ID の配列。 |
| seasonality | Array | False | 整数の配列 (月: 1-12) 。 |
| params | Array | False | [Param オブジェクト](#param) のリスト |
| fashion | Object | False | [Fashion オブジェクト](#fashion) |
| auto | Object | False | [Auto オブジェクト](#auto) |

## Category

**プロパティ**

| 名前 | 型 | 必須 | 説明 |
| - | - | - | - |
| id | String | True | カテゴリの一意の ID。 |
| name | String | False | カテゴリの名前。 |
| parent | String | False | 親カテゴリの一意の ID。 |
| url | String | False | カテゴリの URL。 |

## Param

他のフィールドに当てはまらない製品に関するカスタム情報をアップロードできる、省略可能な汎用フィールドです。
たとえば、この情報は、商品の購入に必要なメンバーシップステータス、または旅行サーキットの出発日と帰国日などになります。

**プロパティ**

| 名前 | 型 | 必須 | 説明 |
| - | - | - | - |
| name | String | True | パラメータの名前。 |
| value | Array | True | 値のリスト (String として) 。 |
| unit | String | False | cm (センチメートル) 、wt (ワット) 、gr (グラム) などの SI 単位の 2 文字の略語を使用します。 |

## Fashion

商品に関するカスタム情報をアップロードできるオプションの汎用フィールド。

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| gender | String | "f" (Female) または "m" (Male) でなければなりません。 |
| type | String | 商品タイプ。可能な値: `shoe`、`shirt`、`tshirt`、`underwear`、`trouser`, `jacket`、`blazer`、`sock`、`belt`、`hat`、`glove`。 |
| feature | String | 商品が大人専用か子供専用かを示すためにこのフィールドを使用します。"child" または "adult" の値を取る必要があります。 |
| colors | Array | [Color オブジェクト](#color) のリスト。 |

## Color

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| color | String | 商品の色。 |
| picture | String | 画像の URL。 |

## Auto

商品に関するカスタム情報をアップロードできるオプションの汎用フィールド。

**プロパティ**

| 名前 | 型 | 説明 |
| - | - | - |
| vds | Array | 車の指紋として機能する車両識別番号 (VIN) を含む配列。 |
| compatibility | Array | [Compatible オブジェクト](#compatible) のリストを含みます |

## Compatible

**プロパティ**

| 名前 | 型 | 必須 | 説明 |
| - | - | - | - |
| brand | String | True | 車のブランド名。 |
| model | String | False | 車のモデル名。 |