直接HTTP要求を使用した統合

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

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

このトピックでは、直接HTTP要求を使用して統合する方法について説明します。これは、Sitecore CDPをネイティブアプリまたはネイティブモバイルアプリと統合する場合に便利です。

このチュートリアルでは、次のことを前提としています。

Sitecore CDPインスタンスに関する必要な詳細を収集している。
HTTP要求と応答のサイクルと、cURLを使用してターミナルでHTTP要求を行うことに精通している。

このチュートリアルに従うには、ターミナルまたはAPIテストツール (Postmanなど) を使用します。このチュートリアルでは、Git BashターミナルでcURLを使用して、HTTP要求の作成を示します。本番環境では、コードベースでHTTPリクエストを行います。

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

ブラウザIDをSitecore CDPから取得します。
初めてのVIEWイベントSend。
Sitecore CDPがVIEWイベントをキャプチャしたことを確認します。

ブラウザIDをSitecore CDP

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

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

ターミナルで、次のHTTPリクエストを行います。

プレースホルダーの値を、Sitecore CDPインスタンスの必要な詳細に置き換えます。
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.boxever.com/v1.2/browser/create.json?client_key=ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe'
HTTPレスポンス本文は、refキーを含むJSONオブジェクトです。

refキーには、ブラウザー IDが含まれています。
"ref" : "a38b230c-11eb-4cf9-8d5d-274e9f344925",
ブラウザIDをメモします。これは、Sitecore CDPに対して行う後続のすべてのリクエストに含めます。

初めてのVIEWイベントSend

ブラウザIDを取得したら、イベントをキーと値のペアとして送信します。

イベントを送信するには:

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が含まれている必要があります。

ターミナルで、次のHTTPリクエストを行い、キーと値のペアをmessageクエリパラメータに渡します。

プレースホルダーの値を、Sitecore CDPインスタンスの必要な詳細に置き換えます。

messageクエリパラメーターで、プレースホルダーの値を組織に固有のイベントオブジェクト値に置き換えます。

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.boxever.com/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イベントをキャプチャしたことを確認するには:

Sitecore CDPでGuestsをクリックし、検索ドロップダウンでBrowser IDを選択し、前の手順で取得したブラウザIDを入力します。

検索文字列の例:

a38b230c-11eb-4cf9-8d5d-274e9f344925

匿名のゲストが表示されます。

これは、前の手順でブラウザIDを取得するためのHTTPリクエストを行っているものです。次に、このゲストに関連付けられているVIEWイベントを見つけます。
ゲストをクリックします。ゲストプロファイルが表示されます。
ゲストプロファイルページで、Event viewerをクリックします。このゲストに関連付けられているイベントのリストが表示されます。このリストにはVIEWイベントが含まれています。これは、前の手順でトリガーされたイベントです。

次のステップ

これで、アプリとSitecore CDPが正常に統合されました。ブラウザIDを取得するためにHTTPリクエストを行いました。次に、ブラウザIDを使用してVIEWイベントを送信し、Sitecore CDPがユーザーに関するデータをリアルタイムでキャプチャすることを確認しました。

次に、次の操作を実行できます。

他の種類のイベント ( IDENTITYイベントなど) Sendします。
詳しくは、ブラウザIDについての記事をご覧ください。

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