---
title: "パーソナライズデータオブジェクト"
slug: "personalization-data-object"
abstract: "Sitecore Engage SDK(Sitecore PersonalizeストリームAPI)におけるパーソナライズデータオブジェクトを記述します。"
---
# パーソナライズデータオブジェクト

パーソナライズデータオブジェクトを使って、ユーザーに関する識別情報や、ユーザーのために実行したいインタラクティブなフルスタック体験やインタラクティブなフルスタック実験の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](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。  
  
例えば、ユーザーがあなたのウェブサイトで通貨としてオーストラリアドルを選択した場合、通貨は "AUD"となります。

-   "EUR"
-   "GBP"
-   "USD"

pointOfSale

ストリング

[ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538)  
  
この値は、あなたのSitecore Personalizeインスタンスに存在する販売時点名に設定しなければなりません。  
  
[設定オブジェクト](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/settings-object.html)でpointOfSaleを指定していなければ、パーソナライズデータオブジェクトで指定する必要があります。  
  
設定オブジェクトで pointOfSale を指定していれば、パーソナライズデータオブジェクトではオプションです。パーソナライズデータオブジェクトで、設定オブジェクトで以前指定した pointOfSaleの元の値を上書きするために指定できます。

"myretailsite/ireland"

friendlyId

ストリング

あなたが実行したいライブのインタラクティブなフルスタック体験やライブインタラクティブなフルスタック実験のIDです。

"running\_shoes\_popup\_02"

サイドバー。オプション属性

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

属性

種類

概要

例

language

文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes))

ユーザーがアプリを使っている言語。  
  
例えば、ユーザーがウェブサイトで日本語を選択した場合、その言語は "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](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/understanding-integration-details/browser-id.html "Browser 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: "jane.doe@myretailsite.com"
}

例31。識別子を持つパーソナライズデータオブジェクト

こちらはidentifiers属性をゲスト識別子として使うパーソナライズデータオブジェクトの例です。

const personalizationData = {
 channel: "WEB",
 currency: "EUR",
 pointOfSale: "myretailsite/ireland",
 friendlyId: "running\_shoes\_popup\_02",
 // guest identifier:
 identifier: {
 id: "123456",
 provider: "BXLP"
 }
}