---
title: "直接HTTPリクエストを使って統合"
slug: "integrate-direct-http-requests"
abstract: "Sitecore CDPに直接HTTPリクエストを送ることでアプリをSitecore CDPに統合する方法。"
---
# 直接HTTPリクエストを使って統合

このトピックでは、直接HTTPリクエストを使った統合方法について説明します。これは、Sitecore CDPをネイティブアプリやネイティブモバイルアプリと統合したい場合に役立ちます。

このウォークスルーに従うには、ターミナルやPostmanなどのAPIテストツールを使用します。このウォークスルーでは、Git BashターミナルのcURLを使ってHTTPリクエストの提出を実演します。本番環境では、コードベース上でHTTPリクエストを作成します。

このウォークスルーでは、以下の方法を説明します:

> !注**始める前に**
> 
> -   [Sitecore CDPインスタンスに関する必要な情報を収集してください。](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/walkthroughs-for-integrating/collect-required-details.html "Collect required details")
>     
> -   HTTPのリクエスト-レスポンスサイクルや、cURLを使ってターミナルでHTTPリクエストを作成する方法に慣れていることを確認してください。
>     

## Sitecore CDPからブラウザIDを取得してください

統合の最初のステップは、Sitecore CDPにHTTPリクエストを送り、ブラウザIDを取得することです。その後、Sitecore CDPに行くすべてのリクエストには必ずブラウザIDを含める必要があります。

ブラウザIDを取得するには:

1.  端末で次のHTTPリクエストを行ってください。
    
    プレースホルダーの値は、[Sitecore CDPインスタンスの必要な詳細に置き換えてください。](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/preparing-to-integrate/collect-required-details.html "Collect required details")
    
    curl -X GET -g '<stream\_api\_target\_endpoint\_PLACEHOLDER>/v1.2/browser/create.json?client\_key=<client\_key\_PLACEHOLDER>'
    
    例示リクエスト:
    
    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 CDPに申請する際はすべて含めてください。
    

## 初めての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 CDPに送信するすべてのイベントにはブラウザIDを含める必要があります。
    
2.  端末で次のHTTPリクエストを行い、キーと値のペアをmessageクエリパラメータに渡します。
    
    プレースホルダーの値は、[Sitecore CDPインスタンスの必要な詳細に置き換えてください。](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/preparing-to-integrate/collect-required-details.html "Collect required details")
    
    messageクエリパラメータでは、プレースホルダーの値を組織固有の[イベントオブジェクト値](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/bx-js-library-legacy-reference/objects-1166464/event-object/event-object.html "Event object")に置き換えます。
    
    curl -X GET -g '<stream\_api\_target\_endpoint\_PLACEHOLDER>/v1.2/event/create.json?client\_key=<client\_key\_PLACEHOLDER>&message={"browser\_id":"<browser\_id\_PLACEHOLDER>","channel":"<channel\_PLACEHOLDER>","type":"<type\_PLACEHOLDER>","language":"<language\_PLACEHOLDER>","currency":"<currency\_PLACEHOLDER>","page":"<page\_PLACEHOLDER>","pos":"<pos\_PLACEHOLDER>"}'
    
    例示リクエスト:
    
    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 CDPに送信されます。
    

## Sitecore CDPがあなたのVIEWイベントをキャプチャしたか確認してください

VIEWイベントを送信した後、Sitecore CDPにログインしてイベントを見つけます。

Sitecore CDPがあなたのVIEWイベントをキャプチャしたことを確認するために:

1.  Sitecore CDPで「 **ゲスト**」をクリックし、検索ドロップダウンで **「Browser ID** 」を選択し、前のステップで取得したブラウザIDを入力してください。
    
    検索例:
    
    a38b230c-11eb-4cf9-8d5d-274e9f344925​
    
    匿名のゲストが展示している。
    
    ![Search field in the Guests screen.](https://doc.sitecore.com/api/markdown-image/cdp/ja/developers/api/images/cdp-guests-bid.jpg)
    
    これは、前のステップでブラウザのIDを取得するためにHTTPリクエストをしている状態です。次に、このゲストに関連付けられたVIEWイベントを見つけます。
    
2.  ゲストをクリックしてください。ゲストプロフィールが表示されます。
    
3.  ゲストプロフィールページでイベント **ビューアー**をクリックします。このゲストに関連するイベントのリストが表示されます。リストにはVIEWイベントが含まれています。これは前回の手順でトリガーされたイベントです。
    

## 今後のステップ

あなたは今、アプリをSitecore CDPと無事に統合しました。ブラウザのIDを取得するためのHTTPリクエストを行いました。そしてブラウザIDを使ってVIEWイベントを送信し、Sitecore CDPがリアルタイムでユーザーデータをキャプチャしていることを確認しました。

次に、次のことができます:

-   Send 他の種類のイベント、例えば [IDENTITYイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/identity-event-1166449.html "IDENTITY event")。
-   [ブラウザID](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/understanding-integration-details/browser-id.html "Browser ID")について詳しく学びましょう。