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

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

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

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

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

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

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

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

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

ブラウザIDをSitecore Personalize

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

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

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

プレースホルダーの値を、Sitecore Personalizeインスタンスの必要な詳細に置き換えます。
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 Personalizeに対して行う後続のすべてのリクエストに含めます。

初めての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 Personalizeに送信するすべてのイベントには、ブラウザIDが含まれている必要があります。

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

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

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 Personalizeに送信されます。

Sitecore PersonalizeがVIEWイベントをキャプチャしたことを確認します

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

Sitecore PersonalizeがVIEWイベントをキャプチャしたことを確認するには:

Sitecore PersonalizeでDeveloper center > Event viewerをクリックし、検索ドロップダウンで「Browser ID」を選択し、コピーしたテキストを検索フィールドに貼り付けます。このゲストに関連付けられているイベントのリストが表示されます。このリストにはVIEWイベントが含まれています。これは、前の手順でトリガーされたイベントです。

メモ

Sitecore CDPとSitecore Personalizeの両方がある場合は、Guestsでデータを見つけることができます。

次のステップ

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

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

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

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