パーソナライズデータオブジェクト
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
パーソナライズデータオブジェクトを使って、ユーザーに関する識別情報や、ユーザーのために実行したいインタラクティブなフルスタック体験やインタラクティブなフルスタック実験のfriendlyIDを収集します。その後、オブジェクトをSitecore Personalizeに送信し、Sitecore Personalizeがその体験や実験を実行します。
このオブジェクトを作成したら、Engage.personalize()(engage-personalize.md "Engage.personalize(personalizationData, timeout)") 関数を使って送信できます。
サイドバー。必須属性
最低限、すべてのパーソナライズデータオブジェクトには以下の属性が含まれなければなりません:
属性
種類
概要
例
channel
文字列(大文字)
ユーザーがブランドと関わる接点です。
例えば、ウェブページの場合、チャネルは "WEB"です。モバイルアプリの画面では、チャネルは "MOBILE_APP"です。
値を設定しなければ、体験や実験のチャネルは "WEB"になります。
以下のいずれかでなければなりません:
- "AIRPORT_KIOSK"
- "BRANCH"
- "CALL_CENTER"
- "EMAIL"
- "GDS"
- "KIOSK"
- "MOBILE_APP"
- "MOBILE_WEB"
- "SMS"
- "OFFLINE"
- "OTA"
- "OTHER"
- "WEB"
currency
文字列(大文字の ISO 4217)
ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。
例えば、ユーザーがあなたのウェブサイトで通貨としてオーストラリアドルを選択した場合、通貨は "AUD"となります。
- "EUR"
- "GBP"
- "USD"
pointOfSale
ストリング
この値は、あなたのSitecore Personalizeインスタンスに存在する販売時点名に設定しなければなりません。
設定オブジェクトでpointOfSaleを指定していなければ、パーソナライズデータオブジェクトで指定する必要があります。
設定オブジェクトで pointOfSale を指定していれば、パーソナライズデータオブジェクトではオプションです。パーソナライズデータオブジェクトで、設定オブジェクトで以前指定した pointOfSaleの元の値を上書きするために指定できます。
"myretailsite/ireland"
friendlyId
ストリング
あなたが実行したいライブのインタラクティブなフルスタック体験やライブインタラクティブなフルスタック実験のIDです。
"running_shoes_popup_02"
サイドバー。オプション属性
パーソナライズデータオブジェクトは、オプションで以下の属性を含めることができます。
属性
種類
概要
例
language
文字列(大文字 ISO 639-1)
ユーザーがアプリを使っている言語。
例えば、ユーザーがウェブサイトで日本語を選択した場合、その言語は "JA"です。
デフォルトは "EN"です。
- "DE"
- "EN"
- "FR"
params
目的
自分で選ぶ物。
フラットオブジェクト構造を使いましょう。Sitecore Personalize自動的にネストされたオブジェクトをフラット化し、必要に応じてキーの名前を変更します。例えば:
ネストされたオブジェクト:
{"params":{"customObject":{"number":"16"}}}
キー名を変更した平坦なオブジェクト:
{"params_customObject_number":"16"}
params: { key: "value" }
サイドバー。オプションのゲスト識別子属性
パーソナライズデータオブジェクトは、以下のいずれか1つ以上ゲスト識別子属性を含めてはなりません。パーソナライズデータオブジェクトにこれらの属性が含まれていない場合、ブラウザIDがゲスト識別子となります。
- 属性
- email: 文字列(小文字推奨)
- identifier
identifierの目的:
属性
種類
概要
例
必須/任意
id
ストリング
顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。
"123456"
必須
provider
ストリング
Sitecore Personalize外部の組織のアイデンティティシステムの名前で、一意のゲスト識別子を提供したものです。
"BXLP"
必須
例29。ブラウザIDを持つパーソナライズデータオブジェクト
ここに、ゲストを識別するためのemail属性やidentifier属性を含まないパーソナライズデータオブジェクトの例があります。この場合、ブラウザIDはゲスト識別子です。このパーソナライズデータオブジェクトにはオプションのカスタムオブジェクトも含まれています。
const personalizationData = { channel: "WEB", currency: "EUR", pointOfSale: "myretailsite/ireland", friendlyId: "running_shoes_popup_02", // optional attributes: params: { key: "value" } }
例30。メールを含むパーソナライズデータオブジェクト
こちらはemail属性をゲスト識別子として使うパーソナライズデータオブジェクトの例です。
const personalizationData = { channel: "WEB", currency: "EUR", pointOfSale: "myretailsite/ireland", friendlyId: "running_shoes_popup_02", // guest identifier: email: "[email protected]" }
例31。識別子を持つパーソナライズデータオブジェクト
こちらはidentifiers属性をゲスト識別子として使うパーソナライズデータオブジェクトの例です。
const personalizationData = { channel: "WEB", currency: "EUR", pointOfSale: "myretailsite/ireland", friendlyId: "running_shoes_popup_02", // guest identifier: identifier: { id: "123456", provider: "BXLP" } }