View a markdown version of this page

Carga útil do EICM: enriquecimento de metadados contextuais - MediaLive
Carga útil EICM versão 1Uso a jusante

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Carga útil do EICM: enriquecimento de metadados contextuais

A carga útil do recurso EICM (Elemental Inference Contextual Metadata) carrega as informações que os consumidores posteriores precisam para consultar o AWS Elemental Inference para obter metadados contextuais no momento da decisão de compra.

Para obter informações sobre como ativar esse recurso em seu canal, consulteEnriquecimento de metadados contextuais.

Essa carga segue o cabeçalho do envelope AWSE de 9 bytes (para a versão 1 do esquema). O que feature_id está no envelope é"EICM". Veja Envelope AWSE UPID a estrutura do envelope.

Carga útil EICM versão 1

A carga útil do EICM começa com um feature_version byte que identifica a versão da estrutura da carga útil. Para a versão 1 (feature_version = 0x01), os campos restantes contêm o identificador do feed de inferência elementar, a URL do plano de dados para GetMetadata consultas e o PTS na linha do tempo do condicionador correspondente à sugestão.

Os campos aparecem na ordem mostrada.

Campo Tamanho Tipo Description
feature_version 1 byte uint8 Identifica a versão da estrutura de carga útil do EICM. Atualmente, somente 0x01 é válido; os campos da versão 1 estão descritos nas linhas restantes desta tabela. Uma alteração nesse valor indicaria uma mudança estrutural nos campos restantes.
feed_id_length 1 byte uint8 Comprimento N do feed_id campo.
feed_id N bytes ASCII O identificador do feed de inferência elementar (sem terminador NUL).
inference_query_url_length 1 byte uint8 Comprimento M do inference_query_url campo.
inference_query_url M bytes ASCII O URL do plano de dados do Elemental Inference para GetMetadata consultas (sem terminador NUL, sem barra final).
inference_query_pts 8 bytes int64 BE O PTS da sugestão na linha do tempo do condicionador Elemental Inference.
inference_query_timescale 4 bytes uint32 BE A base de tempo de inference_query_pts (por exemplo, 90000).

O tamanho total da carga útil do EICM v1 é de bytes. 15 + N + M Esse total inclui um campo de versão de 1 byte, dois campos de comprimento de 1 byte, duas cadeias de caracteres de comprimento variável, um campo PTS de 8 bytes e um campo de escala de tempo de 4 bytes. Combinado com o cabeçalho do envelope de 9 bytes (para a versão 1 do esquema), o completo é. segmentation_upid_length 24 + N + M

Importante

Os inference_query_timescale valores inference_query_pts e podem ser diferentes do formato PTS que sua saída usa. Os sistemas downstream devem usar esses valores somente para consultar a API Elemental InferenceGetMetadata.

Uso a jusante

Consumidores posteriores, como sistemas de decisão publicitária (por exemplo, AWS Elemental MediaTailor), analisam a carga útil do EICM e usam os campos para consultar a inferência elementar:

  1. Localize o segmentation_descriptor com segmentation_type_id = 0x01 e um UPID cujo format_identifier é"AWSE".

  2. Verifique feature_id = "EICM" feature_version = 0x01 e.

  3. Extrair feed_id inference_query_urlinference_query_pts,, inference_query_timescale e.

  4. Chame a GetMetadata API Elemental Inference no URL extraído, passando o ID do feed e o valor PTS.