アイデンティティイベント

::::タブ:::tab{title="2.1"}

IDENTITYイベントは、Sitecore CDPが識別解決を行うためのデータを含む。Sitecore CDPがIDENTITYイベントを受信すると、組織のアイデンティティルールに基づいて別々のゲストプロファイルのゲストデータを照合しようとするリンクアルゴリズムを実行します。IDENTITYイベントを送信する前に、Sitecore CDPのアイデンティティ解決 について学ぶことをお勧めします。

IDENTITYイベントで個人識別情報(PII)を、以下の方法でSitecore CDPに渡すことができます。

• PIIデータを使ってアイデンティティ解決を行うには、identifiersオブジェクトを使ってPIIデータを送信する必要があります。例えば、ゲストのメールアドレスを使って身元確認を行うことができます。これを行うには、identifiersオブジェクトに email 属性を送信します。Sitecore CDPがIDENTITYイベントを受け取った後、将来のアイデンティティ解決のためにidentifiersオブジェクトをゲストプロファイルに追加します。
• PIIデータをゲスト プロファイルの補助的・追加情報としてSitecore CDPに渡すには、 identifiersオブジェクトの外部にPIIデータを送信します。

ゲストが提供したデータのIDENTITYイベントは、サイトのどこにでも記録しなければなりません。単一のブラウザセッションで複数のIDENTITYイベントが存在することは一般的です。

IDENTITYイベントを送信するには、以下の属性を使用します。

属性

種類

概要

例

必須/任意

channel

文字列(大文字)

ユーザーがブランドと関わる接点です。

• "MOBILE_APP"
• "MOBILE_WEB"
• "WEB"

必須

type

文字列(大文字)

ユーザーがあなたのブランドと関わる際に起こるイベントの種類。

"IDENTITY"

必須

language

文字列(大文字 ISO 639-1)

ユーザーがアプリを使っている言語。

• "DE"
• "EN"
• "FR"

必須

currency

文字列(大文字の ISO 4217)

ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。

• "EUR"
• "GBP"
• "USD"

必須

page

ストリング

ブランドとのやり取りが行われるウェブページの名前。

これはお好みのカスタム値です。

• "home"
• "contact-us.html"

必須

pos

ストリング

ブランドとのやり取りが行われる販売ポイントの名前。

• "myretailsite/ireland"
• "spinair.com/france"

必須

browser_id

ストリング

ブラウザID。

"a38b230c-11eb-4cf9-8d5d-274e9f344925​"

必須

email

文字列(小文字推奨)

ゲストのメールアドレス。

"[email protected]"

オプション

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)

ゲストの生年月日。

"1983-04-15T00

オプション

mobile

ストリング

ゲストの携帯番号。

"+3531234567"

オプション

phone

ストリング

ゲストの電話番号です。

"+3531234567"

オプション

street

文字列の配列(タイトルケース推奨)

ゲストの住所。

"Tara Street"

オプション

city

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

ゲストの市の住所。

"Dublin"

オプション

state

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

ゲストの州住所。

"Oregon"

オプション

country

文字列(大文字 ISO 3166-1アルファ-2)

ゲストの国籍住所。

"IE"

オプション

postCode

ストリング

ゲストの郵便番号。

"D2"

オプション

identifiers

オブジェクトの配列

アプリのユーザーを特定するために使われる識別子です。

該当なし

必須

identifiersオブジェクトの配列:

属性

種類

概要

例

必須/任意

id

ストリング

顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。

"123456"

必須

provider

ストリング

あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。

"BXLP"

必須

expiry_date

文字列(ISO 8601)

一意のゲスト識別子が失効する日付。これは組織のアイデンティティシステムによって決まります。

"2026-04-15T08:39

オプション

例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": "[email protected]", "firstname": "Jane", "lastname": "Doe" }