イベントORDER_CHECKOUT
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
::::タブ:::tab{title="2.1"}
!重要フライトデータモデルを使用するには、ORDER_CHECKOUTイベントを送信するのではなく 、複数のイベントを使って命令を組み立て ます。
ORDER_CHECKOUTイベントを送信する前に、ゲストが識別される際にはIDENTITYイベントを送信する必要があります。
ORDER_CHECKOUTイベントを送信するには、以下の必要な属性を使用します。
属性
種類
概要
例
channel
文字列(大文字)
ユーザーがブランドと関わる接点です。
- "MOBILE_APP"
- "MOBILE_WEB"
- "WEB"
type
文字列(大文字)
ユーザーがあなたのブランドと関わる際に起こるイベントの種類。
"ORDER_CHECKOUT"
language
文字列(大文字 ISO 639-1)
ユーザーがアプリを使っている言語。
- "DE"
- "EN"
- "FR"
currency
文字列(大文字の ISO 4217)
ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。
- "EUR"
- "GBP"
- "USD"
page
ストリング
ブランドとのやり取りが行われるウェブページの名前。
これはお好みのカスタム値です。
- "home"
- "contact-us.html"
pos
ストリング
- "myretailsite/ireland"
- "spinair.com/france"
browser_id
ストリング
"a38b230c-11eb-4cf9-8d5d-274e9f344925"
order
目的
ゲストの注文書だ。
該当なし
orderの目的:
属性
種類
概要
例
必須/任意
referenceId
ストリング
あなたの組織が発行する唯一のIDで、その注文を参照します。
"123456"
必須
orderedAt
ISO 8601 日付/時刻 UTC
注文が行われた日時。
"2026-01-01T16:17
.000Z"必須
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
.000Z"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"
例50。ORDER_CHECKOUTイベントオブジェクト
{ "type": "ORDER_CHECKOUT", "channel": "WEB", "pos": "myretailsite/ireland", "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925", "language": "EN", "currency": "EUR", "page":"checkout page", "order": { "referenceId": "123456", "orderedAt": "2026-08-23T16:`17
`.000Z", "status": "PURCHASED", "currencyCode": "EUR", "price": 200, "paymentType": "Card", "cardType": "Visa", "extensions": { "name": "ext", "key": "default", "refundable": true } , "orderItems": { "type": "MOBILE_PHONE", "referenceId": "REF-123", "orderedAt": "2026-08-23T16:`17`.000Z", "status": "PURCHASED", "currencyCode": "EUR", "price": 200, "name": "Mobile phone of type x", "productId": "MOBILE_PHONE_TYPE_X", "quantity": 1, "extensions": { "name": "ext", "key": "default", "phoneColor": "Gold", "insurance": false }}
} }
2.0のデータモデルはこの機能をサポートしていません。