ゲスト識別子データモデル

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

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

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

属性	形容	種類	使用例	挿入する	アップサート	移動
provider	識別子のプロバイダー。	string (タイトルケース)	"CRM_SYSTEM", "SITECORE_IDENTITY_SYSTEM"	サポート対象外	必須	必須
id	識別子の一意のID。	string (大文字)	"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":"2025-03-07T16:15:11.000Z",
      "lastSeen":"2025-08-23T16:17:16.000Z",
      "title":"Mr",
      "firstName":"John",
      "lastName":"Does",
      "gender":"male",
      "dateOfBirth":"1985-12-24T00:00Z",
      "email":"[email protected]",
      "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":"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"
         }
      ]
   }
}

メモ

コンシューマがバッチAPIを使用してSitecore CDPに渡され、識別情報がfirst_nameとlast_nameのみである場合、Sitecore CDPはtravellerタイプの新しいゲストプロファイルを作成します。例外は、注文の消費者が注文の連絡先と同じ姓と名を持っている場合に発生します。連絡先が正常に識別された場合、新しいゲストプロファイルは作成されません。これは、Batch 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":"[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",
      "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"
         }
      ]
   }
}

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