翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# EICM ペイロード: コンテキストメタデータエンリッチメント
<a name="scte35-enrichment-eicm"></a>

`EICM` (Elemental Inference Contextual Metadata) 機能ペイロードには、ダウンストリームコンシューマーが広告決定時にコンテキストメタデータを AWS Elemental Inference にクエリする必要がある情報が含まれています。

チャネルでこの機能を有効にする方法については、「」を参照してください[コンテキストメタデータエンリッチメント](elemental-inference-cm-enrichment.md)。

このペイロードは、9 バイトの AWSE エンベロープヘッダー (スキーマバージョン 1 の場合) に従います。エンベロープ`feature_id`の は です`"EICM"`。エンベロープ構造[AWSE UPID エンベロープ](awse-scte35-format.md#scte35-enrichment-awse-envelope)については、「」を参照してください。

## EICM バージョン 1 ペイロード
<a name="scte35-enrichment-eicm-v1"></a>

EICM ペイロードは、ペイロード構造バージョンを識別する`feature_version`バイトで始まります。バージョン 1 (`feature_version = 0x01`) の場合、残りのフィールドには、Elemental Inference フィード識別子、`GetMetadata`クエリのデータプレーン URL、キューアウトに対応するコンディショナータイムラインの PTS が含まれます。

フィールドは表示された順序で表示されます。


| フィールド | サイズ | 型 | 説明 | 
| --- | --- | --- | --- | 
| feature\_version | 1 バイト | uint8 | EICM ペイロード構造のバージョンを識別します。現在、 0x01 のみが有効です。バージョン 1 のフィールドは、このテーブルの残りの行で説明されています。この値を変更すると、残りのフィールドの構造的な変更が示されます。 | 
| feed\_id\_length | 1 バイト | uint8 | feed\_id フィールドの長さ N。 | 
| feed\_id | N バイト | ASCII | Elemental Inference フィード識別子 (NUL ターミネーターなし）。 | 
| inference\_query\_url\_length | 1 バイト | uint8 | inference\_query\_url フィールドの長さ M。 | 
| inference\_query\_url | M バイト | ASCII | GetMetadata クエリの Elemental Inference データプレーン URL (NUL ターミネーターなし、末尾のスラッシュなし）。 | 
| inference\_query\_pts | 8 バイト | int64 BE | Elemental Inference コンディショナータイムラインのキューアウトの PTS。 | 
| inference\_query\_timescale | 4 バイト | uint32 BE | のタイムベース inference\_query\_pts (90000 など）。 | 

EICM v1 ペイロードの合計サイズは`15 + N + M`バイトです。この合計には、1 バイトバージョンフィールド 1 つ、1 バイト長フィールド 2 つ、可変長文字列 2 つ、8 バイト PTS フィールド 1 つ、4 バイトのタイムスケールフィールド 1 つが含まれます。9 バイトのエンベロープヘッダー (スキーマバージョン 1 の場合) と組み合わせると、完全な `segmentation_upid_length`は です`24 + N + M`。

**重要**  
`inference_query_pts` および の`inference_query_timescale`値は、出力で使用する PTS 形式とは異なる場合があります。ダウンストリームシステムは、これらの値を Elemental Inference `GetMetadata` API のクエリにのみ使用する必要があります。

## ダウンストリームの使用状況
<a name="scte35-enrichment-eicm-usage"></a>

広告決定システム ( など AWS Elemental MediaTailor) などのダウンストリームコンシューマーは、EICM ペイロードを解析し、 フィールドを使用して Elemental Inference をクエリします。

1. `segmentation_type_id = 0x01` と、 が である UPID `segmentation_descriptor`を持つ を見つけ`format_identifier`ます`"AWSE"`。

1. `feature_id = "EICM"` と を検証します`feature_version = 0x01`。

1. `feed_id`、`inference_query_url`、`inference_query_pts`、および を抽出します`inference_query_timescale`。

1. 抽出された URL で Elemental Inference `GetMetadata` API を呼び出し、フィード ID と PTS 値を渡します。