ウィジェットイベント

ウィジェットクリックイベントの作成

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

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

訪問者がSitecore Searchウィジェットの任意の場所をクリックしたら、widget clickイベントを送信する必要があります。ほとんどのウィジェットのクリックはエンティティですが、カテゴリ、フィルター、またはナビゲーションボタンでもクリックできます。

メモ

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

エンティティのウィジェットクリック

訪問者がSitecore Searchウィジェット内のエンティティをクリックした場合は、action_causeキーをentityに設定してwidget clickイベントを送信します。

大事な

すべてのイベントに必要なデフォルトの属性に加えて、index,rfk_id属性、およびentities属性は、エンティティーのclickイベントにも必要です。entities配列には、クリックされたエンティティを表すオブジェクトが含まれ、少なくともid属性とentity_type属性が含まれている必要があります。

エンティティのwidget clickイベントの例を次に示します。

{
  "name": "widget",
  "action": "click",
  "action_cause": "entity",
  "uuid": "<uuid>",
  "client_time_ms": 1234,
  "page_load_time_ms": 1233,
  "request_id": "<Request ID from search/rec request>",
  "interaction_id": "<Interaction ID>",
  "value": {
    "rfk_id": "<Widget ID>",
    "context": <context object>,
    "request": {
       "keyword": "<kw>",
       "modified_keyword": "<>"
    },
    "index": 1,
    "entities": [
      {
        "id": "123",
        "entity_type": "content",
        "entity_subtype": "article",
        "attributes": {
           "author": "ABC"
        }
      }
    ]
  }
}

カテゴリをウィジェットでクリックする

訪問者がSitecoreウィジェットのカテゴリリンクをクリックした場合は、action_causeキーを "category"に設定してwidget clickイベントを送信します。

大事な

すべてのイベントに必要なデフォルトの属性に加えて、カテゴリのclickイベントには、click_text、click_uri、click_text_id、rfk_id、およびentities属性が必要です。entities配列には、クリックしたカテゴリを表すオブジェクトが含まれ、少なくともid属性とentity_type属性が含まれている必要があります。

以下は、カテゴリのwidget clickイベントの例です。

{
  "name": "widget",
  "action": "click",
  "action_cause": "category",
  "uuid": "<uuid>",
  "client_time_ms": 1234,
  "page_load_time_ms": 1233,
  "request_id": "<Request ID from search/rec request>",
  "interaction_id": "<Interaction ID>",
  "value": {
    "rfk_id": "<Widget ID>",
    "request": {
       "keyword": "<kw>",
       "modified_keyword": "<>"
    },
    "context":  <context object>,
    "click_text_id": "top-article", 
    "click_text": "Top Articles", 
    "click_uri": "http://test.com/top-articles",
    "index": "3",
    "entities": [
      {
        "id": "123",
        "entity_type": "category"
      }
    ]
  }
}

フィルターのウィジェットクリック

訪問者がSitecore Searchウィジェットのフィルターまたはファセットをクリックした場合は、action_causeキーを "filter"に設定してwidget clickイベントを送信します。

大事な

すべてのイベントに必要なデフォルトの属性に加えて、filters属性とrfk_id属性は、フィルターのclickイベントにも必要です。filters配列には、ユーザーが選択したフィルターを表すオブジェクトが含まれている必要があります。このオブジェクトには、少なくともname属性が含まれている必要があります。

フィルターでのwidget clickイベントの例を次に示します。

{
  "name": "widget",
  "action": "click",
  "action_cause": "filter",
  "uuid": "<uuid>",
  "client_time_ms": 1234,
  "page_load_time_ms": 1233,
  "interaction_id": "<Interaction ID>",
  "value": {
    "rfk_id": "<Widget ID>",
    "context":  <context object>,
    "request": {
       "keyword": "<kw>",
       "modified_keyword": "<>"
    },
    "index": 1,
    "filters": [
      {
        "name": "content-type",
        "value": ["article"],
        "value_position": [2],
        "facet_position": 3,
        "display_name": ["Article"],
        "title": "Content Type"
      }
    ]
  }
}

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