Engage.initServer(設定)

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

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

initServer() 関数は、アプリのサーバー側でEngage SDKを初期化します。この関数は、initServer.handleCookie() 関数を含むオブジェクトを返します。initServer() 関数を呼び出した後、アプリのクライアント側でinit() 関数を呼び出す必要があります。

同じsettingsオブジェクトをinitServer() とinit()の両方に渡しますが、initServer()でwebPersonalization属性を指定しない点が異なります。これは、webPersonalization() 属性がクライアント側でのみ使用できるためです。

パラメーター	種類	形容
settings	オブジェクト	Sitecore PersonalizeインスタンスとCookieの設定に関する詳細。

Example 3. Next app

NextアプリでinitServer() 関数を使用する方法の例を次に示します。 initServer() 関数を呼び出し、戻り値を変数に保存する必要があります。

pages/index.js:

import { useEffect } from "react";
import { init, initServer } from "@sitecore/engage";

const engageSettings = {
    // ...
    forceServerCookieMode: true
};

const engageServer = initServer(engageSettings);

export async function getServerSideProps({ req, res }) {
  await engageServer.handleCookie(req, res);
  return {
    props: {},
  };
};

export default function Home() {
  // ...
};

スクリプトについては、次の点に注意してください。

設定オブジェクトでは、forceServerCookieModeはtrueに設定されています。これにより、サーバーからCookieが設定されます。
engageServer変数は、initServer() 関数の戻り値に割り当てられます。これによりengageServerhandleCookie()機能にアクセスできるようになります。
handleCookie() 関数は、サーバー上にCookieを作成し、それらを応答ヘッダーに含めます。

NextアプリでサーバーからCookieを受け取り、そのCookieをWebブラウザーに保存する方法の例を次に示します。

pages/index.js:

export default function Home() {
  const loadEngage = async () => {
    // Load Engage API
    const engage = await init({...engageSettings, webPersonalization: false /* boolean or object. See Settings object for all options. Default: false */ });

    // Send VIEW events
  };
    
  useEffect(() => {
    loadEngage();
  }, []);

  return (
    <></>
  );
};

このスクリプトでは、webPersonalization属性がクライアント側でのみ指定される点を除き、サーバー側のinitServer() 関数に渡されたのと同じsettingsオブジェクトがinit() 関数に渡されます。

クライアントはサーバーからヘッダーを受け取り、CookieをWebブラウザに保存します。

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