1. イベントAPIを使用してイベントを追跡する

イベントAPIの呼び出し

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

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

Sitecore Searchは、イベントAPIのHTTPSプロトコルをサポートしています。APIは、JSONオブジェクトの形式でリクエストを受け入れます。

API URLと方法

パーソナライズされたイベントAPI URLSearchは、API AccessタブのDeveloper Resourcesセクションにあります。

URLは、https://discover.sitecorecloud.io/event/<ckey>/v4/publishの構造を使用して作成されます。 ckeyは、アカウントIDとドメインIDの組み合わせであるカスタマー キーで、次の形式で <accountID>-<domainID>です。

イベントAPIはPOSTメソッドのみをサポートします。

認証

リクエストと一緒にAPIキー を渡す必要があります。

必要なキー

次の表に、イベントAPIに必要なキーを示します。

鍵

種類

形容

data

JSON文字列

イベントオブジェクトを表すJSON。

例

以下は、イベントAPIへのPOST requestの例です。

POST /event/{ckey}/v4/publish
{
 "data": "{<event object>}"
}

以下は、イベント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"
        }
      ]
    }
}'
この記事を改善するための提案がある場合は、 お知らせください!