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

イベントオブジェクトへのコンテキストの追加

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

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

コンテキストオブジェクト は、Sitecore SearchイベントAPIに送信されるすべてのイベントに必要です。Sitecore Searchは、コンテキストオブジェクトを使用して、サイトを訪問する訪問者、訪問者の場所、訪問者が訪問しているページ、および使用しているデバイスに関する追加情報を記述します。

以下に、contextオブジェクトで送信する必要がある必須オブジェクトを示します。

大事な

これらのオブジェクトは、イベントを正しくログに記録するために、すべてのcontext objectに含める必要があります。

  • browser - browserオブジェクトは、ブラウザーユーザーエージェント(browser.user_agent)または訪問者がサイトにアクセスしているデバイスのタイプ(browser.device)と一緒に含める必要があります。

    メモ

    browser.user_agentが含まれており、業界の慣習に正しく従っている場合、browser.deviceとbrowser.app_typeが自動的に検出されます。

  • geo - geoオブジェクトは、訪問者のIPアドレス (geo.ip) または訪問者の国 (geo.country) と州 (geo.state) のいずれかと一緒に含める必要があります。

    手記

    geo.ipが指定されている場合、Sitecore SearchはIPアドレスを使用して、訪問者の国、州、都市、郵便番号を自動的に決定します。

以下は、イベント内のcontextオブジェクトの例です。

手記

イベント オブジェクト データ モデルについては、イベントAPIリファレンスを参照してください。

{
  "action": "<event action>",
  "name": "<event name>",
  "value": {
    "entities": [
      {
        "attributes": {
          "author": "<Author of entity>"
          },
        "entity_subtype": "article/blog",
        "entity_type": "content, product",
        "id": "<External unique identifier for the entity>",
        "uri": "<URI of the entity>"
        }
      ],
    "context": {
      "browser": {
        "user_agent": "Mozilla/5.0 (iPhone14,6; U; CPU iPhone OS 15_4 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/19E241 Safari/602.1"
      },
      "geo": {
        "ip": "10.x.x.x"
      },
      "page": {
        "locale_language": "en",
        "locale_country": "us",
        "locale_currency": "usd"
      },
      "user": {
        "cuid": "user-1234",
        "email": "[email protected]",
        "eid": "<hash_of_email>",
        "fbid": "<facebook_id>",
        "address": {
          "address_line_1": "123 Main Street",
          "address_line_2": "apartment 123",
          "state": "CA",
          "zip": "90210",
          "country": "USA"
        }
      }
    }
  }
}
この記事を改善するための提案がある場合は、 お知らせください!