---
title: "ゲスト識別子データモデル"
slug: "guest-identifiers-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) を含めてください。

属性

概要

種類

例

挿入

アップサート

移住

provider

識別子の提供者です。

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

"CRM\_SYSTEM", "SITECORE\_IDENTITY\_SYSTEM"

サポートされていません

必須

必須

id

識別子の一意IDです。

文字列(大文字)

"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41"

サポートされていません

必須

必須

expiryDate

識別子が無効になる日時。

ISO 8601 日付/時刻 UTC

"2025-08-23T16:17:16.000Z"

サポートされていません

オプション

オプション

以下は個人識別情報(PII)を含み、upsertモードを使用している例です:

{
 "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",
 "title":"Mr",
 "firstName":"John",
 "lastName":"Does",
 "gender":"male",
 "dateOfBirth":"1985-12-24T00:00Z",
 "email":"john.doe@myretailsite.com",
 "nationality":"Irish",
 "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"
 }
 
 }
}

identifiers属性を含め、upsertモードを使用している例があります。

{
 "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":"SITECORE\_IDENTITY\_SYSTEM",
 "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
 "expiryDate":"2025-08-23T16:\`17:16\`.000Z"
 }
 
 }
}

> !注消費者がバッチAPIを使ってSitecore CDPに渡され、識別情報がfirst\_nameとlast\_nameのみの場合、Sitecore CDP新しいゲストプロファイルを作成します: traveller。例外は、注文上の消費者が注文上の連絡先と同じ名前である場合に発生します。もし連絡先が正常に特定された場合、新しいゲストプロファイルは作成されません。これはバッチAPIにのみ該当します。

{
 "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46",
 "schema":"guest",
 "mode":"upsert",
 "value":{
 "firstSeen":"2010-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2012-08-23T16:\`17:16\`.000Z",
 "guestType":"customer",
 "title":"Mr",
 "firstName":"John",
 "lastName":"Doe",
 "gender":"male",
 "dateOfBirth":"1985-12-24T00:00Z",
 "email":"john.doe@myretailsite.com",
 "nationality":"Irish",
 "passportNumber":"PZ4A9565",
 "passportExpiry":"2026-12-24T00:00Z",
 "street":
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city":"Dublin",
 "country":"IE",
 "postCode":"D2",
 "state":"Dublin",
 "subscriptions":
 {
 "name":"default",
 "channel":"EMAIL",
 "pointOfSale":"default",
 "status":"SUBSCRIBED",
 "effectiveDate":"2012-08-23T16:\`17:16\`.000Z"
 }
 ,
 "identifiers":
 {
 "provider":"SITECORE\_IDENTITY\_SYSTEM",
 "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
 "expiryDate":"2016-08-23T16:\`17:16\`.000Z"
 }
 ,
 "extensions":
 {
 "name":"loyalty",
 "key":"flyWithMe",
 "tier":"gold",
 "milesBalance":"50125",
 "memberSince":"2006-10-08T00:00",
 "loyaltyNumber":"123456789"
 }
 
 }
}