ゲストデータモデル
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、次のエンティティのSitecore CDP標準データ モデルを定義します。
アップロードできるのは、ゲスト タイプが"customer"識別されたゲストのみです。
バッチ・ファイルを作成するときは、フォーマット要件 に従い、次の表の属性を含めてください。
|
属性 |
形容 |
種類 |
使用例 |
挿入する |
アップサート |
移動 |
|---|---|---|---|---|---|---|
|
firstSeen |
ゲストが最初に見た日付。 |
ISO 8601日付/時刻UTC |
"2025-03-07T16:15:11.000Z" |
サポート対象外 |
随意 |
随意 |
|
lastSeen |
ゲストが最後にブランドとやり取りした時間。 |
ISO 8601日付/時刻UTC |
"2025-08-23T16:17:16.000Z" |
サポート対象外 |
随意 |
随意 |
|
guestType |
取得されるIDのレベルを表す必須のSitecore CDP属性。 これは "customer"に設定する必要があります。 |
string (小文字) |
"customer" |
サポート対象外 |
随意 |
随意 |
|
title |
ゲストの肩書き。 |
string (タイトルケース) |
"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 |
ゲストの名前。 |
string (タイトルケース) |
"John" |
サポート対象外 |
随意 |
随意 |
|
lastName |
ゲストの姓。 |
string (タイトルケースを推奨) |
"Does" |
サポート対象外 |
随意 |
随意 |
|
gender |
ゲストの性別。 |
string (小文字) |
"male", "female", "unknown" |
サポート対象外 |
随意 |
随意 |
|
dateOfBirth |
ゲストの生年月日。 |
ISO 8601日付/時刻UTC検証: 日付は過去の日付である必要があります。 |
"1985-12-24T00:00Z" |
サポート対象外 |
随意 |
随意 |
|
|
ゲストのメールアドレス。 |
string (小文字を推奨) |
サポート対象外 |
随意 |
随意 | |
|
phoneNumbers |
ゲストの電話番号。 |
文字列のJSON配列 |
"+353161123345", "+353861123311" |
サポート対象外 |
随意 |
随意 |
|
language |
ゲストの優先言語。 |
文字列 (2文字のISO 639言語コード) |
"EN", "FR", "DE" |
サポート対象外 |
随意 |
随意 |
|
nationality |
ゲストの国籍。 |
string (タイトルケース) |
"Irish", "British", "Spanish", "French""Irish", "British", "Spanish", "French" |
サポート対象外 |
随意 |
随意 |
|
passportNumber |
宿泊者のパスポート番号。 |
string (大文字) |
"PZ4A9565" |
サポート対象外 |
随意 |
随意 |
|
passportExpiry |
ゲストのパスポートの有効期限。 |
糸 yyyy-MM-ddTHH:mmZ |
"2026-12-24T00:00Z" |
サポート対象外 |
随意 |
サポート対象外 |
|
street |
ゲストの住所。 |
文字列のJSON配列 (タイトルケース) |
"Ashford House", "Tara Street", "Dublin 2" |
サポート対象外 |
随意 |
随意 |
|
city |
ゲストの都市。 |
string (タイトルケース) |
"Dublin", "London", "Madrid", "Paris" |
サポート対象外 |
随意 |
随意 |
|
country |
ゲストの国。 |
文字列(2文字、ISO 3166-1、Alpha-2国コード) |
"IE", "GB", "ES", "FR" |
サポート対象外 |
随意 |
オプション (大文字) |
|
postCode |
ゲストの郵便番号。 |
string (大文字) |
"D2" |
サポート対象外 |
随意 |
随意 |
|
state |
ゲストの状態。 |
string (タイトルケース) |
"Oregon" |
サポート対象外 |
随意 |
随意 |
|
identifiers |
ゲストの識別子の一覧。 |
JSONオブジェクトのJSON配列 |
{ "provider":"CR_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17:16.000Z" } |
サポート対象外 |
随意 |
随意 |
|
extensions |
ゲストに関連付けられている内線番号のリスト。 nameの値をextに設定する必要があります。 |
JSONオブジェクトのJSON配列 |
{ "name":"ext", "key":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00:00", "loyaltyNumber":"123456789" } |
サポート対象外 |
随意 |
随意 |
upsertモードを使用する場合、ゲスト データ モデルのすべてのフィールドはオプションです。ただし、アップロードできるのは、識別されたゲスト(ゲストタイプが"customer"ゲスト)のみです。
{ "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46", "schema":"guest", "mode":"upsert", "value":{ "guestType":"customer", "firstSeen":"2025-03-07T16:15:11.000Z", "lastSeen":"2025-08-23T16:17:16.000Z", "identifiers":[ { "provider":"SITECORE_IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17:16.000Z" } ], "extensions":[ { "name":"ext", "key":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00:00", "loyaltyNumber":"123456789" } ] } }
|
属性 |
形容 |
種類 |
使用例 |
挿入する |
アップサート |
移動 |
|---|---|---|---|---|---|---|
|
firstSeen |
ゲストが最初に見た日付。 |
ISO 8601日付/時刻UTC |
"2025-03-07T16:15:11.000Z" |
サポート対象外 |
随意 |
随意 |
|
lastSeen |
ゲストが最後にブランドとやり取りした時間。 |
ISO 8601日付/時刻UTC |
"2025-08-23T16:17:16.000Z" |
サポート対象外 |
随意 |
随意 |
|
guestType |
取得されるIDのレベルを表す必須のSitecore CDP属性。 |
string (小文字) |
"customer" |
サポート対象外 |
随意 |
随意 |
|
title |
ゲストの肩書き。 |
string (タイトルケース) |
"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 |
ゲストの名前。 |
string (タイトルケース) |
"John" |
サポート対象外 |
随意 |
随意 |
|
lastName |
ゲストの姓。 |
string (タイトルケースを推奨) |
"Does" |
サポート対象外 |
随意 |
随意 |
|
gender |
ゲストの性別。 |
string (小文字) |
"male", "female", "unknown" |
サポート対象外 |
随意 |
随意 |
|
dateOfBirth |
ゲストの生年月日。 |
ISO 8601日付/時刻UTC検証: 日付は過去の日付である必要があります。 |
"1985-12-24T00:00Z" |
サポート対象外 |
随意 |
随意 |
|
|
ゲストのメールアドレス。 |
string (小文字を推奨) |
サポート対象外 |
随意 |
随意 | |
|
phoneNumbers |
ゲストの電話番号。 |
文字列のJSON配列 |
"+353161123345", "+353861123311" |
サポート対象外 |
随意 |
随意 |
|
language |
ゲストの優先言語。 |
文字列 (2文字のISO 639言語コード) |
"EN", "FR", "DE" |
サポート対象外 |
随意 |
随意 |
|
nationality |
ゲストの国籍。 |
string (タイトルケース) |
"Irish", "British", "Spanish", "French""Irish", "British", "Spanish", "French" |
サポート対象外 |
随意 |
随意 |
|
passportNumber |
宿泊者のパスポート番号。 |
string (大文字) |
"PZ4A9565" |
サポート対象外 |
随意 |
随意 |
|
passportExpiry |
ゲストのパスポートの有効期限。 |
糸 yyyy-MM-ddTHH:mmZ |
"2026-12-24T00:00Z" |
サポート対象外 |
随意 |
サポート対象外 |
|
street |
ゲストの住所。 |
文字列のJSON配列 (タイトルケース) |
"Ashford House", "Tara Street", "Dublin 2" |
サポート対象外 |
随意 |
随意 |
|
city |
ゲストの都市。 |
string (タイトルケース) |
"Dublin", "London", "Madrid", "Paris" |
サポート対象外 |
随意 |
随意 |
|
country |
ゲストの国。 |
文字列(2文字、ISO 3166-1、Alpha-2国コード) |
"IE", "GB", "ES", "FR" |
サポート対象外 |
随意 |
オプション (大文字) |
|
postCode |
ゲストの郵便番号。 |
string (大文字) |
"D2" |
サポート対象外 |
随意 |
随意 |
|
state |
ゲストの状態。 |
string (タイトルケース) |
"Oregon" |
サポート対象外 |
随意 |
随意 |
|
identifiers |
ゲストの識別子の一覧。 |
JSONオブジェクトのJSON配列 |
{ "provider":"CR_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17:16.000Z" } |
サポート対象外 |
随意 |
随意 |
|
extensions |
ゲストに関連付けられている内線番号のリスト。 |
JSONオブジェクトのJSON配列 |
{ "name":"loyalty", "key":"flyWithMe", "tier":"gold", "milesBalance":"50125", "memberSince":"2016-10-08T00:00", "loyaltyNumber":"123456789" } |
サポート対象外 |
随意 |
随意 |
upsertモードを使用する場合、ゲスト データ モデルのすべてのフィールドはオプションです。ただし、更新するには、プラットフォーム内のゲストを識別するための十分な情報がオブジェクト内に存在する必要があります。または、必須フィールドが存在し、一致するゲストがプラットフォームに存在しない場合は、新しいゲストが作成されます。
{ "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46", "schema":"guest", "mode":"upsert", "value":{ "firstSeen":"2025-03-07T16:15:11.000Z", "lastSeen":"2025-08-23T16:17:16.000Z", "guestType":"customer", "title":"Mr", "firstName":"John", "lastName":"Doe", "gender":"male", "dateOfBirth":"1985-12-24T00:00Z", "email":"[email protected]", "nationality":"Irish", "passportNumber":"PZ4A9565", "passportExpiry":"2026-12-24T00:00Z", "street":[ "Apartment 15", "West Drive Avenue" ], "city":"Dublin", "country":"IE", "postCode":"D2", "state":"Dublin", "identifiers":[ { "provider":"SITECORE_IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17:16.000Z" } ], "extensions":[ { "name":"loyalty", "key":"flyWithMe", "tier":"gold", "milesBalance":"50125", "memberSince":"2016-10-08T00:00", "loyaltyNumber":"123456789" } ] } }