---
title: イベント仕様
description: イベント仕様は、受信データの品質を検証する方法です。
url: https://docs.tealium.com/ja/server-side/event-health/event-specs/
---
## 仕組み

イベント仕様（「イベントスペック」とも呼ばれます）は、イベントのための[データレイヤー](https://docs.tealium.com/an-introduction-to-the-data-layer/)を表します。イベント仕様により、[ライブイベントチャート](https://docs.tealium.com/about-live-events/)またはイベント仕様の詳細ビューを使用して、リアルタイムでイベントのデータ品質が検証されます。

イベント仕様には、以下の定義が含まれます：

* `tealium_event` 属性は、イベントの名前とそれに関連する仕様を表します。例えば、`tealium_event` 属性の値が `video_complete` の場合、システムは `video_complete` という名前のイベント仕様を探して、受信イベントをそれに対して検証します。これにより、目的と予想されるデータ構造に基づいてイベントを分類し、管理することができます。
* そのイベントに期待されるデータを説明する属性のリスト。属性は `video_id`、`video_length`、`video_platform` などの個々の情報です。これらの属性を定義することで、システムが受け取るべきデータの明確な期待を作り出します。これにより、チームはデータ構造を一貫して保持し、エラーを減らし、トラブルシューティングを簡素化するのに役立ちます。
* 期待されるデータタイプ、例えば文字列、数値、またはブール値。データタイプを定義することで、各属性が正しい種類の情報を含むようにします。これによりエラーが減少し、データの一貫性が向上し、異なるシステム間でイベントを検証し、処理することが容易になります。
* 有効なイベントに必要な属性かどうか。有効なイベントとみなされるためには、必要な属性がイベントに存在していなければなりません。これにより、重要な情報が常に含まれることが保証され、正確な分析と意思決定に不可欠です。

イベント仕様はデータをフィルタリングしません。イベントが無効であっても、システムはイベントを処理します。

### イベント仕様の例

例えば、`video_complete` イベントは以下の属性とデータを含みます：

```json
{
    "tealium_event"  : "video_complete", // イベントと仕様の名前
    "video_id"       : "xWlEk2i9r5Q",
    "video_length"   : 300,
    "video_name"     : "How to track videos in Tealium",
    "video_platform" : "YouTube",
}
```

この `video_complete` イベントのためのイベント仕様には、以下が含まれます：

![](https://docs.tealium.com/images/server-side/whiteui-eventspecifications-videocomplete.png)

* `tealium_event` 属性は、イベントを `video_complete` として識別します。
* **定義** テーブルは、イベントに関する文脈情報を提供し、必要な属性、それらの期待されるデータタイプ、および有効なイベントに必要かどうかを定義します。

### 利点

イベント仕様は、データ管理において二つの主要な利点を提供します：

* すべてのプラットフォームにわたってイベントの実装を標準化する。
* 受信イベントのデータ品質を評価する。

## イベント仕様の統計を表示

![](https://docs.tealium.com/images/server-side/event-health-table.png)

**イベントヘルス** ウィンドウは、すべてのイベント仕様の総統計を表示します。テーブルは、個々のイベント仕様の統計を示しています。期間を選択して、その期間の統計を表示することができます。

表示される統計は以下の通りです：

* **総ボリューム**  
選択した時間枠で受信したイベントの総数。
* **有効なイベント**  
アクティブなイベント仕様の要件を満たすイベントの数。これは、イベントが `tealium_event` 属性の既知の値を持ち、仕様から必要な属性をすべて持っていることを意味します。有効なイベントが多いほど、データ品質が良いことを意味します。これは、インストールが仕様で期待されるデータを送信していることを意味します。
* **無効なイベント**  
イベント仕様に一致するが、必要な属性がないイベントの数。これは、イベントが `tealium_event` 属性の既知の値を持っているが、必要な属性が欠けているか、属性が予期しない値を含んでいることを意味します。これらの問題は、イベントを送信しているインストールコードを修正するか、イベント仕様を調整することで解決できます。
* **仕様なし**  
一致するイベント仕様がないイベントの数。これは、イベントが `tealium_event` 属性を持っていないか、値に対応するイベント仕様がないことを意味します。

**定義されたイベント** テーブルは、すべての既存のイベント仕様とそれぞれのイベント仕様のこれらの統計をリストします。

## イベント仕様の詳細を表示

**定義されたイベント** テーブルの任意のイベント仕様をクリックして、その詳細を表示します。

イベント仕様に関する統計がページの上部に表示され、仕様に一致するイベントの総ボリューム、有効なイベントの割合、無効なイベントの割合が含まれます。

**定義** テーブルは、イベントに関する文脈情報を提供し、必要な属性、それらの期待されるデータタイプ、および有効なイベントに必要かどうかを定義します。

### コードサンプル

イベント仕様の詳細ウィンドウから、**コード** をクリックし、使用しているデータソースを選択して、このイベント仕様に使用する基本コードと例を表示します。

以下のコードサンプルは、`My iOS App` というデータソースの `video_complete` イベントのトラッキングコードを示しています：

![](https://docs.tealium.com/images/server-side/whiteui-eventstream-eventspecifications-viewcode.png)

## ライブイベントでのイベント仕様

イベント仕様が作成され、トラッキングコードが実装されると、ライブイベントチャートを使用してリアルタイムで受信イベントを表示し、そのデータ品質を評価します。

詳細については、[ライブイベント](https://docs.tealium.com/about-live-events/#event-specification-display-filters)を参照してください。