--- title: "ゲスト拡張データモデル" slug: "guest-extension-data-model" abstract: "ゲスト拡張(Sitecore CDPバッチAPI)の標準データモデルを説明します。" --- # ゲスト拡張データモデル バッチファイルを作成する際は、以下の表の属性に加えて [、必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_para-idm1903351877649584) を含めてください。 ::::タブ:::tab{title="2.1"} 属性 概要 種類 例 挿入 アップサート 移住 firstSeen ゲストの最初のデート。 ISO 8601 日付/時刻 UTC "2026-03-07T16:15:11.000Z" サポートされていません オプション オプション lastSeen ゲストが最後にあなたのブランドと交流した時のことです。 ISO 8601 日付/時刻 UTC "2026-08-23T16:17:16.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:00Z" サポートされていません オプション オプション email ゲストのメールアドレス。 文字列(小文字推奨) "john.does@gmail.com" サポートされていません オプション オプション 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:mmZ "2026-12-24T00:00Z" サポートされていません オプション サポートされていません 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: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つまたは複数の名前/値ペア属性。名前は [属性命名のガイドライン](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/send-additional-guest-data.html)に従う必要があります。 「値」に対応した型は以下の通りです: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:11\`.000Z", "lastSeen":"2026-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 } } } ::::::tab{title="2.0"} 属性 概要 種類 例 挿入 アップサート 移住 firstSeen ゲストの最初のデート。 ISO 8601 日付/時刻 UTC "2026-03-07T16:15:11.000Z" サポートされていません オプション オプション lastSeen ゲストが最後にあなたのブランドと交流した時のことです。 ISO 8601 日付/時刻 UTC "2026-08-23T16:17:16.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:00Z" サポートされていません オプション オプション email ゲストのメールアドレス。 文字列(小文字推奨) "john.does@gmail.com" サポートされていません オプション オプション 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:mmZ "2026-12-24T00:00Z" サポートされていません オプション サポートされていません 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:16.000Z" } サポートされていません オプション オプション extensions ゲストに関連する拡張機能のリストです。 JSON JSONオブジェクトの配列 { "name":"loyalty", "key":"default", "loyaltytier":"level2", "rewardBalance":"50125", "memberSince":"2020-10-08T00:00", "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:11\`.000Z", "lastSeen":"2026-08-23T16:\`17:16\`.000Z", "guestType":"customer", "title":"Mr", "firstName":"John", "lastName":"Does", "gender":"male", "dateOfBirth":"1985-12-24T00:00Z", "email":"john.does@sitecore.com", "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" } } } :::::::