Exporte dados de streams DAI em tempo real

Esta é uma funcionalidade alfa e pode não estar disponível para a sua rede.

Nesta página

• Envio de registos
• Registo de envio do manifesto
• Registo de pausas publicadas
  • Estrutura do registo de pausas publicadas
    • Estado dos anúncios
    • Estado da faixa
• Registo de interação do servidor de anúncios
   

Os registos em tempo real da Inserção de anúncios dinâmicos (DAI) permitem-lhe exportar dados ao nível da stream quase em tempo real para monitorizar e resolver problemas de publicação. Este artigo descreve as especificações do envio de ficheiros de registo, campos específicos e problemas conhecidos.

Envio de registos

Os ficheiros de registo são enviados para contentores de armazenamento específicos do publicador no Google Cloud, aproximadamente a cada 5 minutos.

O nome do contentor é: gs://gdai-[NETWORK_CODE]

Dica: pode contactar a equipa da conta para ter ajuda com o acesso ao contentor do Google Cloud Storage. Prepare-se para partilhar um grupo no Google Workspace gerido internamente pela sua empresa ou designar um utilizador na empresa que possa gerir um grupo fornecido para si.

Os nomes dos ficheiros estão no seguinte formato:

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

Onde:

• Log Type: DAIAdServerInteraction ou DAIManifest ou DAIServedBreak
• Network Code: código de rede do Ad Manager
• Stream Type: VOD ou Linear
• Content ID: ID da origem do conteúdo para VOD, chave do recurso para streams em direto
• YYMMDD, HHMMSS: hora de geração do registo em UTC
• Random Number: número aleatório

Os ficheiros são comprimidos com o gzip e contêm dados como valores separados por vírgulas com aspas duplas, em conformidade com a norma RFC4180. Relativamente à secção 2, ponto 5 da norma RFC4180, que indica que "Cada campo pode ou não estar entre aspas duplas", tenha em atenção que todos os dados nos ficheiros de registo estão entre aspas duplas.

Os ficheiros permanecem no contentor durante 7 dias, após os quais são removidos.

Nota: os campos podem mudar com novos lançamentos. O cliente deve analisar sempre os ficheiros CSV com base no respetivo cabeçalho, para o caso de serem adicionados novos campos ou de serem removidos campos antigos.

Registo de envio do manifesto

Este registo fornece informações sobre o envio de streams de vídeo. Os seguintes campos estão presentes:

Campo**	Descrição
timestamp INTEGER	Data/hora em UTC do pedido (em tempo Unix)
entry_id STRING	ID exclusivo da entrada do registo O nosso sistema tem uma limitação atual que permite que uma entrada do registo possa aparecer mais do que uma vez. Este ID pode ser usado para remover as entradas duplicadas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do MAS)
network_code INTEGER	Código de rede do publicador
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
conteúdo INTEGER	ID da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave do recurso da stream em direto
custom_asset_key STRING	Chave do recurso da stream em direto definida pelo publicador
manifest_type STRING	Tipo de manifesto de vídeo: MANIFEST_TYPE_HLS MANIFEST_TYPE_DASH
stream_type STRING	Tipo de stream: STREAM_TYPE_VOD STREAM_TYPE_LINEAR
request_type STRING	Tipo de pedido: REQUEST_TYPE_STREAM_CREATE REQUEST_TYPE_MASTER_PLAYLIST REQUEST_TYPE_MEDIA_PLAYLIST REQUEST_TYPE_MPD REQUEST_TYPE_SUBTITLES REQUEST_TYPE_INTERSTITIALS REQUEST_TYPE_IFRAME_PLAYLIST REQUEST_TYPE_AD_METADATA (ID3 events) REQUEST_TYPE_SEGMENT_REDIRECT REQUEST_TYPE_POD_ASSET_LIST REQUEST_TYPE_POD_MULTIVARIANT REQUEST_TYPE_POD_VARIANT REQUEST_TYPE_POD_MPD REQUEST_TYPE_POD_TIMING_METADATA
beaconing_type STRING	Tipo de utilização de beacons de anúncios da stream: BEACONING_TYPE_SERVER_TRIGGERED: do lado do servidor BEACONING_TYPE_CLIENT_TRIGGERED: do lado do cliente (SDK IMA) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: do lado do cliente (API DAI e SDK IMA num futuro próximo)
http_method STRING	Método usado no pedido HTTP
user_agent STRING	Agente do utilizador do dispositivo
response_code INTEGER	Código de resposta HTTP
response_time DOUBLE	Latência do pedido (em segundos)

Registo de pausas publicadas

Este registo disponibiliza informações sobre as pausas para anúncios publicadas para clientes de DAI. Consulte a secção Estrutura do registo de pausas publicadas para ver mais detalhes e exemplos da apresentação das informações no registo. 

Campo**	Descrição
timestamp INTEGER	Data/hora em UTC do pedido (em tempo Unix)
entry_id STRING	ID exclusivo da entrada do registo O nosso sistema tem uma limitação atual que permite que uma entrada do registo possa aparecer mais do que uma vez. Este ID pode ser usado para remover as entradas duplicadas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do MAS)
network_code STRING	Código de rede do publicador
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
conteúdo INTEGER	ID da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave do recurso da stream em direto
custom_asset_key STRING	Chave do recurso da stream em direto definida pelo publicador
break_id STRING	ID desta pausa para anúncios publicada Para VOD, este é um ID da pausa de VMAP. Por exemplo: "preroll-1", "midroll-2" Para streams em direto, é um número de pausa sequencial atribuído a esta pausa pela DAI. Por exemplo: "0000000001" e "0000000024"
expected_break_duration DOUBLE	A duração para a qual a DAI pediu anúncios com base na duração da pausa prevista pela DAI.
actual_break_duration DOUBLE	A duração que a DAI preencheu no conteúdo. É a duração somada dos anúncios, da faixa e do conteúdo subjacente preenchido pela DAI na pausa para anúncios.
ads_duration DOUBLE	A duração do conteúdo multimédia do anúncio na pausa para anúncios. Para VOD, também marca a duração real da pausa para anúncios.
slate_duration DOUBLE	A duração do conteúdo multimédia da faixa na pausa para anúncios.
ads_status STRING	O estado da inserção de anúncios na pausa para anúncios. Consulte a secção Estrutura do registo de pausas publicadas para ver mais detalhes.
slate_status STRING	O estado da inserção de faixas na pausa para anúncios. Consulte a secção Estrutura do registo de pausas publicadas para ver mais detalhes.
concluído BOOLEAN	Se o agrupamento de anúncios foi concluído. Para streams HLS, isto significa que a DAI foi inserida num marcador cue-in para indicar o fim do agrupamento de anúncios. Para streams DASH, isto significa que o período de anúncios está encerrado.

Estrutura do registo de pausas publicadas

Os registos de pausas publicadas pela DAI disponibilizam informações sobre a forma como a DAI publica pausas para anúncios para os clientes. As tabelas Estado dos anúncios e Estado da faixa seguintes apresentam informações dos registos da DAI em diferentes cenários de união de anúncios. Saiba mais sobre os registos de pausas publicadas para streams em direto.

Estado dos anúncios

Segue-se uma lista dos estados dos anúncios e o que indicam.

Estado dos anúncios	Descrição
ADS_STATUS_INSERTED	O anúncio foi inserido com êxito.
ADS_STATUS_DROPPED_UNKNOWN	O agrupamento de anúncios foi ignorado por um motivo desconhecido.
ADS_STATUS_ALL_ADS_MISSING	O agrupamento de anúncios foi ignorado porque todos os anúncios no agrupamento estavam em falta.
ADS_STATUS_TOO_MANY_MIDROLLS	O agrupamento de anúncios foi ignorado porque o servidor de anúncios devolveu mais agrupamentos de inserção intercalar do que pausas para anúncios para os inserir.
ADS_STATUS_OUT_OF_WINDOW	A pausa para anúncios está parcial ou totalmente fora da janela de união no momento do pedido e vai ter conteúdo subjacente unido em vez de anúncios.
ADS_STATUS_DISABLED	Os anúncios foram desativados para esta stream.
ADS_STATUS_DROPPED_FOR_PREROLL	Este agrupamento de anúncios de inserção intercalar foi ignorado devido a uma pausa para anúncios de inserção inicial em curso.
ADS_STATUS_EXPIRED	O agrupamento de anúncios expirou porque o pedido de anúncio não terminou a tempo de ser unido ao conteúdo.
ADS_STATUS_HOLIDAY	O agrupamento de anúncios foi ignorado devido a uma pausa de anúncios em curso.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Os anúncios foram ignorados devido a um erro que ocorreu com a faixa. Consulte o estado da faixa.
ADS_STATUS_INTERNAL_ERROR	A DAI encontrou um erro ao pedir ou unir anúncios.
ADS_STATUS_INVALID_POD_REQUEST	O agrupamento de anúncios foi ignorado devido a um pedido de agrupamento inválido.
ADS_STATUS_DROPPED_FOR_MIDROLL	A pausa de inserção inicial pedida sobrepõe-se a uma pausa para anúncios de inserção intercalar.
ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION	É necessário demasiado conteúdo de espaçador do agrupamento de anúncios (não foram publicados anúncios suficientes).
ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT	A duração da pausa para anúncios foi demasiado curta para pedir anúncios.
ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK	A stream foi criada após o fim da pausa para anúncios.
ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE	As informações sobre a stream de conteúdo necessárias para unir os anúncios estão em falta ou não estão disponíveis.
ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE	Não estavam disponíveis anúncios antes do prazo do pedido.

Estado da faixa

Segue-se uma lista dos estados das faixas e o que indicam.

Estado da faixa	Descrição
SLATE_STATUS_INSERTED	A faixa foi inserida com êxito.
SLATE_STATUS_SKIPPED	A inserção da faixa foi ignorada devido à configuração do evento de stream em direto (desativado, ignorar se estiver vazio).
SLATE_STATUS_DROPPED_UNKNOWN	A faixa não foi inserida nesta pausa para anúncios devido a motivos desconhecidos.
SLATE_STATUS_MINIMUM_INSERTED	O resto da pausa para anúncios foi unido ao conteúdo subjacente, com uma pequena quantidade de faixa para fazer a ligação entre os anúncios e o conteúdo.
SLATE_STATUS_INTERNAL_ERROR	A faixa não foi inserida nesta pausa para anúncios devido a um erro interno.

Registo de interação do servidor de anúncios

Este registo disponibiliza informações sobre as interações com um servidor de anúncios para obter anúncios. Consulte o artigo Estrutura dos registos de interações do servidor de anúncios para ver mais detalhes e exemplos da apresentação das informações no registo.

Campo**	Descrição
timestamp INTEGER	Data/hora em UTC do pedido (em tempo Unix)
entry_id STRING	ID exclusivo da entrada do registo O nosso sistema tem uma limitação atual que permite que uma entrada do registo possa aparecer mais do que uma vez. Este ID pode ser usado para remover as entradas duplicadas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do MAS)
network_code INTEGER	Código de rede do Ad Manager
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
conteúdo INTEGER	ID da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave do recurso da stream em direto
custom_asset_key STRING	Chave do recurso da stream em direto definida pelo publicador
pod_id INTEGER	ID da pausa para anúncios: Para VOD, trata-se do ID da pausa do VMAP Para streams em direto, é o número de pausa sequencial
ad_server_host_name STRING	Nome de domínio do servidor de anúncios
response_time DOUBLE	Latência do pedido (em segundos)
response_type STRING	Tipo de resposta: VAST VMAP UNKNOWN: definido quando é recebida uma resposta inválida ou a resposta excede o tempo limite
response_code INTEGER	Código da resposta HTTP
row_type STRING	Tipo de entrada do ficheiro de registo: PRIMARY_REQUEST AD_POD WRAPPER INLINE Consulte o exemplo de resposta VMAP que inclui cada tipo de ficheiro de registo.
vast_error_code STRING	Código de erro VAST
prefetch_stage STRING	Fase de obtenção prévia (se esta estiver ativada)
ad_position STRING	Posição do anúncio com tomada de decisão no agrupamento de anúncios O valor dos anúncios selecionados começa em 1 Este campo está vazio para anúncios do buffet de anúncios não usados e anúncios ignorados
ad_id STRING	ID do anúncio*
ad_system STRING	Sistema de anúncios*
ad_title STRING	Título do anúncio*
creative_id STRING	ID do criativo*
creative_ad_id STRING	ID do anúncio do criativo*
universal_ad_id_registry STRING	Registo do ID do anúncio universal*
universal_ad_id_value STRING	Valor do ID do anúncio universal*
creative_duration DOUBLE	Duração do criativo
mezzanine_uri STRING	URI de mezzanine * Tudo no URI é interpretado de forma literal, exceto os carateres especificados como não reservados no RFC3986.
media_uri STRING	Este é o primeiro elemento encontrado no nó MediaFiles* Tudo no URI é interpretado de forma literal, exceto os carateres especificados como não reservados no RFC3986.
break_start_uri STRING	O elemento de acompanhamento usado para acompanhar o início de uma pausa para anúncios. Estes dados são provenientes da resposta VMAP. Tudo no URI é interpretado de forma literal, exceto os carateres especificados como não reservados no RFC3986.
google_video_id STRING	Identificador único de um criativo associado a este anúncio.

  * Estes valores são do VAST

** Quando não forem aplicáveis a uma linha específica, alguns campos podem ser deixados em branco