対話型テストを実施する

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

このページの翻訳は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
      }

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