Flowオブジェクト

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

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

大事な

Boxever JavaScript Libraryは更新を受信しなくなりました。Sitecore Engage SDKにアップグレードして、将来の更新プログラムと拡張機能を取得することをお勧めします。

Boxever JavaScript LibraryまたはDirect HTTPリクエストを使用してSitecore Personalizeと統合する場合は、フローオブジェクトを使用して、ユーザーに関する識別データを収集し、ユーザーに対して実行するインタラクティブフルスタックエクスペリエンスまたはインタラクティブフルスタック実験のfriendlyIDを収集します。次に、オブジェクトをSitecore Personalizeに送信し、Sitecore Personalizeエクスペリエンスまたは実験を実行します。

フローオブジェクトの必須属性

少なくとも、すべてのフローオブジェクトには、次の属性と1つのゲスト識別子属性が含まれている必要があります。

属性	種類	形容	例	必須/オプション
clientKey	糸	クライアントキー。	"ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe"	必須
friendlyId	糸	実行するライブの対話型フルスタックエクスペリエンスまたはライブの対話型フルスタック実験のID。	"running_shoes_popup_02"	必須
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。たとえば、Webページの場合、チャネルは "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)	ユーザーがアプリを使用している言語。例えば、ユーザーがWebサイトで日本語を選択した場合、その言語は "JA"になります。	"DE" "EN" "FR"	必須
currencyCode	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。たとえば、ユーザーがウェブサイトの通貨としてオーストラリアドルを選択した場合、通貨は "AUD"になります。	"EUR" "GBP" "USD"	必須
pointOfSale	糸	ブランドとのインタラクションが行われるPOSの名前。この値は、Sitecore Personalizeのインスタンスに存在する販売時点情報の名前に設定する必要があります。	"myretailsite/ireland"	必須

上記の属性に加えて、フローオブジェクトには、次のゲスト識別子属性のいずれかを含める必要があります。

属性	種類	形容	例	必須/オプション
browserId	糸	ブラウザID。 Boxever JavaScript Libraryを使用している場合は、Boxever.getID() 関数が返す値に値を設定します。browser_id: Boxever.getID() 直接HTTP要求を使用している場合は、ブラウザIDを取得したときに返された値に値を設定します。	ブラウザIDは、次のような文字列です。 "a38b230c-11eb-4cf9-8d5d-274e9f344925"	このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。
email	string (小文字を推奨)	ゲストのメールアドレス。	"[email protected]"	このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。
identifiers	オブジェクトの配列	アプリのユーザーを識別するために使用される識別子。	`identifiers: [{ "id": "123456", "provider": "BXLP" }]`	このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。

属性

種類

形容

例

必須/オプション

browserId

糸

ブラウザID。

Boxever JavaScript Libraryを使用している場合は、Boxever.getID() 関数が返す値に値を設定します。browser_id: Boxever.getID()

直接HTTP要求を使用している場合は、ブラウザIDを取得したときに返された値に値を設定します。

ブラウザIDは、次のような文字列です。

"a38b230c-11eb-4cf9-8d5d-274e9f344925"

このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。

string (小文字を推奨)

ゲストのメールアドレス。

"[email protected]"

このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。

identifiers

オブジェクトの配列

アプリのユーザーを識別するために使用される識別子。

identifiers: [{
    "id": "123456",
    "provider": "BXLP"
}]

このテーブルの他の属性がフローオブジェクトの一部でない場合、必須です。

オブジェクトのidentifiers配列:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	必須
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	必須
expiry_date	文字列 (ISO 8601)	一意のゲスト識別子の有効期限が切れる日付。これは、組織のIDシステムによって決まります。	"2025-04-15T08:39:44.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 Libraryを使用するインテグレーションのフローオブジェクトについて説明します。フローオブジェクトは、ゲスト識別子として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 Libraryを使用するインテグレーションのフローオブジェクトについて説明します。フローオブジェクトは、オブジェクトの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",
    }]
}

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

Flowオブジェクト

フロー オブジェクトの必須属性

フローオブジェクトのオプション属性

例

フローオブジェクトの必須属性