Request Binエンドポイントを使ってトリガーされた体験をテストする
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore Personalizeで体験を構築する際は、構築しながらテストを行うことが重要です。Sitecore Personalizeはこの目的のために様々なアプリ内テストツールを提供しており、多くの経験を積んでいる方はすでに馴染みがあるかもしれません。
トリガーされた体験は、ウェブやインタラクティブな体験とは異なるテストアプローチが必要です。トリガーされた体験をテストするには、まずライブに設定し、その後トリガーする必要があります。
このウォークスルーでは、Request Binエンドポイントを使ってトリガーされた体験をテストする方法を案内します。これにより、テスト宛先にリクエストを送信し、データを検査し、体験を効果的にデバッグできます。
このウォークスルーでは、以下の方法を説明します:
!注始める前に
リクエストビンを作成し 、リクエストを収集・検査します。
データを送信できるエンドポイントとなるリクエストビンのURLをコピー Sitecore Personalize。
Sitecore Personalizeでつながりを作る
Sitecore Personalizeからリクエストビンエンドポイントへの外部宛先への接続を設定してください。これを行うにはSitecore Cloud PortalでEnterprise Adminロールが必要です。
Sitecore Personalizeで接続を作る方法:
-
ナビゲーションメニューで「開発者センター」>「Connections」をクリックしてください。
-
「接続」ページで「> Destinationを作成」をクリックします。
-
名前&説明ページで、名前と説明欄を入力し、アイコンを選択し、「次へ」をクリックします。
-
**認証ページで「**なし」を選び、「次へ」をクリックします。
-
リクエストページで:
- リクエストURLセクションで、メソッドのドロップダウンリストでPOSTを選択し、リクエスト箱のURLを入力します。
- Requestフィールドに、接続をテストするためのサンプルJSONリクエストを入力してください。JSONが有効であることを確認しましょう。
-
テストリクエストをクリックします。応答フィールドに結果が表示されます。
-
「次へ」をクリックして「レビュー &保存」ページに移動し、接続情報を確認してください。
-
接続設定を最終決定する準備ができたら、保存をクリックします。トリガーされた体験の設定には接続名が必要になるので、その名前に注目してください。
トリガーとなる体験を作り出す
接続が設定されたら、トリガーされた体験を作成し、APIリクエストをリクエストビンへの接続を使用するように設定します。
トリガー体験を作るために:
-
ナビゲーションメニューで「体験」をクリックします。経験リストが表示されます。
-
「トリガー >作成」をクリックします。「あなたの経験に名前を付ける」ウィンドウが表示されます。
-
実験名欄に直感的な名前を入力し、「 作成」をクリックします。
-
Webhook Composerタイルで「APIリクエストの設定」をクリックします。Connectionペインで、Request Bin URLで作成した接続を選択します。
-
API本体エディターで、リクエストビンエンドポイントに送りたいオファー、コンテンツ、パーソナライズを含めてAPIリクエストを作成します。
!重要Request Binエンドポイントには機密でないデータのみを送信してください。Request Binは第三者プロバイダーなので、機密情報や個人識別情報(PII)の送信は避けてください。
-
「保存」をクリックします。
体験にトリガーを加えましょう
Sitecore Personalizeで体験をトリガーする標準またはカスタムイベントを選択します。トリガーされた体験のテストと実行の両方は、選択したトリガーに依存します。
体験にトリガーを加えると:
- 実験ビルダーで トリガータイルをクリックします 。
- トリガー を追加をクリックします。オプションから 標準 トリガーか カスタム トリガーを選択できます。
- 標準システムイベントをトリガーとして実験を実行するには、 標準 オプションを選択し、ドロップダウンリストでトリガーを選択してください:
- ゲスト作成 - ゲストが作成されたときに体験を運営します。
- 注文作成 - 注文が作成されたときに体験を実行。
- 注文更新 - ゲストの注文が更新された際に体験を運営します。
- セッションクローズ - ゲストのセッション終了時に体験を運営し、Sitecore PersonalizeがSESSION_CLOSEイベントを受け取る。
- ゲスト変更 カスタム - ゲストのカスタム属性が更新されたときに体験を実行します。例えば、ゲストのデータ拡張が変更された場合などです。
- 放置されたカート - ゲストが商品をカートに置き、セッションが終了した際に体験を実施。
- カスタムトリガーを作成するには、カスタムオプションを選択して以下の手順を踏みます:
- イベント名欄にイベント名を入力してください。例えば、ADD_TO_CART。
- 説明欄にイベントの説明を入力します。
- イベントセクションのドロップダウンリストで、オペレーターを選択します:
- 等分 - 指定されたイベントが完全に一致する場合に経験値を実行します。
- 正則表現 - 指定されたイベントが指定された 正則表現 (RegEx)パターンに一致する場合に経験を実行します。
- で始 まる - 指定された文字列でイベントが始まる場合に経験を実行します。
- 識別子フィールドに、イベントの名前、RegExパターン、または文字列を入力します。
- オプションで追加の識別子を追加するには、「 Add identifier」をクリックしてください。Sitecore Personalizeイベント識別子が一致すれば体験を実行します
- 「保存」をクリックします。
トリガーされた体験をテストしてください
トリガーされた体験が期待通りに動作しているかは、リクエストビンのテストエンドポイントでリクエストをチェックすることで確認できます。
トリガー体験をテストするには:
-
体験のために選択した特定のトリガーを上げてください。以下はさまざまなトリガーと、Sitecore Personalize APIを使ってそれらを上げる方法のクイックリファレンスです:
トリガー
テスト時にトリガーを上げる方法
ゲスト作成
オーダー作成
新しい注文を作成し 、ゲストと関連付けてください。
注文更新
セッション終了
ブラウザを開いてセッションを開始し、手動で閉じてください。
ゲストモディファイドカスタム
既存のゲストをデータ 拡張を作成して更新してください。
放棄された荷車
ブラウザを開いてセッションを開始し、商品をカートに追加し、手動で閉じてください。
カスタムトリガー
-
トリガーを上げた後は リクエストビン にアクセスし、応答を確認してトリガーされた体験が正しく機能しているか確認してください。