パーソナライゼーションデータオブジェクト

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

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

パーソナライゼーションデータオブジェクトを使用して、ユーザーに関する識別データと、ユーザーに対して実行するインタラクティブなフルスタックエクスペリエンスまたはインタラクティブなフルスタック実験のfriendlyIDを収集します。次に、オブジェクトをSitecore Personalizeに送信し、Sitecore Personalizeエクスペリエンスまたは実験を実行します。

このオブジェクトを作成したら、Engage.personalize() 関数を使用して送信できます。

少なくとも、すべてのパーソナライゼーションデータオブジェクトには、次の属性が含まれている必要があります。

属性	種類	形容	例
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。たとえば、Webページの場合、チャネルは "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	糸	ブランドとのインタラクションが行われるPOSの名前。この値は、Sitecore Personalizeのインスタンスに存在する販売時点情報の名前に設定する必要があります。設定オブジェクトでpointOfSaleを指定しなかった場合は、パーソナライゼーションデータオブジェクトで指定する必要があります。設定オブジェクトでpointOfSaleを指定した場合、パーソナライゼーションデータオブジェクトでは省略可能です。パーソナライゼーションデータオブジェクトで指定して、その特定のパーソナライゼーションに対して、設定オブジェクトで以前に指定したpointOfSaleの元の値を上書きできます。	"myretailsite/ireland"
friendlyId	糸	実行するライブ対話型フルスタックエクスペリエンスまたはライブ対話型フルスタック実験のID。	"running_shoes_popup_02"

パーソナライゼーションデータオブジェクトには、オプションで次の属性を含めることができます。

属性	種類	形容	例
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。例えば、ユーザーがWebサイトで日本語を選択した場合、その言語は "JA"になります。デフォルトは "EN"です。	"DE" "EN" "FR"
params	オブジェクト	選択したオブジェクト。フラットなオブジェクト構造を使用します。 Sitecore Personalizeは、ネストされたオブジェクトを自動的にフラット化し、必要に応じてキーの名前を変更します。例えば：ネストされたオブジェクト: {"params":{"customObject":{"number":"16"}}} 名前が変更されたキーを持つフラット化されたオブジェクト: {"params_customObject_number":"16"}	params: { key: "value" }

属性

種類

形容

例

language

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

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

例えば、ユーザーがWebサイトで日本語を選択した場合、その言語は "JA"になります。

デフォルトは "EN"です。

"DE"
"EN"
"FR"

params

オブジェクト

選択したオブジェクト。

フラットなオブジェクト構造を使用します。 Sitecore Personalizeは、ネストされたオブジェクトを自動的にフラット化し、必要に応じてキーの名前を変更します。例えば：

params: { key: "value" }

パーソナライゼーションデータオブジェクトには、必要に応じて、次のゲスト識別子属性を1つだけ含めることができます。パーソナライゼーションデータオブジェクトにこれらの属性が含まれていない場合、ブラウザIDがゲスト識別子になります。

属性	種類	形容	例
email	string (小文字を推奨)	ゲストのメールアドレス。	"[email protected]"
identifier	オブジェクト	アプリのユーザーを識別するために使用される識別子。	`identifier: { "id": "123456", "provider": "BXLP" }`

identifierオブジェクト:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	必須
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	必須

Example 29。ブラウザIDを持つパーソナライゼーションデータオブジェクト

次に、ゲストを識別するためのemail属性またはidentifier属性を含まないパーソナライゼーションデータオブジェクトの例を示します。この場合、ブラウザIDはゲスト識別子です。このパーソナライゼーションデータオブジェクトには、オプションのカスタムオブジェクトも含まれています。

const personalizationData = {
    channel: "WEB",
    currency: "EUR",
    pointOfSale: "myretailsite/ireland",
    friendlyId: "running_shoes_popup_02",
    // optional attributes:
    params: { key: "value" }
}

Example 30。パーソナライゼーションデータオブジェクトとメールの組み合わせ

次に、ゲスト識別子としてemail属性を使用するパーソナライゼーションデータオブジェクトの例を示します。

const personalizationData = {
    channel: "WEB",
    currency: "EUR",
    pointOfSale: "myretailsite/ireland",
    friendlyId: "running_shoes_popup_02",
    // guest identifier:
    email: "[email protected]"
}

Example 31。識別子を持つパーソナライゼーションデータオブジェクト

次に、ゲスト識別子としてidentifiers属性を使用するパーソナライゼーションデータオブジェクトの例を示します。

const personalizationData = {
    channel: "WEB",
    currency: "EUR",
    pointOfSale: "myretailsite/ireland",
    friendlyId: "running_shoes_popup_02",
    // guest identifier:
    identifier: {
        id: "123456",
        provider: "BXLP"
    }
}

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