---
title: "ADDイベント"
slug: "add-event"
abstract: "Sitecore Engage SDK(Sitecore CDP Stream API)におけるADDイベントのイベントデータオブジェクトを記述します。"
---
# ADDイベント

ADDイベントのイベントデータオブジェクトは、[イベントデータオブジェクトに必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/event-data-object.html#UUID-a7f441ce-7bee-9e1a-8a6c-7f995310e71b_UUID-2cda931f-8a8a-520d-dd7c-fe7fa3c3d597 "Required attributes") に加え、以下の属性を含める必要があります。

属性

種類

概要

例

product

目的

ユーザーがカートに追加する商品に関するデータ。

該当なし

productの目的:

属性

種類

概要

例

必須/任意

name

ストリング(タイトルケース推奨)

ユーザーがカートに追加した商品名。

"GHT 84 Lace Sneaker"

必須

type

文字列(大文字)

ユーザーがカートに追加した商品の種類。

"FOOTWEAR"

必須

item\_id

ストリング

ユーザーがカートに追加した商品の商品番号(ID)。  
  
Extract, Transform, Load(ETL)データ統合で注文を作成するために使用されます。  
  
この文字列をCONFIRMイベントの [product](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html) 配列内のオブジェクトに渡さなければ、オーダーは正常に作成されません。

"SHOES\_8475GHT"

必須

productId

ストリング

ユーザーがカートに追加した商品のID。  
  
レポート作成のための分析で使われます。

"example\_product\_id"

必須

referenceId

ストリング

組織が注文品目を参照するために生成するIDです。

"FOOTWEAR-001-01"

必須

orderedAt

文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))  
  
フォーマット: YYYY-MM-DD’T’hh:mm:ss.<timezone>

ユーザーが商品をカートに追加した日付と時間。

"2026-04-15T12:42:16.001Z"

必須

quantity

整数

ユーザーがカートに加えた商品の単位数。  
  
総価格= quantity × price

1

必須

price

浮き上がる

製品の単価です。  
  
総価格= quantity × price

7.99

必須

currency

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

製品価格が指定される通貨のアルファベット通貨コード。

-   "EUR"
-   "GBP"
-   "USD"

必須

originalPrice

浮き上がる

組織の通貨に換算される前の注文品目の単価。

7.79

オプション

originalCurrencyCode

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

注文品の元の通貨コード。

-   "EUR"
-   "GBP"
-   "USD"

オプション

このイベントデータオブジェクトを作成した後、[拡張データオブジェクト](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/extension-data-object.html "Extension data object")を使ってオプションで拡張できます。その後、Engage.event()(engage-event.md "Engage.event(type, eventData, extensionData)") 関数を使ってイベントを送信できます。

こちらはADDイベントのイベントデータオブジェクトの例です。

const eventData = {
 channel: "WEB",
 currency: "EUR",
 pointOfSale: "myretailsite/ireland",
 language: "EN",
 page: "products",
 product: {
    name: "GHT 84 Lace Sneaker",
 type: "FOOTWEAR",
     item\_id: "SHOES\_8475GHT",
     productId: "example\_product\_id",
     referenceId: "FOOTWEAR-001-01",
     orderedAt: "2026-04-15T12:\`42:16\`.001Z",
     quantity: 1,
     price: 7.99,
     currency: "EUR",
     originalPrice: 7.79,
     originalCurrencyCode: "USD"
 }
}

例25。ADDおよびCONFIRMイベント内の製品品目ID

以下は、複数の製品アイテムIDがADDとCONFIRMイベントデータオブジェクトでどのようにリンクされているかの例です。

CONFIRMイベントデータオブジェクトの[product](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html "CONFIRM event")配列に含まれる各アイテムID、製品アイテムIDが[product.item\_id](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/add-event.html "ADD event")で指定されているADDイベントデータオブジェクトが先に存在しなければなりません。

// ADD event data object for "SHOES\_8475GHT"
const addEventData = {
 // ...
 product: {
 // ...
 item\_id: "SHOES\_8475GHT"
 }
}

// ADD event data object for "JEANS\_W33L31"
const addEventData = {
 // ...
 product: {
 // ...
 item\_id: "JEANS\_W33L31"
 }
}

// CONFIRM event data object listing all product item IDs
const confirmEventData = {
 // ...
 product: 
 { item\_id: "SHOES\_8475GHT" },
 { item\_id: "JEANS\_W33L31" }
 
}