Request Binエンドポイントを使用してトリガーされたエクスペリエンスをテストするTest a triggered experience using the Request Bin endpoint

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

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

Sitecore Personalizeでエクスペリエンスを構築する場合は、構築しながらテストすることが重要です。Sitecore Personalizeには、この目的のために様々なアプリ内テストツールが用意されています。多くのエクスペリエンスを構築している場合は、既に使い慣れている可能性があります。

トリガーされたエクスペリエンスには、Webエクスペリエンスやインタラクティブエクスペリエンスとは異なるテストアプローチが必要です。トリガーされたエクスペリエンスをテストするには、まずライブに設定してから、トリガーする必要があります。

このチュートリアルでは、Request Binエンドポイントを使用してトリガーされたエクスペリエンスをテストする手順を説明し、テスト宛先に要求を送信し、データを検査し、エクスペリエンスを効果的にデバッグできるようにします。

このチュートリアルでは、次の方法について説明します。

始める前に

要求をキャプチャおよび検査するための要求ビンを作成します。
Sitecore Personalizeがデータを送信できるエンドポイントとして機能する要求ビンのURLをコピーします。

で接続を作成する Sitecore Personalize

Sitecore PersonalizeからRequest Binエンドポイントへの外部宛先への接続を設定します。これを行うには、Sitecore Cloud PortalでEnterprise Adminロールが必要です。

Sitecore Personalizeで接続を作成するには:

ナビゲーションメニューで、Developer Center>Connectionsをクリックします。
Connectionsページで、「Create> Destination」をクリックします。
Name & Describeページで、NameフィールドとDescriptionフィールドに入力し、アイコンを選択してNextをクリックします。
Authenticateページで、「None」を選択し、「Next」をクリックします。
Requestページで、次の操作を行います。
- Request URLセクションで、メソッドドロップダウンリストから POST を選択し、要求ビンのURLを入力します。
- Requestフィールドに、接続をテストするためのサンプルJSON要求を入力します。JSONが有効であることを確認します。
「Test Request」をクリックします。 Responseフィールドに結果が表示されます。
NextをクリックしてReview & Saveページに進み、接続の詳細を確認します。
接続設定を完了する準備ができたら、Saveをクリックします。接続名は、トリガーされたエクスペリエンスを構成するために必要になるため、メモしておいてください。

トリガーされたエクスペリエンスを作成する

接続を設定したら、トリガーされたエクスペリエンスを作成し、リクエストビンへの接続を使用するようにAPIリクエストを設定します。

トリガーエクスペリエンスを作成するには:

ナビゲーションメニューで、Experiencesをクリックします。エクスペリエンスリストが表示されます。
Create>Triggeredをクリックします。Name Your Experience ウィンドウが表示されます。
Name your Experimentフィールドに、エクスペリエンスの直感的な名前を入力し、「 Create」をクリックします。
Webhook Composerタイルで、Configure API requestをクリックします。Connectionペインで、リクエストビンURLで作成した接続を選択します。
API bodyエディターで、Request Binエンドポイントに送信するオファー、コンテンツ、またはパーソナライゼーションを含めるAPIリクエストを作成します。

大事な

機密性の低いデータのみをRequest Binエンドポイントに送信します。Request Binはサードパーティのプロバイダーであるため、機密情報や個人を特定できる情報(PII)の送信は避けてください。
「 Save」をクリックします。

エクスペリエンスにトリガーを追加する

標準イベントまたはカスタムイベントを選択して、Sitecore Personalizeでエクスペリエンスをトリガーします。トリガーされたエクスペリエンスのテストと実行は、選択したトリガーによって異なります。

エクスペリエンスにトリガーを追加するには:

テストビルダーで、Triggerタイルをクリックします。
「 Add trigger」をクリックします。オプションからStandardトリガーまたはCustomトリガーを選択できます。
標準のシステムイベントをトリガーとして使用して実験を実行するには、Standardオプションを選択し、ドロップダウンリストでトリガーを選択します。
- Guest Created - ゲストが作成されたときにエクスペリエンスを実行します。
- Order Created - 注文が作成されたときにエクスペリエンスを実行します。
- Order Updated - ゲストの注文が更新されたときに体験を実行します。
- Session Closed - ゲストのセッションが終了し、ゲストがSESSION_CLOSEイベントを受け取ったときにエクスペリエンスを実行しますSitecore Personalize。
- Guest Modified Custom - ゲストのカスタム属性が更新されたときにエクスペリエンスを実行します。たとえば、ゲストのデータエクステンションが変更された場合などです。
- Abandoned Cart - ゲストがショッピングカートに商品を入れたままセッションが終了したときに体験を実行します。
カスタムトリガーを作成するには、「Custom」オプションを選択し、次の操作を行います。
- Event Nameフィールドに、イベントの名前を入力します。たとえば、ADD_TO_CARTです。
- Descriptionフィールドに、イベントの説明を入力します。
- Eventセクションのドロップダウンリストで、演算子を選択します。
  - Equals - 指定したイベントが完全に一致する場合にエクスペリエンスを実行します。
  - Regex- 指定したイベントが指定した正規表現 (RegEx) パターンと一致する場合にエクスペリエンスを実行します。
  - Starts with - イベントが指定された文字列で始まる場合にエクスペリエンスを実行します。
- Identifierフィールドに、イベントの名前、RegExパターン、または文字列を入力します。
- 必要に応じて、識別子を追加するには、Add identifierをクリックします。イベント識別子が一致する場合にエクスペリエンスが実行されるSitecore Personalize
「 Save」をクリックします。

トリガーされたエクスペリエンスのテスト

トリガーされたエクスペリエンスが期待どおりに動作することを確認するには、Request Binテストエンドポイントで要求を検査します。

トリガーされたエクスペリエンスをテストするには:

エクスペリエンスに対して選択した特定のトリガーを発生させます。ここでは、さまざまなトリガーのクイックリファレンスと、Sitecore Personalize APIを使用してトリガーを発生させる方法を示します。

トリガー	テスト時にトリガーを上げる方法
ゲスト作成	新しいゲストを作成します。
注文作成	新しいオーダーを作成し、ゲストに関連付けます。
注文が更新されました	注文を更新します。
セッション終了	ブラウザを開いてセッションを開始し、手動で閉じます。
ゲスト変更カスタム	データエクステンションを作成して、既存のゲストを更新します。
放棄されたカート	ブラウザを開いてセッションを開始し、ショッピングカートにアイテムを追加してから、手動で閉じます。
カスタムトリガー	カスタムイベントSendします。

トリガーを発生させた後、リクエストビンにアクセスし、応答を確認して、トリガーされたエクスペリエンスが正しく機能していることを確認します。

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