イベントAPIの呼び出し
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore SearchイベントAPIのHTTPSプロトコルをサポートしています。APIはJSONオブジェクトの形でリクエストを受け付けます。
API URLと方法
SearchのDeveloper ResourcesセクションのAPI Accessタブで、あなたのパーソナライズされたイベントAPI URLを見つけることができます。
URLは以下の構造で作成されます: https://discover.sitecorecloud.io/event/
Events APIはPOSTメソッドのみをサポートしています。
認証
リクエストと一緒にAPIキー を渡す必要があります。
必要な鍵
以下の表は、Events APIに必要なキーを示しています:
キー
種類
概要
data
JSON 文字列
イベントオブジェクトを表すJSONです。
例
以下はEvents APIへのPOST requestの例です:
POST /event/{ckey}/v4/publish
{
"data": "{
以下はEvents APIへの ページビューイベント リクエストの例です:
curl --location --request POST 'https://discover.sitecorecloud.io/event/17595242-159871555/v4/publish' \ --header 'Content-Type: text/plain' \ --header 'Authorization: 01-847028a3-e6593de0a4fd3183cec60650f855982ca00c2720' \ --data-raw '{ "name": "entity_page", "action": "view", "client_time_ms": 1660088972963, "user_id": "j4y9f17bqqlrqtl36uqfadfadfadf", "value": { "context": { "geo": { "ip": "18.233.241.14" }, "browser": { "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36" }, "page": { "uri": "https://www.sitecore.com/products/content-cloud" } }, "entities": { "id": "https___www_sitecore_com_products_content-cloud", "uri": "https://www.sitecore.com/products/content-cloud", "entity_type": "content" }
} }'