--- title: "アイデンティティイベント" slug: "identity-event-1166449" abstract: "直接HTTPリクエスト(Sitecore CDP Stream API)を使用した際のIDENTITYイベントのJSONオブジェクトを記述します。" --- # アイデンティティイベント ::::タブ:::tab{title="2.1"} IDENTITYイベントは、Sitecore CDPが識別解決を行うためのデータを含む。Sitecore CDPがIDENTITYイベントを受信すると、組織のアイデンティティルールに基づいて別々のゲストプロファイルのゲストデータを照合しようとするリンクアルゴリズムを実行します。IDENTITYイベントを送信する前に、[Sitecore CDPのアイデンティティ解決](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/understanding-identity-resolution-in-sitecore-cdp.html) について学ぶことをお勧めします。 IDENTITYイベントで個人識別情報(PII)を、以下の方法でSitecore CDPに渡すことができます。 - PIIデータを使ってアイデンティティ解決を行うには、identifiersオブジェクトを使ってPIIデータを送信する必要があります。例えば、ゲストのメールアドレスを使って身元確認を行うことができます。これを行うには、identifiersオブジェクトに email 属性を送信します。Sitecore CDPがIDENTITYイベントを受け取った後、将来のアイデンティティ解決のためにidentifiersオブジェクトをゲストプロファイルに追加します。 - PIIデータをゲスト [プロファイル](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/view-a-guest-profile-in-sitecore-cdp.html)の補助的・追加情報としてSitecore CDPに渡すには、 identifiersオブジェクトの外部にPIIデータを送信します。 ゲストが提供したデータのIDENTITYイベントは、サイトのどこにでも記録しなければなりません。単一のブラウザセッションで複数のIDENTITYイベントが存在することは一般的です。 IDENTITYイベントを送信するには、以下の属性を使用します。 属性 種類 概要 例 必須/任意 channel 文字列(大文字) ユーザーがブランドと関わる接点です。 - "MOBILE\_APP" - "MOBILE\_WEB" - "WEB" 必須 type 文字列(大文字) ユーザーがあなたのブランドと関わる際に起こるイベントの種類。 "IDENTITY" 必須 language 文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) ユーザーがアプリを使っている言語。 - "DE" - "EN" - "FR" 必須 currency 文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。 - "EUR" - "GBP" - "USD" 必須 page ストリング ブランドとのやり取りが行われるウェブページの名前。 これはお好みのカスタム値です。 - "home" - "contact-us.html" 必須 pos ストリング [ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) - "myretailsite/ireland" - "spinair.com/france" 必須 browser\_id ストリング [ブラウザID](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。 "a38b230c-11eb-4cf9-8d5d-274e9f344925​" 必須 email 文字列(小文字推奨) ゲストのメールアドレス。 "jane.doe@myretailsite.com" オプション 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 ストリング(タイトルケース推奨) ゲストの名前。 "Jane" オプション lastname ストリング(タイトルケース推奨) ゲストの姓。 "Doe" オプション gender ストリング ゲストの性別。 "female" オプション dob 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) ゲストの生年月日。 "1983-04-15T00:00" オプション mobile ストリング ゲストの携帯番号。 "+3531234567" オプション phone ストリング ゲストの電話番号です。 "+3531234567" オプション street 文字列の配列(タイトルケース推奨) ゲストの住所。 "Tara Street" オプション city ストリング(タイトルケース推奨) ゲストの市の住所。 "Dublin" オプション state ストリング(タイトルケース推奨) ゲストの州住所。 "Oregon" オプション country 文字列(大文字 [ISO 3166-1アルファ-2](https://en.wikipedia.org/wiki/ISO_3166-1)) ゲストの国籍住所。 "IE" オプション postCode ストリング ゲストの郵便番号。 "D2" オプション identifiers オブジェクトの配列 アプリのユーザーを特定するために使われる識別子です。 該当なし 必須 identifiersオブジェクトの配列: 属性 種類 概要 例 必須/任意 id ストリング 顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。 "123456" 必須 provider ストリング あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。 "BXLP" 必須 expiry\_date 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が失効する日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション 例35。IDENTITY eventオブジェクト identifiers { "channel": "MOBILE\_APP", "type": "IDENTITY", "language": "EN", "currency": "EUR", "page": "home", "pos": "myretailsite/ireland", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "identifiers": { "provider": "BXLP", "id": "123456" } } 例36。 identifiersかつ個人を特定できる情報(PII)を含むIDENTITYイベントオブジェクト { "channel": "MOBILE\_APP", "type": "IDENTITY", "language": "EN", "currency": "EUR", "page": "home", "pos": "myretailsite/ireland", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "identifiers": { "id": "123456", "provider": "BXLP" } , "email": "jane.doe@myretailsite.com", "firstname": "Jane", "lastname": "Doe" } ::::::tab{title="2.0"} イベント中に追加のゲストデータをSitecore CDPに渡すことができます。この新しいデータは既存のゲストと比較され、ゲストを特定しようとします。ゲストが提供するデータがあれば、サイトのどこにでもIDENTITYイベントを記録し、それが識別に役立つ可能性があります。単一のブラウザセッションで複数のIDENTITYイベントが存在することは一般的です。 IDENTITYイベントを送信するには、以下の属性を使用します。 属性 種類 概要 例 必須/任意 channel 文字列(大文字) ユーザーがブランドと関わる接点です。 - "MOBILE\_APP" - "MOBILE\_WEB" - "WEB" 必須 type 文字列(大文字) ユーザーがあなたのブランドと関わる際に起こるイベントの種類。 "IDENTITY" 必須 language 文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) ユーザーがアプリを使っている言語。 - "DE" - "EN" - "FR" 必須 currency 文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。 - "EUR" - "GBP" - "USD" 必須 page ストリング ブランドとのやり取りが行われるウェブページの名前。 これはお好みのカスタム値です。 - "home" - "contact-us.html" 必須 pos ストリング [ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) - "myretailsite/ireland" - "spinair.com/france" 必須 browser\_id ストリング [ブラウザID](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。 "a38b230c-11eb-4cf9-8d5d-274e9f344925​" 必須 email 文字列(小文字推奨) ゲストのメールアドレス。 "jane.doe@myretailsite.com" オプション 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 ストリング(タイトルケース推奨) ゲストの名前。 "Jane" オプション lastname ストリング(タイトルケース推奨) ゲストの姓。 "Doe" オプション gender ストリング ゲストの性別。 "female" オプション dob 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) ゲストの生年月日。 "1983-04-15T00:00" オプション mobile ストリング ゲストの携帯番号。 "+3531234567" オプション phone ストリング ゲストの電話番号です。 "+3531234567" オプション street 文字列の配列(タイトルケース推奨) ゲストの住所。 "Tara Street" オプション city ストリング(タイトルケース推奨) ゲストの市の住所。 "Dublin" オプション state ストリング(タイトルケース推奨) ゲストの州住所。 "Oregon" オプション country 文字列(大文字 [ISO 3166-1アルファ-2](https://en.wikipedia.org/wiki/ISO_3166-1)) ゲストの国籍住所。 "IE" オプション zip\_code 廃止されている。 postCodeを使え。 文字列(推奨大文字) ゲストの郵便番号。 N/A オプション postCode ストリング ゲストの郵便番号。 "D2" オプション identifiers オブジェクトの配列 アプリのユーザーを特定するために使われる識別子です。 該当なし オプション identifiersオブジェクトの配列: 属性 種類 概要 例 必須/任意 id ストリング 顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。 "123456" オプション provider ストリング あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。 "BXLP" オプション expiry\_date 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が失効する日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション > !注**通知**あなたの組織はゲストの身元を特定するためにidentifiersオブジェクトかemail属性のいずれかを使用します。もし組織がemail属性を使ってゲストの身元を特定する場合、identifiersオブジェクトの属性は無視されます。もし組織がidentifiers属性を使ってゲストの身元を特定する場合、email属性の使用は任意です。 例37。IDENTITY eventオブジェクト identifiers { "channel": "MOBILE\_APP", "type": "IDENTITY", "language": "EN", "currency": "EUR", "page": "home", "pos": "myretailsite/ireland", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "identifiers": { "provider": "BXLP", "id": "123456" } } 例38。個人識別情報(PII)を含むIDENTITYイベントオブジェクト { "channel": "MOBILE\_APP", "type": "IDENTITY", "language": "EN", "currency": "EUR", "page": "home", "pos": "spinair.com/france", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "email": "jane.doe@myretailsite.com", "title": "Ms", "firstname": "Jane", "lastname": "Doe", "gender": "female", "dob": "1980-01-23T00:00", "passport\_no": "IR123456", "mobile": "+3531234567", "phone": "+3531234567", "street": "Ashford House", "Tara Street", "Dublin 2", "city": "Dublin", "country": "IE", "postCode": "D2", "identifiers": { "provider": "BXLP", "id": "123456" } } :::::::