バッチAPIゲスト

ゲストデータモデル

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

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

本トピックでは、以下のエンティティに対するSitecore CDP標準データモデルを定義します。

アップロードできるのは、"customer"タイプのゲストである識別されたゲストだけです。

!注insertモードはサポートされていません。代わりにupsertまたはmigrationをご利用ください。

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

::::タブ:::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"に設定されなければなりません。

文字列(小文字)

"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

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

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

JSON JSONオブジェクトの配列

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

", "loyaltyNumber":"123456789" }

サポートされていません

オプション

upsertモードを使用する場合、ゲストデータモデルのすべてのフィールドは任意です。ただし、"customer"ゲストタイプを持つゲストのみをアップロードできます。

{ "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":"SITECORE_IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

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

", "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":"flyWithMe", "tier":"gold", "milesBalance":"50125", "memberSince":"2016-10-08T00

", "loyaltyNumber":"123456789" }

サポートされていません

オプション

upsertモードを使用する場合、ゲストデータモデルのすべてのフィールドは任意です。しかし、オブジェクト内にプラットフォーム内のゲストを識別するのに十分な情報が存在しなければ、更新できません。または、必要なフィールドが存在し、プラットフォーム内に一致するゲストがいない場合は、新しいゲストが作成されます。

{ "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":"Doe", "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":"SITECORE_IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

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

", "loyaltyNumber":"123456789" }

} }

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