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

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

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

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

• PIIデータを使ってアイデンティティ解決を行うには、identifiersオブジェクトを使ってPIIデータを送信する必要があります。例えば、ゲストのメールアドレスを使ってアイデンティティ解決を行うことができます。これを行うには、identifiersオブジェクト内のemail属性を送信します。Sitecore PersonalizeがIDENTITYイベントを受け取った後、identifiersオブジェクトをゲストプロファイルに追加し、将来的にアイデンティティ解決に使います。
• PIIデータをゲスト プロファイルの補助的・追加情報としてSitecore Personalizeに渡すには、 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 Personalize外部の組織のアイデンティティシステムの名前で、一意のゲスト識別子を提供したものです。

"BXLP"

必須

expiry_date

文字列(ISO 8601)

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

"2026-04-15T08:39

オプション

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