--- title: "アイデンティティイベント" slug: "identity-event-1166449" abstract: "直接HTTPリクエスト(Sitecore PersonalizeストリームAPI)を使用した際のIDENTITYイベントのJSONオブジェクトを記述します。" --- # アイデンティティイベント ::::タブ:::tab{title="2.1"} IDENTITYイベントは、Sitecore Personalizeがアイデンティティ解決を実行するためのデータを含むものです。Sitecore PersonalizeがIDENTITYイベントを受け取ると、組織のアイデンティティルールに基づいて別々のゲストプロファイルのゲストデータを照合しようとするリンクアルゴリズムを実行します。IDENTITYイベントを送信開始する前に、まず[Sitecore Personalizeでアイデンティティ解決](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/understanding-identity-resolution-in-sitecore-cdp.html) について学ぶことをお勧めします。 IDENTITYイベントで個人識別情報(PII)を以下の方法でSitecore Personalizeに渡すことができます。 - PIIデータを使ってアイデンティティ解決を行うには、identifiersオブジェクトを使ってPIIデータを送信する必要があります。例えば、ゲストのメールアドレスを使ってアイデンティティ解決を行うことができます。これを行うには、identifiersオブジェクト内のemail属性を送信します。Sitecore PersonalizeがIDENTITYイベントを受け取った後、identifiersオブジェクトをゲストプロファイルに追加し、将来的にアイデンティティ解決に使います。 - PIIデータをゲスト [プロファイル](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/view-a-guest-profile-in-sitecore-cdp.html)の補助的・追加情報としてSitecore Personalizeに渡すには、 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/personalize/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/personalize/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 Personalize外部の組織のアイデンティティシステムの名前で、一意のゲスト識別子を提供したものです。 "BXLP" 必須 expiry\_date 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が有効期限を切る日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション 例38。IDENTITYイベントオブジェクト 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" } } 例39。 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/personalize/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/personalize/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 Personalize外部の組織のアイデンティティシステムの名前で、一意のゲスト識別子を提供したものです。 "BXLP" オプション expiry\_date 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が有効期限を切る日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション > !注**注意事項**組織はゲストの身元を特定するためにidentifiersオブジェクトまたはemail属性を使用します。もし組織がemail属性を使ってゲストの身元を特定する場合、identifiersオブジェクトの属性は無視されます。組織がidentifiers属性を使ってゲストの身元を特定する場合、email属性の使用は任意です。 例40。IDENTITYイベントオブジェクト 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" } } 例41。個人識別情報(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" } } :::::::