対話型エクスペリエンスの実行

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

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

対話型エクスペリエンスを作成した後、顧客との対話をシミュレートし、エクスペリエンスをトリガーするデータのペイロードをSitecore Personalizeに送信することで、エクスペリエンスをテストできます。

これは、カスタムフィールドを使用する高度なエクスペリエンスの場合に行うことをお勧めします。より簡単なエクスペリエンスのために、コードをテストする代わりにAPI応答をプレビューできます。

対話型エクスペリエンスを実行するには、さまざまなオプションがあります。

Engage SDKまたはCloud SDKが提供する機能を使用する。
Personalize REST APIを使用してPOSTリクエストを送信する。
Chrome DevToolsコンソールをBoxever.js (従来版)で使用する。

エンゲージSDK

Engage SDKを使用している場合は、Engage.personalize(personalizationData, timeout) 関数を使用してインタラクティブエクスペリエンスを実行できます。この関数は、実行するライブエクスペリエンスのfriendlyIdで呼び出す必要があります。

エクスペリエンスを実行してコンソールにログを記録する方法の例を次に示します。

import { engage } from "./engage.js";
// ...

const handlePersonalization = async () => {
    const response = await engage.personalize(personalizationData);
    console.log(response);
};

次に、パーソナライゼーションデータオブジェクトを示します。このオブジェクトには、ゲストを識別するためのemail属性やidentifier属性は含まれていません。このパーソナライゼーションデータオブジェクトには、オプションのカスタムフィールドも含まれています。

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

クラウドSDK

Cloud SDKを使用している場合は、personalize関数を使用して、Sitecore Personalizeでライブのインタラクティブエクスペリエンスを実行できます。

Next.jsのpersonalize関数の使用方法の例を次に示します。

"use client";
import { useEffect } from "react";
import { init, personalize } from "@sitecore-cloudsdk/personalize/browser";

export default function Home() {
  // Initialize the module using init()...

  // Run personalization:
  const runPersonalization = async () => {
    const personalizationData = {
      channel: "WEB",
      friendlyId: "running_shoes_popup_02",
    };

    const personalizeRes = await personalize(personalizationData);
    console.log("Ran personalization.", personalizeRes);
  };

  return (
    <div>
      <button onClick={runPersonalization}>run personalization</button>
    </div>
  );
}

REST API

対話型エクスペリエンスを実行するには、Personalize REST APIを使用してPOST要求を行います。

フロー実行要求を送信するには、browserId、email、またはidentifiersを使用する必要があります。

browserIdを使用してエクスペリエンスを実行する例を次に示します。

curl -X POST '<baseURL>/v2/callFlows' \
-H 'Accept: application/json' \
--data-raw '
{
    "clientKey": "abBah8aelipaPeebae7roox2tiexoSee",
    "channel": "WEB",
    "language": "en",
    "currencyCode": "EUR",
    "pointOfSale": "myretailsite/ireland",
    "browserId": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
    "friendlyId": "home_page_banner"
}'

Boxever.js(レガシー)

Chrome DevToolsコンソールを使用して、Boxever.jsを使用したインタラクティブなエクスペリエンスのJavaScriptを実行できます。この方法は、Boxever.jsライブラリがインストールされているWebサイトからリクエストを実行し、最小限のセットアップで済むため、一般的に使用されます。

Chrome DevToolsを使用して対話型エクスペリエンスを実行するために使用できるJavaScriptの例を次に示します。

var flowData = {
      "clientKey": Boxever.client_key,
      "channel": "WEB",
      "language": "en",
      "currencyCode": "EUR",
      "pointOfSale": Boxever.pointOfSale,
      "browserId": Boxever.getID(),
      "friendlyId": "cos__interactive__custom_fields" }
Boxever.callFlows(flowData, function(response) {
    console.log(response);
});

ペイロードリクエストにカスタムパラメータを含めるには、次のJSON例に示すように、keyパラメータをflowDataオブジェクトに追加し、カスタムparamsをキーと値のペアとして追加します。

"params": {
        "loggedInState": "logged in"    // example
        "someKey": "someValue"      // example
      }

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