イベントの送信

IDENTITYイベント

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

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

IDENTITYイベントには、Sitecore Personalize ID解決を実行できるデータが含まれています。 Sitecore PersonalizeはIDENTITYイベントを受信すると、リンクアルゴリズムを実行して、組織のIDルールに基づいて、個別のゲストプロファイルのゲストデータの照合を試みます。IDENTITYイベントの送信を開始する前に、Sitecore PersonalizeでのID解決について学習することをお勧めします。

IDENTITYイベントで個人を特定できる情報 (PII) をSitecore Personalizeに渡すには、次のオプションを使用します。

PIIデータを使用してID解決を実行するには、identifiersオブジェクトを使用してPIIデータを送信する必要があります。たとえば、ゲストのメールアドレスを使用してID解決を実行できます。これを行うには、identifiersオブジェクトのemail属性を送信します。Sitecore PersonalizeはIDENTITYイベントを受信すると、identifiersオブジェクトをゲストプロファイルに追加し、将来のID解決に使用します。
PIIデータをSitecore Personalizeに渡して、ゲストプロファイルの補足的な追加情報として利用できるようにするには、PIIデータをidentifiersオブジェクトの外部に送信します。

ゲストが識別に役立つ可能性のあるデータを提供するサイト内の任意の場所で、IDENTITYイベントをキャプチャする必要があります。1つのブラウザーセッションに複数のIDENTITYイベントが含まれるのは一般的です。

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

属性	種類	形容	例	必須/オプション
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。	"MOBILE_APP" "MOBILE_WEB" "WEB"	必須
type	string (大文字)	ユーザーがブランドと対話したときに発生するイベントの種類。	"IDENTITY"	必須
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。	"DE" "EN" "FR"	必須
currency	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。	"EUR" "GBP" "USD"	必須
page	糸	ブランドとのインタラクションが行われるウェブページの名前。これは、選択したカスタム値です。	"home" "contact-us.html"	必須
pos	糸	ブランドとのインタラクションが行われるPOSの名前。	"myretailsite/ireland" "spinair.com/france"	必須
browser_id	糸	ブラウザID。	"a38b230c-11eb-4cf9-8d5d-274e9f344925"	必須
email	string (小文字を推奨)	ゲストのメールアドレス。	"[email protected]"	随意
title	string (タイトルケース)	ゲストの肩書き。	"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	string (タイトルケースを推奨)	ゲストの名前。	"Jane"	随意
lastname	string (タイトルケースを推奨)	ゲストの姓。	"Doe"	随意
gender	糸	ゲストの性別。	"female"	随意
dob	文字列 (ISO 8601)	ゲストの生年月日。	"1983-04-15T08:39:44.868Z"	随意
mobile	糸	ゲストの携帯電話番号。	"+3531234567"	随意
phone	糸	ゲストの電話番号。	"+3531234567"	随意
street	文字列の配列 (タイトルケースを推奨)	ゲストの住所。	"Tara Street"	随意
city	string (タイトルケースを推奨)	ゲストの市区町村の住所。	"Dublin"	随意
state	string (タイトルケースを推奨)	ゲストの州の住所。	"Oregon"	随意
country	文字列 (大文字ISO 3166-1 alpha-2)	ゲストの国の住所。	"IE"	随意
postCode	糸	ゲストの郵便番号。	"D2"	随意
identifiers	オブジェクトの配列	アプリのユーザーを識別するために使用される識別子。	該当なし	必須

オブジェクトのidentifiers配列:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	必須
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	必須
expiry_date	文字列 (ISO 8601)	一意のゲスト識別子の有効期限が切れる日付。これは、組織のIDシステムによって決まります。	"2025-04-15T08:39:44.868Z"	随意

Example 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"
    }]
}

Example 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"
}

イベント内の追加のゲストデータをSitecore CDPに渡すことができます。この新しいデータは、ゲストの識別を試みるために既存のゲストと比較されます。ゲストが自分の識別に役立つ可能性のあるデータを提供するサイト内の任意の場所で、IDENTITYイベントをキャプチャする必要があります。1つのブラウザーセッションに複数のIDENTITYイベントがあるのは一般的です。

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

属性	種類	形容	例	必須/オプション
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。	"MOBILE_APP" "MOBILE_WEB" "WEB"	必須
type	string (大文字)	ユーザーがブランドと対話したときに発生するイベントの種類。	"IDENTITY"	必須
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。	"DE" "EN" "FR"	必須
currency	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。	"EUR" "GBP" "USD"	必須
page	糸	ブランドとのインタラクションが行われるウェブページの名前。これは、選択したカスタム値です。	"home" "contact-us.html"	必須
pos	糸	ブランドとのインタラクションが行われるPOSの名前。	"myretailsite/ireland" "spinair.com/france"	必須
browser_id	糸	ブラウザID。	"a38b230c-11eb-4cf9-8d5d-274e9f344925"	必須
email	string (小文字を推奨)	ゲストのメールアドレス。	"[email protected]"	随意
title	string (タイトルケース)	ゲストの肩書き。	"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	string (タイトルケースを推奨)	ゲストの名前。	"Jane"	随意
lastname	string (タイトルケースを推奨)	ゲストの姓。	"Doe"	随意
gender	糸	ゲストの性別。	"female"	随意
dob	文字列 (ISO 8601)	ゲストの生年月日。	"1983-04-15T08:39:44.868Z"	随意
mobile	糸	ゲストの携帯電話番号。	"+3531234567"	随意
phone	糸	ゲストの電話番号。	"+3531234567"	随意
street	文字列の配列 (タイトルケースを推奨)	ゲストの住所。	"Tara Street"	随意
city	string (タイトルケースを推奨)	ゲストの市区町村の住所。	"Dublin"	随意
state	string (タイトルケースを推奨)	ゲストの州の住所。	"Oregon"	随意
country	文字列 (大文字ISO 3166-1 alpha-2)	ゲストの国の住所。	"IE"	随意
zip_code 廃止。 postCodeを使用します。	string (大文字を推奨)	ゲストの郵便番号。	N/A	随意
postCode	糸	ゲストの郵便番号。	"D2"	随意
identifiers	オブジェクトの配列	アプリのユーザーを識別するために使用される識別子。	該当なし	随意

オブジェクトのidentifiers配列:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	随意
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	随意
expiry_date	文字列 (ISO 8601)	一意のゲスト識別子の有効期限が切れる日付。これは、組織のIDシステムによって決まります。	"2025-04-15T08:39:44.868Z"	随意

告知

組織は、identifiersオブジェクトまたはemail属性を使用して、ゲストのIDを判別します。組織がemail属性を使用してゲストのIDを判別する場合、identifiersオブジェクトの属性は無視されます。組織がidentifiers属性を使用してゲストのIDを判別する場合、email属性の使用はオプションです。

Example 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"
    }]
}

Example 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": "[email protected]",
    "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"
    }]
}

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