バッチAPIゲスト

ゲスト拡張データモデル

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

バッチファイルを作成する際は、以下の表の属性に加えて、必要なすべての属性を含めてください。

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

属性

概要

種類

例

挿入

アップサート

移住

firstSeen

ゲストの最初のデート。

ISO 8601 日付/時刻 UTC

"2026-03-07T16:15

.000Z"

サポートされていません

オプション

lastSeen

ゲストが最後にあなたのブランドと交流した時のことです。

ISO 8601 日付/時刻 UTC

"2026-08-23T16:17

.000Z"

サポートされていません

オプション

guestType

取得されたアイデンティティのレベルを表すSitecore CDPの必須属性。

文字列(小文字)

"customer"

サポートされていません

オプション

title

ゲストの称号。

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

"Br", "Brigadier", "Capt", "Colonel", "Dame", "Dr", "Elder", "Fr", "General", "Hon", "Judge", "Lord", "Master", "Miss", "Mr", "Mrs", "Ms", "Mstr", "Prof", "Rabbi", "Rev", "Shaikha", "Sheikh", "Sir", "Sister", "Sr"

サポートされていません

オプション

firstName

ゲストの名前。

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

"John"

サポートされていません

オプション

lastName

ゲストの姓。

文字列(タイトル小格を推奨)

"Does"

サポートされていません

オプション

gender

ゲストの性別。

文字列(小文字)

"male", "female", "unknown"

サポートされていません

オプション

dateOfBirth

ゲストの生年月日。

ISO 8601 UTCの日付/時刻検証

。

"1985-12-24T00

サポートされていません

オプション

ゲストのメールアドレス。

文字列(小文字推奨)

"[email protected]"

サポートされていません

オプション

phoneNumbers

ゲストの電話番号。

JSON文字列配列

"+353161123345", "+353861123311"

サポートされていません

オプション

language

ゲストの好む言語。

文字列(2文字のISO 639言語コード)

"EN", "FR", "DE"

サポートされていません

オプション

nationality

ゲストの国籍。

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

"Irish", "British", "Spanish", "French""Irish", "British", "Spanish", "French"

サポートされていません

オプション

passportNumber

ゲストのパスポート番号。

文字列(大文字)

"PZ4A9565"

サポートされていません

オプション

passportExpiry

ゲストのパスポートの有効期限です。

ストリング

yyyy-mm-ddTHH

"2026-12-24T00

サポートされていません

オプション

サポートされていません

street

ゲストの住所。

JSON 文字列配列(タイトルの大文字)

"Ashford House", "Tara Street", "Dublin 2"

サポートされていません

オプション

city

ゲストの街。

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

"Dublin", "London", "Madrid", "Paris"

サポートされていません

オプション

country

ゲストの国だ。

文字列(2文字のISO 3166-1 アルファ2国コード)

"IE", "GB", "ES", "FR"

サポートされていません

オプション

任意(大文字)

postCode

ゲストの郵便番号。

文字列(大文字)

"D2"

サポートされていません

オプション

state

ゲストの状態。

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

"Oregon"

サポートされていません

オプション

identifiers

ゲストの識別者リスト。

JSON JSONオブジェクトの配列

{ "provider":"CR_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17

.000Z" }

サポートされていません

オプション

extensions

ゲストに関連する拡張機能のリストです。

JSON JSONオブジェクトの配列

{ "name":"loyalty", "key":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00

", "loyaltyNumber":"123456789" }

必須

extensions.name

値を "ext"に設定しなければなりません。

文字列エナム

"ext"

必須

extensions.key

値を "default"に設定しなければなりません。

ストリング

"default"

必須

extensions.attribute

カスタムデータ用の1つまたは複数の名前/値ペア属性。名前は属性命名のガイドラインに従う必要があります。

「値」に対応した型は以下の通りです:string: , boolean: true または false, 整数: 9, number: 99.9

"loyaltytier":"level2"

必須

{ "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46", "schema":"guest", "mode":"upsert", "value":{ "guestType":"customer", "firstSeen":"2026-03-07T16:`15

`.000Z", "lastSeen":"2026-08-23T16:`17

`.000Z", "identifiers": { "provider":"IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

`.000Z" } , "extensions": { "name":"ext", "key":"default", "loyaltyTier":"level2", "rewardBalance": 5012.25, "memberSince":"2020-10-08T00

", "vipMember": true, "loyaltyNumber": 123456789 }

} }

属性

概要

種類

例

挿入

アップサート

移住

firstSeen

ゲストの最初のデート。

ISO 8601 日付/時刻 UTC

"2026-03-07T16:15

.000Z"

サポートされていません

オプション

lastSeen

ゲストが最後にあなたのブランドと交流した時のことです。

ISO 8601 日付/時刻 UTC

"2026-08-23T16:17

.000Z"

サポートされていません

オプション

guestType

取得されたアイデンティティのレベルを表すSitecore CDPの必須属性。

文字列(小文字)

"customer"

サポートされていません

オプション

title

ゲストの称号。

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

サポートされていません

オプション

firstName

ゲストの名前。

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

"John"

サポートされていません

オプション

lastName

ゲストの姓。

文字列(タイトル小格を推奨)

"Does"

サポートされていません

オプション

gender

ゲストの性別。

文字列(小文字)

"male", "female", "unknown"

サポートされていません

オプション

dateOfBirth

ゲストの生年月日。

ISO 8601 UTCの日付/時刻検証

。

"1985-12-24T00

サポートされていません

オプション

ゲストのメールアドレス。

文字列(小文字推奨)

"[email protected]"

サポートされていません

オプション

phoneNumbers

ゲストの電話番号。

JSON文字列配列

"+353161123345", "+353861123311"

サポートされていません

オプション

language

ゲストの好む言語。

文字列(2文字のISO 639言語コード)

"EN", "FR", "DE"

サポートされていません

オプション

nationality

ゲストの国籍。

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

"Irish", "British", "Spanish", "French""Irish", "British", "Spanish", "French"

サポートされていません

オプション

passportNumber

ゲストのパスポート番号。

文字列(大文字)

"PZ4A9565"

サポートされていません

オプション

passportExpiry

ゲストのパスポートの有効期限です。

ストリング

yyyy-mm-ddTHH

"2026-12-24T00

サポートされていません

オプション

サポートされていません

street

ゲストの住所。

JSON 文字列配列(タイトルの大文字)

"Ashford House", "Tara Street", "Dublin 2"

サポートされていません

オプション

city

ゲストの街。

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

"Dublin", "London", "Madrid", "Paris"

サポートされていません

オプション

country

ゲストの国だ。

文字列(2文字のISO 3166-1 アルファ2国コード)

"IE", "GB", "ES", "FR"

サポートされていません

オプション

任意(大文字)

postCode

ゲストの郵便番号。

文字列(大文字)

"D2"

サポートされていません

オプション

state

ゲストの状態。

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

"Oregon"

サポートされていません

オプション

identifiers

ゲストの識別者リスト。

JSON JSONオブジェクトの配列

{ "provider":"CR_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17

.000Z" }

サポートされていません

オプション

extensions

ゲストに関連する拡張機能のリストです。

JSON JSONオブジェクトの配列

{ "name":"loyalty", "key":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00

", "loyaltyNumber":"123456789" }

必須

extensions.name

データ拡張の名前です。

文字列(推奨大文字)

"DE12346"

サポートされていません

必須

extensions.key

データ拡張を一意に識別するキーです。

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

"flyWithMe"

サポートされていません

必須

extensions.attribute

データ拡張データ。

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

"tier":"gold"
"milesBalance":"50125"

サポートされていません

延長期間によりますが必須/任意

オプション

注意

特定のデータ拡張では、インポート時に削除されないためにすべてのフィールドが存在する必要があります。質問がある場合はSitecore CDPの担当者にお問い合わせください。

{ "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46", "schema":"guest", "mode":"upsert", "value":{ "firstSeen":"2026-03-07T16:`15

`.000Z", "lastSeen":"2026-08-23T16:`17

`.000Z", "guestType":"customer", "title":"Mr", "firstName":"John", "lastName":"Does", "gender":"male", "dateOfBirth":"1985-12-24T00

", "email":"[email protected]", "nationality":"Irish", "passportNumber":"PZ4A9565", "passportExpiry":"2026-12-24T00

", "street": "Apartment 15", "West Drive Avenue" , "city":"Dublin", "country":"IE", "postCode":"D2", "state":"Dublin", "identifiers": { "provider":"IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

`.000Z" } , "extensions": { "name":"loyalty", "key":"flyWithMe", "tier":"gold", "milesBalance":"50125", "memberSince":"2020-10-08T00

", "loyaltyNumber":"123456789" }

} }

この記事を改善するための提案がある場合は、お知らせください!