イベントORDER_CHECKOUT

::::タブ:::tab{title="2.1"}

!重要フライトデータモデルを使用するには、ORDER_CHECKOUTイベントを送信するのではなく 、複数のイベントを使って命令を組み立て ます。

ORDER_CHECKOUTイベントを送信する前に、ゲストが顧客であることを特定する必要があります。 IDENTITYイベントを参照してください。

ORDER_CHECKOUTイベントのイベントデータオブジェクトには、イベントデータオブジェクトに必要なすべての属性 に加え、以下の属性が含まれなければなりません。

属性

種類

概要

例

order

目的

ゲストの注文書だ。

該当なし

orderの目的:

属性

種類

概要

例

必須/任意

referenceId

ストリング

あなたの組織が発行する唯一のIDで、その注文を参照します。

"123456"

必須

orderedAt

ISO 8601 日付/時刻 UTC

注文が行われた日時。

"2026-01-01T16:17

必須

status

文字列(大文字)

命令の状況。

• "PURCHASED"
• "PAYMENT_PENDING"

必須

currencyCode

文字列(大文字の ISO 4217)

ゲストが購入を完了するために使った通貨。

• "EUR"
• "GBP"
• "USD"

必須

price

数字(通貨)

注文代金の金額です。

50, 30.6

必須

paymentType

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

注文の支払い方法。

• "Card"
• "PayPal"
• "voucher"
• "other"

必須

cardType

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

注文の支払いに使われたカードの種類です。

• "Mastercard"
• "Visa"
• "Diners"
• "American Express"

paymentTypeが"Card"

extensions

オブジェクトの配列

命令に関連するデータ拡張のリスト。

該当なし

オプション

orderItems

オブジェクトの配列

順番の中のアイテム。

該当なし

オプション

order.extensionsのオブジェクトの配列。すべての属性は任意です。

属性

種類

概要

例

name

文字列エナム

これを次のように設定します。"ext"

"ext"

key

文字列エナム

これを次のように設定します。"default"

"default"

属性

これはあなたが選んだカスタム属性です。

値の対応型:

• ストリング
• ブール値
• 整数
• 浮き上がる

カスタムデータ用の1つまたは複数のキー・バリューペア属性。

"refundable"

order.orderItemsのオブジェクトの配列。すべての属性は任意です。

属性

種類

概要

例

type

文字列(大文字)

注文品の種類。受け入れられた値はスキーマ内で組織ごとにあらかじめ定義されている必要があります。

以下の値はサポートされていません:

• "FLIGHT"
• "HOTEL"
• "MORTGAGE"
• "MORTGAGE_APPLICATION"
• "LOAN_APPLICATION"
• "PERSONAL_LOAN"
• "RAIL"

"MOBILE_PHONE"

referenceId

ストリング

クライアントが注文品を参照するために生成するIDです。

"REF-123"

orderedAt

文字列(ISO 8601)

注文品が作られた日付と時間。

"2026-01-01T16:17

status

文字列エナム

注文品の状況。

• "PURCHASED"
• "PAYMENT_PENDING"

currencyCode

文字列(大文字の ISO 4217)

注文品目の組織の通貨コード。

• "EUR"
• "GBP"
• "USD"

price

数字(通貨)

注文品の会社価格。

50, 30.6, -45

name

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

注文品の名前。注文品名のフリーテキスト値。最大制限

"Mobile phone of type x"

productId

ストリング

商品コードのID。

"MOBILE_PHONE_TYPE_X"

quantity

番号

注文品の数や数量。

2

extensions

オブジェクトの配列

注文項目に関連するデータ拡張のリスト。サポートされているデータ拡張は1つだけです。この機能はSitecoreの担当者にリクエストできます。

該当なし

order.orderItems.extensionsのオブジェクトの配列。すべての属性は任意です。

属性

種類

概要

例

name

文字列エナム

これを次のように設定します。"ext"

"ext"

key

文字列エナム

これを次のように設定します。"default"

"default"

属性

これはあなたが選んだカスタム属性です。

値の対応型:

• ストリング
• ブール値
• 整数
• 浮き上がる

カスタムデータ用の1つまたは複数のキー・バリューペア属性。

"phoneColor": "Gold"

このイベントデータオブジェクトを作成した後、拡張データオブジェクトを使ってオプションで拡張できます。その後、Engage.event()(engage-event.md "Engage.event(type, eventData, extensionData)") 関数を使ってイベントを送信できます。

const eventData = { channel: "WEB", currency: "EUR", pointOfSale: "myretailsite/ireland", language: "EN", page: "checkout page", order: { referenceId: "123456", orderedAt: "2026-08-23T16:`17