--- title: "直接HTTPリクエストを使って統合" slug: "integrate-direct-http-requests" abstract: "Sitecore Personalizeに直接HTTPリクエストを送ることでアプリをSitecore Personalizeと統合する方法。" --- # 直接HTTPリクエストを使って統合 このトピックでは、直接HTTPリクエストを使って統合する方法を説明します。ネイティブアプリやモバイルアプリとSitecore Personalize統合したい場合に役立ちます。 このウォークスルーに従うには、ターミナルやPostmanなどのAPIテストツールを使用します。このウォークスルーでは、Git BashターミナルのcURLを使ってHTTPリクエストの提出を実演します。本番環境では、コードベース上でHTTPリクエストを作成します。 このウォークスルーでは、以下の方法を説明します: > !注**始める前に** > > - [Sitecore Personalizeインスタンスに関する必要な情報を集めましょう。](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/walkthroughs-for-integrating/collect-required-details.html "Collect required details") > > - HTTPのリクエスト-レスポンスサイクルや、cURLを使ってターミナルでHTTPリクエストを作成する方法に慣れていることを確認してください。 > ## ブラウザIDをSitecore Personalizeから入手してください 統合の最初のステップは、ブラウザのIDを得るためにHTTPリクエストをSitecore Personalizeに送ることです。その後のすべてのリクエストでブラウザIDを含める必要がありますSitecore Personalize。 ブラウザIDを取得するには: 1. 端末で次のHTTPリクエストを行ってください。 プレースホルダーの値は [Sitecore Personalizeインスタンスの必要な詳細に置き換えてください。](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/preparing-to-integrate/collect-required-details.html "Collect required details") curl -X GET -g '/v1.2/browser/create.json?client\_key=' 例示リクエスト: curl -X GET -g 'https://api-engage-eu.sitecorecloud.io/v1.2/browser/create.json?client\_key=ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe' HTTP応答体はrefキーを含むJSONオブジェクトです。 refキーにはブラウザIDが含まれています。 "ref" : "a38b230c-11eb-4cf9-8d5d-274e9f344925​", 2. ブラウザのIDをメモしてください。今後のSitecore Personalizeへのリクエストには必ず含めてください。 ## 初めてのVIEWイベントをSend ブラウザのIDを取得した後、イベントをキーと値のペアで送信します。 イベントを送信するには: 1. VIEWイベントを表すキーと値のペアを準備します。後のステップで、URL内のmessageクエリパラメータに渡します。URL内で有効なキーと値の組み合わせを準備しなければなりません。以下を必ず確認してください: - すべてのキーと値をダブルクォートで囲 ""。 - 改行は付けないでください。 - キーや値の周りにスペースを入れないでください。 キーと値のペアの例: "browser\_id":"a38b230c-11eb-4cf9-8d5d-274e9f344925​","channel":"MOBILE\_APP","type":"VIEW","language":"EN","currency":"EUR","page":"homepage","pos":"myretailsite/ireland" > !重要 "browser\_id" キーには、前のステップで取得したブラウザIDが含まれています。 > > Sitecore Personalizeに送るすべてのイベントにはブラウザの内容が含まれID。 2. 端末で次のHTTPリクエストを行い、キーと値のペアをmessageクエリパラメータに渡します。 プレースホルダーの値は [Sitecore Personalizeインスタンスの必要な詳細に置き換えてください。](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/preparing-to-integrate/collect-required-details.html "Collect required details") messageクエリパラメータでは、プレースホルダーの値を組織固有の[イベントオブジェクト値](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/bx-js-library-legacy-reference/objects-1166464/event-object/event-object.html "Event object")に置き換えます。 curl -X GET -g '/v1.2/event/create.json?client\_key=&message={"browser\_id":"","channel":"","type":"","language":"","currency":"","page":"","pos":""}' 例示リクエスト: curl -X GET -g 'https://api-engage-eu.sitecorecloud.io/v1.2/event/create.json?client\_key=ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe&message={"browser\_id":"a38b230c-11eb-4cf9-8d5d-274e9f344925​","channel":"MOBILE\_APP","type":"VIEW","language":"EN","currency":"EUR","page":"homepage","pos":"myretailsite/ireland"}' イベントデータはSitecore Personalizeに送信されます。 ## Sitecore Personalize VIEWイベントをキャプチャしたか確認してください VIEWイベントを送信した後、Sitecore Personalizeにログインしてイベントを探します。 Sitecore Personalize VIEWイベントをキャプチャしたか確認するために: 1. Sitecore Personalizeでは、**イベントビューア**\>**開発者センター**をクリックし、検索ドロップダウンで**ブラウザID**を選択し、コピーしたテキストを検索フィールドに貼り付けます。このゲストに関連するイベントのリストが表示されます。リストにはVIEWイベントが含まれています。これは以前の手続きでトリガーされたイベントです。 > !注Sitecore CDPとSitecore Personalizeの両方を持っている場合は、**ゲスト**でデータを見つけることができます。 ## 今後のステップ あなたはすでにアプリをSitecore Personalizeとうまく統合しました。ブラウザのIDを得るためにHTTPリクエストを行いました。そしてブラウザIDを使ってVIEWイベントを送信し、Sitecore Personalizeがリアルタイムでユーザーに関するデータをキャプチャしていることを確認しました。 次に、次のことができます: - Send 他の種類のイベント、例えば [IDENTITYイベント](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/identity-event-1166449.html "IDENTITY event")。 - [ブラウザID](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/understanding-integration-details/browser-id.html "Browser ID")について詳しく学びましょう。