ゲスト拡張データモデル

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

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

バッチ・ファイルを作成するときは、フォーマット要件に従い、次の表の属性を含めてください。

属性	形容	種類	使用例	挿入する	アップサート	移動
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"	サポート対象外	随意	随意
email	ゲストのメールアドレス。	string (小文字を推奨)	"[email protected]"	サポート対象外	随意	随意
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":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00:00", "loyaltyNumber":"123456789" }	必須	必須	必須
extensions.name	値を "ext"に設定する必要があります。	文字列列挙型	"ext"	必須	必須	必須
extensions.key	値を "default"に設定する必要があります。	糸	"default"	必須	必須	必須
extensions.attribute	カスタム・データの1つ以上の名前/値のペア属性。名前は、属性の命名ガイドラインに従う必要があります。	"value"でサポートされているタイプ: string: , boolean: true or false, integer: 9, number: 99.9	"loyaltytier":"level2"	必須	必須	必須

{
   "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":"IDENTITY_SYSTEM",
            "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
            "expiryDate":"2025-08-23T16:17:16.000Z"
         }
      ],
      "extensions":[
         {
            "name":"ext",
            "key":"default",
            "loyaltyTier":"level2",
            "rewardBalance": 5012.25,
            "memberSince":"2020-10-08T00:00",
            "vipMember": true,
            "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"	サポート対象外	随意	随意
email	ゲストのメールアドレス。	string (小文字を推奨)	"[email protected]"	サポート対象外	随意	随意
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":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00:00", "loyaltyNumber":"123456789" }	必須	必須	必須
extensions.name	データエクステンションの名前。	string (大文字を推奨)	"DE12346"	サポート対象外	必須	必須
extensions.key	データエクステンションを一意に識別するキー。	string (タイトルケースを推奨)	"flyWithMe"	サポート対象外	必須	必須
extensions.attribute	データエクステンションデータ。	string (タイトルケース)	"tier":"gold" "milesBalance":"50125"	サポート対象外	必須/オプション(拡張子による)	随意

注意

特定のデータエクステンションでは、インポートによって削除されないように、すべてのフィールドが存在する必要があります。ご不明な点がございましたら、Sitecore CDP担当者にお問い合わせください。

{  
   "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":"Does",
      "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":"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":"2020-10-08T00:00",
            "loyaltyNumber":"123456789"
         }
      ]
   }
}

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