ライブイベント

仕組み

ライブイベントチャートには、すべてのデータソースおよびイベントフィードから送信されるイベントがリアルタイムで表示されます。チャート内の各バーの高さは、検出されたイベント数を示します。有効なイベント仕様がある場合、受信データの品質が色分けされたセグメントでチャートに表示されます。有効なイベントは緑、無効なイベントは赤、仕様がないイベントは青で表示されます。

ライブイベントを使用する

検証 > ライブイベントに移動して、ライブイベントにアクセスします。

チャートに表示するイベントは、データソースおよびイベントフィードのリストを使用して制御します。デフォルトでは、すべてのデータソースとすべてのイベントが選択されています。これらのメニューを変更するとチャートが更新され、選択した組み合わせのイベントアクティビティが表示されます。

イベントフィードで特定のイベントを選択すると、そのイベントのデータのみがチャートに表示されます。イベントフィードをすべてのイベントデータと比較するには、すべてのイベントと比較をクリックします。たとえば、特定の国または地域のイベントフィードを作成し、その国または地域のイベントフィードをすべてのイベントと比較できます。

トレースIDを使用する

トレースIDを使用すると、自分でトリガーしたイベント以外の受信イベントを除外できます。トレースIDは、特定のイベントだけがライブイベントチャートに表示されるように、イベントトラッキングコードへ挿入する一時的な一意の識別子です。詳細については、トレースについてを参照してください。

トレースを構成するには、次の手順を実行します。

1. トレースIDをクリックします。
   トレースオプションのモーダルが表示されます。
2. トレースを開始をクリックし、指示に従います。
3. 生成されたトレースIDをコピーし、続行をクリックします。
4. テストするページを新しいChromeブラウザウィンドウで開きます。
5. Tealium Tools > Traceを開き、トレースIDを入力します。

ライブイベントチャートには、トレース対象のセッション中にトリガーされたイベントのみが表示されます。同じ手順に従って、新しいトレースを開始することも、既存のトレースに再参加することもできます。

仕様ステータスでフィルタリングする

イベント仕様を定義している場合、ライブイベントには受信データの品質が表示されます。チャート内の各バーは、適用されたイベント仕様のステータスに従って分割されます。次のフィルターのオンとオフを切り替えて、チャートの表示を調整できます。

• 有効なイベント
  これらのイベントは、有効なイベント仕様の要件を満たしています。有効なイベントには、tealium_event属性の既知の値と、仕様で必須とされているすべての属性が含まれています。オプション属性がイベントに含まれていなくても、有効ステータスには影響しません。有効なイベントが多いほど良好です。件数が多いほど、実装環境から仕様どおりのデータが送信されていることを示します。
• 無効なイベント
  これらのイベントはイベント仕様に一致していますが、少なくとも1つの属性が欠落しているか、無効です。必須属性が欠落している場合やデータ型が正しくない場合、およびオプション属性が存在するもののデータ型が正しくない場合や、構成されたデータ値ルールを満たしていない場合は、いずれも無効なイベントになります。これらの問題は、イベントを送信している実装コードを修正するか、場合によってはイベント仕様を調整することで解決できます。
• 仕様なし
  これらのイベントには、一致するイベント仕様がありません。仕様なしのイベントには、tealium_event属性がないか、対応するイベント仕様がありません。

イベント仕様によってデータが除外されることはありません。イベントが無効であっても、システムはそのイベントを処理します。

イベントの詳細を表示する

チャート内のバーをクリックすると、受信データサンプルからイベントの詳細を表示できます。データサンプルは、チャートの各バーにつき10件のイベントに制限されています。イベントは主にtealium_event属性によって識別されます。この属性で検出された値が、イベント詳細の見出しに表示されます。tealium_eventに対応するイベント仕様がある場合、その仕様の要件に従って、イベントは有効、無効、または仕様なしとして表示されます。見出しには、イベントの送信元であるデータソースも表示されます。

たとえば、有効なcart_emptyイベントは次のように表示されます。

イベント属性の詳細は、ユニバーサル変数、JavaScriptページ変数、HTMLメタデータ、ファーストパーティCookie、クエリ文字列パラメータ、Tealium提供の各属性タイプに分類されています。

無効なcart_emptyイベントは、次のように表示されます。

詳細ビューでは、各属性の検証ステータスがインラインで強調表示され、必須属性の欠落や不正なデータ型など、各エラーの理由が表示されます。

不明な属性を定義する

不明な属性とは、受信イベントで検出されたものの、データ型（文字列、数値、ブール値など）を持つイベント属性としてアカウントにまだ作成されていない属性です。アカウントで属性を使用するには、事前にイベント属性として作成する必要があります。

イベント詳細ビューでは、不明な属性のデータ型列にUnknownと表示されます。

不明な属性は、次のようにクイック追加アクションを使用して、この画面から直接定義できます。

1. 不明な属性の横にあるその他のオプションアイコンをクリックし、クイック追加をクリックします。
2. データ型を選択します。
3. 定義をクリックします。

属性に新しいデータ型が表示されます。

イベント仕様を作成する

tealium_eventにカスタム値が構成されているイベントに関連付けられたイベント仕様がない場合、そのイベントはイベント詳細ビューでUnknownと表示されます。この場合、検出されたtealium_eventの値とイベントの属性に基づいて、イベント詳細ビューからカスタムイベント仕様を直接作成します。

ライブイベントからイベント仕様を作成する前に、不明な属性を定義することをお勧めします。詳細については、不明な属性を定義するを参照してください。

詳細については、イベント仕様を管理するを参照してください。