Engage SDKパッケージを使用してReactアプリを統合する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、Engage SDKパッケージを使用してReactアプリを統合する方法について説明します。
このチュートリアルでは、次のことを前提としています。
-
Sitecore Personalizeインスタンスに関する必要な詳細を収集している。
-
統合するReactアプリを用意します。
このチュートリアルでは、次の方法について説明します。
-
@sitecore/engageをインストールして初期化します。
-
初めてのVIEWイベントSend。
-
Sitecore PersonalizeがVIEWイベントをキャプチャしたことを確認します。
@sitecore/engageのインストールと初期化
アプリを統合するための最初の手順は、@sitecore/engageパッケージをインストールして初期化することです。
パッケージをインストールして初期化するには、次のようにします。
-
ターミナルで、Reactアプリのルートフォルダを開きます。
-
次のコマンドを実行して、Engage SDKをインストールします。
-
コードエディタで、Reactアプリのルートフォルダを開きます。
-
srcフォルダに、engage.jsというファイルを作成します。
-
engage.jsに、次のコードを貼り付けます。
プレースホルダーの値を 、Sitecore Personalizeインスタンスの必要な詳細に置き換えます。
このスクリプトは、次のことを行います。
-
Engageのコンテキスト ( EngageContext ) とプロバイダ コンポーネント ( EngageProvider) を作成します。
-
EngageProviderでは、Sitecore Personalizeインスタンスの詳細を使用してEngage APIを非同期的に読み込み、クライアントからCookieを設定します。
-
Engage APIのインスタンスをEngageProviderを使用してエクスポートします。
-
useEngageフックをエクスポートして、アプリでEngage関数を簡単に呼び出すことができます。
-
-
index.jsでは、アプリを でEngageProviderでラップします。EngageProviderでアプリがレンダリングされ、すべてのEngage機能がアプリ全体で使用できるようになります。
-
ターミナルで「 npm start 」と入力して、Reactアプリを起動します。Webブラウザーのコンソールで、「 Engage;」と入力します。オブジェクトが戻ってきたら、Engageは正常に初期化されています。
初めてのVIEWイベントSend
@sitecore/engageパッケージをインストールして初期化したら、データを収集してSitecore Personalizeに送信します。VIEWイベントは、Webページが読み込まれるたびにトリガーされるため、VIEWイベントを送信します。
VIEWイベントを送信するには:
-
App.jsで、App関数でuseEngageフックを使用してengage.pageView() 関数を呼び出し、VIEWイベント データを送信します。
プレースホルダーの値を 、Sitecore Personalizeインスタンスの必要な詳細に置き換えます。
このスクリプトは、VIEWイベント オブジェクトを作成し、コンポーネントが初めてレンダリングされた直後にイベント データをSitecore Personalizeに送信します。また、ブラウザIDをコンソールに記録します。次の手順では 、ブラウザー IDを使用して、Sitecore PersonalizeでVIEWイベントを検索します。
-
Webブラウザーで、アプリを再読み込みします。Webページが読み込まれると、VIEWイベントがトリガーされ、イベント データが送信されます。
Sitecore PersonalizeがVIEWイベントをキャプチャしたことを確認します
次のステップ
これで、アプリとSitecore Personalizeが正常に統合されました。アプリからイベントを送信し、Sitecore Personalizeがユーザーに関するデータをリアルタイムでキャプチャすることを確認しました。