ウィジェットイベント

ウィジェット・ビュー・イベントの作成

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

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

訪問者がページ上のウィジェットを表示したときにwidget viewイベントを送信する必要があります。分析が正しく記録されるようにするには、ウィジェットが訪問者のビューポートにある場合にのみ、このイベントを送信する必要があります。これは、訪問者が実際にウィジェットを見るのに十分なほど下にスクロールしていないときに、widget viewイベントを誤って報告しないようにするためです。

大事な

すべてのイベントに必要なデフォルトの属性に加えて、entities属性とrfk_id属性はwidget viewイベントに必要です。

ウィジェットには複数のエンティティを含めることができ、ウィジェットを表示すると、ユーザーは推奨されるすべてのコンテンツ (エンティティ) を表示できます。このため、widget viewイベントにはentities属性を含める必要があります。この属性の値は、推奨されるすべてのエンティティを表すオブジェクトの配列です。これらのオブジェクトを含めることで、ビューによるエンティティの適切な帰属が保証されます。

widget viewイベントの例を次に示します。

メモ

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

{
  "name": "widget",
  "action": "view",
  "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": "<>",
      "num_results": 20,
      "total_results": 50,
      "num_requested": 100,
      "page_size": 20
    },
    "entities": [
      {
        "id": "123",
        "entity_type": "content",
        "entity_subtype": "article",
        "attributes": {
           "author": "ABC"
        }
     },
     {
        "id": "124",
        "entity_type": "content",
        "entity_subtype": "article",
        "attributes": {
           "author": "ABC"
        }
     },
     {
        "id": "125",
        "entity_type": "content",
        "entity_subtype": "article",
        "attributes": {
           "author": "ABC"
        }
     }
    ]
   }
}

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