ADDイベント
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ADDイベントのイベントデータオブジェクトは、イベントデータオブジェクトに必要なすべての属性 に加え、以下の属性を含める必要があります。
属性
種類
概要
例
product
目的
ユーザーがカートに追加する商品に関するデータ。
該当なし
productの目的:
属性
種類
概要
例
必須/任意
name
ストリング(タイトルケース推奨)
ユーザーがカートに追加した商品名。
"GHT 84 Lace Sneaker"
必須
type
文字列(大文字)
ユーザーがカートに追加した商品の種類。
"FOOTWEAR"
必須
item_id
ストリング
ユーザーがカートに追加した商品の商品番号(ID)。
Extract, Transform, Load(ETL)データ統合で注文を作成するために使用されます。
この文字列をCONFIRMイベントの product 配列内のオブジェクトに渡さなければ、オーダーは正常に作成されません。
"SHOES_8475GHT"
必須
productId
ストリング
ユーザーがカートに追加した商品のID。
レポート作成のための分析で使われます。
"example_product_id"
必須
referenceId
ストリング
組織が注文品目を参照するために生成するIDです。
"FOOTWEAR-001-01"
必須
orderedAt
文字列(ISO 8601)
フォーマット: YYYY-MM-DD’T’hh:mm
.ユーザーが商品をカートに追加した日付と時間。
"2026-04-15T12:42
.001Z"必須
quantity
整数
ユーザーがカートに加えた商品の単位数。
総価格= quantity × price
1
必須
price
浮き上がる
製品の単価です。
総価格= quantity × price
7.99
必須
currency
文字列(大文字の ISO 4217)
製品価格が指定される通貨のアルファベット通貨コード。
- "EUR"
- "GBP"
- "USD"
必須
originalPrice
浮き上がる
組織の通貨に換算される前の注文品目の単価。
7.79
オプション
originalCurrencyCode
文字列(大文字の ISO 4217)
注文品の元の通貨コード。
- "EUR"
- "GBP"
- "USD"
オプション
このイベントデータオブジェクトを作成した後、拡張データオブジェクトを使ってオプションで拡張できます。その後、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
`.001Z", quantity: 1, price: 7.99, currency: "EUR", originalPrice: 7.79, originalCurrencyCode: "USD" } }例25。ADDおよびCONFIRMイベント内の製品品目ID
以下は、複数の製品アイテムIDがADDとCONFIRMイベントデータオブジェクトでどのようにリンクされているかの例です。
CONFIRMイベントデータオブジェクトのproduct配列に含まれる各アイテムID、製品アイテムIDがproduct.item_idで指定されている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" }
}