フローオブジェクト
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要BoxeverのJavaScriptライブラリは今後アップデートを受け取れません。今後のアップデートや強化を受けるために、Sitecore Engage SDKへのアップグレード をお勧めします。
Boxever JavaScriptライブラリや直接HTTPリクエストを使ってSitecore Personalizeと統合する場合、フローオブジェクトを使ってユーザーに関する識別データや、そのユーザーのために実行したいインタラクティブフルスタックエクスペリエンスやインタラクティブフルスタック実験のfriendlyIDを収集します。その後、オブジェクトをSitecore Personalizeに送り、Sitecore Personalizeがその体験や実験を実行します。
フローオブジェクトに必要な属性
最低限、すべてのフローオブジェクトには以下の属性と1つのゲスト識別子属性を含める必要があります:
属性
種類
概要
例
必須/任意
clientKey
ストリング
あなたのクライアントキーです。
"ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe"
必須
friendlyId
ストリング
あなたが実行したいライブのインタラクティブフルスタック体験やライブインタラクティブフルスタック実験のIDです。
"running_shoes_popup_02"
必須
channel
文字列(大文字)
ユーザーがブランドと関わる接点です。
例えば、ウェブページの場合、チャネルは "WEB"です。モバイルアプリの画面では、チャネルは "MOBILE_APP"です。
値を設定しなければ、体験や実験のチャネルは "WEB"になります。
以下のいずれかでなければなりません:
- "AIRPORT_KIOSK"
- "BRANCH"
- "CALL_CENTER"
- "EMAIL"
- "GDS"
- "KIOSK"
- "MOBILE_APP"
- "MOBILE_WEB"
- "SMS"
- "OFFLINE"
- "OTA"
- "OTHER"
- "WEB"
必須
language
文字列(大文字 ISO 639-1)
ユーザーがアプリを使っている言語。
例えば、ユーザーがウェブサイトで日本語を選択した場合、その言語は "JA"です。
- "DE"
- "EN"
- "FR"
必須
currencyCode
文字列(大文字の ISO 4217)
ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。
例えば、ユーザーがあなたのウェブサイトで通貨としてオーストラリアドルを選択した場合、通貨は "AUD"となります。
- "EUR"
- "GBP"
- "USD"
必須
pointOfSale
ストリング
この値は、あなたのSitecore Personalizeインスタンスに存在する販売時点名に設定しなければなりません。
- "myretailsite/ireland"
必須
上記の属性に加え、フローオブジェクトには以下のいずれかのゲスト識別子属性も含めなければなりません:
- 属性
- browserId
- email: 文字列(小文字推奨)
- identifiers
identifiersオブジェクトの配列:
属性
種類
概要
例
必須/任意
id
ストリング
顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。
"123456"
必須
provider
ストリング
Sitecore Personalize外部の組織のアイデンティティシステムの名前で、一意のゲスト識別子を提供したものです。
"BXLP"
必須
expiry_date
文字列(ISO 8601)
一意のゲスト識別子が有効期限を切る日付。これは組織のアイデンティティシステムによって決まります。
"2026-04-15T08:39
.868Z"オプション
フローオブジェクトのオプション属性
フローオブジェクトには、任意のカスタムオブジェクトを含めることも可能です:
属性
種類
概要
例
必須/任意
params
目的
自分で選ぶ物。
params: { key: "value" }
オプション
例
この例は、Boxever JavaScript Libraryを使用する統合内のフローオブジェクトを説明しています。フローオブジェクトはbrowserIdをゲスト識別子として使用します。また、オプションのカスタムオブジェクトも含まれます。
const flowObject = { clientKey: Boxever.getClientKey(), friendlyId: "running_shoes_popup_02", channel: "WEB", language: "EN", currencyCode: "EUR", pointOfSale: "myretailsite/ireland", // guest identifier: browserId: Boxever.getID(), // optional attributes: aCustomObject1: { key: "value" }, aCustomObject2: { isOptional: true } }
この例は、Boxever JavaScriptライブラリを使用する統合中のフローオブジェクトを説明しています。フローオブジェクトはゲスト識別子としてemailを使用します。
const flowObject = { clientKey: Boxever.getClientKey(), friendlyId: "running_shoes_popup_02", channel: "WEB", language: "EN", currencyCode: "EUR", pointOfSale: "myretailsite/ireland", // guest identifier: email: "[email protected]" }
この例は、Boxever JavaScriptライブラリを用いた統合におけるフローオブジェクトを説明しています。フローオブジェクトはidentifiers配列のオブジェクトをゲスト識別子として使用します。
const flowObject = { clientKey: Boxever.getClientKey(), friendlyId: "running_shoes_popup_02", channel: "WEB", language: "EN", currencyCode: "EUR", pointOfSale: "myretailsite/ireland", // guest identifier: identifiers: { id: "123456", provider: "BXLP", } }