--- title: "Request Binエンドポイントを使ってトリガーされた体験をテストする" slug: "test-a-triggered-experience-using-the-request-bin-endpoint" abstract: "リクエストビンを使って、選択したトリガーに基づいて応答を検証し、Sitecore Personalizeでトリガーされた体験をテストする方法。" --- # Request Binエンドポイントを使ってトリガーされた体験をテストする Sitecore Personalizeで体験を構築する際は、構築しながらテストを行うことが重要です。Sitecore Personalizeはこの目的のために様々なアプリ内テストツールを提供しており、多くの経験を積んでいる方はすでに馴染みがあるかもしれません。 トリガーされた体験は、ウェブやインタラクティブな体験とは異なるテストアプローチが必要です。トリガーされた体験をテストするには、まずライブに設定し、その後トリガーする必要があります。 このウォークスルーでは、Request Binエンドポイントを使ってトリガーされた体験をテストする方法を案内します。これにより、テスト宛先にリクエストを送信し、データを検査し、体験を効果的にデバッグできます。 このウォークスルーでは、以下の方法を説明します: 1. [Sitecore Personalizeでつながりを作りましょう。](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/test-a-triggered-experience-using-the-request-bin-endpoint.html#UUID-dd4d3d30-0309-78bc-12d1-cca9a9ad718d_section-idm234581320276212 "Create a connection in Sitecore Personalize") 2. [トリガーとなる体験を作りましょう。](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/test-a-triggered-experience-using-the-request-bin-endpoint.html#UUID-dd4d3d30-0309-78bc-12d1-cca9a9ad718d_section-idm234581370234592 "Create a triggered experience") 3. [体験にトリガーを加えましょう。](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/test-a-triggered-experience-using-the-request-bin-endpoint.html#UUID-dd4d3d30-0309-78bc-12d1-cca9a9ad718d_section-idm234581314474643 "Add a trigger to the experience") 4. [リクエストビンを使ってトリガーされた体験をテストしてください。](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/test-a-triggered-experience-using-the-request-bin-endpoint.html#UUID-dd4d3d30-0309-78bc-12d1-cca9a9ad718d_section-idm234581393071284 "Test a triggered experience") > !注**始める前に** > > - [リクエストビンを作成し](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/test-a-triggered-experience-using-the-request-bin-endpoint.html#UUID-dd4d3d30-0309-78bc-12d1-cca9a9ad718d_section-idm234581314474643 "Add a trigger to the experience") 、リクエストを収集・検査します。 > > - データを送信できるエンドポイントとなるリクエストビンのURLをコピー Sitecore Personalize。 > ## Sitecore Personalizeでつながりを作る Sitecore Personalizeからリクエストビンエンドポイントへの外部宛先への接続を設定してください。これを行うにはSitecore Cloud Portalで*Enterprise Admin*ロールが必要です。 Sitecore Personalizeで接続を作る方法: 1. ナビゲーションメニューで「**開発者センター**」>**「Connections**」をクリックしてください。 2. **「接続**」ページで「**\> Destinationを作成**」をクリックします。 3. **名前&説明**ページで、**名前**と**説明**欄を入力し、アイコンを選択し、「**次へ**」をクリックします。 4. **認証ページで「****なし**」を選び、「**次へ**」をクリックします。 5. **リクエスト**ページで: - **リクエストURL**セクションで、メソッドのドロップダウンリストでPOSTを選択し、リクエスト箱のURLを入力します。 - **Request**フィールドに、接続をテストするためのサンプルJSONリクエストを入力してください。JSONが有効であることを確認しましょう。 6. **テストリクエスト**をクリックします。**応答**フィールドに結果が表示されます。 7. **「次へ**」をクリックして「**レビュー &保存**」ページに移動し、接続情報を確認してください。 ![Verify that the new connection details are correct on the Review & Save page.](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/Request_Bin_Connection.png) 8. 接続設定を最終決定する準備ができたら、**保存**をクリックします。トリガーされた体験の設定には接続名が必要になるので、その名前に注目してください。 ## トリガーとなる体験を作り出す 接続が設定されたら、トリガーされた体験を作成し、APIリクエストをリクエストビンへの接続を使用するように設定します。 トリガー体験を作るために: 1. ナビゲーションメニューで「体験」をクリックします。経験リストが表示されます。 2. 「**トリガー** >**作成**」をクリックします。「**あなたの経験に名前を付け**る」ウィンドウが表示されます。 3. 実験**名欄**に直感的な名前を入力し、「 **作成**」をクリックします。 4. **Webhook Composer**タイルで「**APIリクエストの設定**」をクリックします。**Connection**ペインで、Request Bin URLで作成した接続を選択します。 5. **API本体**エディターで、リクエストビンエンドポイントに送りたいオファー、コンテンツ、パーソナライズを含めてAPIリクエストを作成します。 > !重要Request Binエンドポイントには機密でないデータのみを送信してください。Request Binは第三者プロバイダーなので、機密情報や個人識別情報(PII)の送信は避けてください。 6. **「保存**」をクリックします。 ## 体験にトリガーを加えましょう Sitecore Personalizeで体験をトリガーする標準またはカスタムイベントを選択します。トリガーされた体験のテストと実行の両方は、選択したトリガーに依存します。 体験にトリガーを加えると: 1. 実験ビルダーで **トリガータイルをクリックします** 。 2. トリガー **を追加**をクリックします。オプションから **標準** トリガーか **カスタム** トリガーを選択できます。 3. 標準システムイベントをトリガーとして実験を実行するには、 **標準** オプションを選択し、ドロップダウンリストでトリガーを選択してください: - **ゲスト作成** - ゲストが作成されたときに体験を運営します。 - **注文作成** - 注文が作成されたときに体験を実行。 - **注文更新** - ゲストの注文が更新された際に体験を運営します。 - **セッションクローズ** - ゲストのセッション終了時に体験を運営し、Sitecore PersonalizeがSESSION\_CLOSEイベントを受け取る。 - **ゲスト変更** カスタム - ゲストのカスタム属性が更新されたときに体験を実行します。例えば、ゲストのデータ拡張が変更された場合などです。 - **放置されたカート** - ゲストが商品をカートに置き、セッションが終了した際に体験を実施。 4. カスタムトリガーを作成するには、**カスタム**オプションを選択して以下の手順を踏みます: - **イベント名**欄にイベント名を入力してください。例えば、ADD\_TO\_CART。 - **説明**欄にイベントの説明を入力します。 - **イベント**セクションのドロップダウンリストで、オペレーターを選択します: - **等分** - 指定されたイベントが完全に一致する場合に経験値を実行します。 - **正則表現** - 指定されたイベントが指定された [正則表現](https://www.regular-expressions.info) (RegEx)パターンに一致する場合に経験を実行します。 - **で始** まる - 指定された文字列でイベントが始まる場合に経験を実行します。 - **識別子**フィールドに、イベントの名前、RegExパターン、または文字列を入力します。 - オプションで追加の識別子を追加するには、「 **Add identifier**」をクリックしてください。Sitecore Personalizeイベント識別子が一致すれば体験を実行します 5. **「保存**」をクリックします。 ## トリガーされた体験をテストしてください トリガーされた体験が期待通りに動作しているかは、リクエストビンのテストエンドポイントでリクエストをチェックすることで確認できます。 トリガー体験をテストするには: 1. 体験のために選択した特定のトリガーを上げてください。以下はさまざまなトリガーと、Sitecore Personalize APIを使ってそれらを上げる方法のクイックリファレンスです: トリガー テスト時にトリガーを上げる方法 ゲスト作成 [新しいゲストを作成する](https://api-docs.sitecore.com/cdp/guest-rest-api/guest/createguest)。 オーダー作成 [新しい注文を作成し](https://doc.sitecore.com/cdp/en/developers/api/create-an-order.html) 、ゲストと関連付けてください。 注文更新 [注文を更新してください](https://doc.sitecore.com/cdp/en/developers/api/update-an-order.html)。 セッション終了 ブラウザを開いてセッションを開始し、手動で閉じてください。 ゲストモディファイドカスタム 既存のゲストをデータ [拡張を作成](https://api-docs.sitecore.com/cdp/guest-rest-api/guest-data-extension/createguestdataextension)して更新してください。 放棄された荷車 ブラウザを開いてセッションを開始し、商品をカートに追加し、手動で閉じてください。 カスタムトリガー [Sendカスタムイベントを](https://doc.sitecore.com/cdp/en/developers/api/custom-event-1166461.html)。 2. トリガーを上げた後は [リクエストビン](https://pipedream.com/requestbin) にアクセスし、応答を確認してトリガーされた体験が正しく機能しているか確認してください。