Exportar dados do stream da DAI em tempo real

Este é um recurso Alfa e pode não estar disponível para sua rede.

Nesta página

• Entrega de registros
• Registro de entrega do manifesto
• Registro de intervalos veiculados
  • Estrutura do registro de intervalos veiculados
    • Status dos anúncios
    • Status da inserção reserva
• Registro de interações do servidor de anúncios
   

Os registros em tempo real de inserção de anúncios dinâmicos (DAI) permitem exportar dados no nível da transmissão quase em tempo real para monitorar e resolver problemas de veiculação. Este artigo descreve as especificações de entrega de arquivos de registro, campos específicos e problemas conhecidos.

Entrega de registros

Os arquivos de registros são entregues a intervalos de armazenamento específicos do publisher no Google Cloud, aproximadamente a cada 5 minutos.

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

Dica: entre em contato com a equipe da sua conta para receber ajuda com o acesso ao bucket do Google Cloud Storage. Você precisará compartilhar um grupo no Google Workspace que sua empresa gerencia internamente ou designar um usuário da empresa que possa gerenciar um grupo fornecido para você.

Os nomes de arquivo têm o seguinte formato:

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

Em que:

• Log Type: é DAIAdServerInteraction ou DAIManifest ou DAIServedBreak
• Network Code: é o código de rede do Ad Manager
• Stream Type: é VOD, Linear ou PODSERVING
• Content ID: código da origem do conteúdo para VOD agrupado, PODSERVING para veiculação de pods de VOD, chave de recurso no caso de transmissões ao vivo
• YYMMDD, HHMMSS: horário de geração do registro em UTC
• Random Number: número aleatório

Os arquivos são compactados em formato gzip e contêm dados como valores entre aspas duplas e separados por vírgula em conformidade com o RFC4180. Com relação à Seção 2, ponto 5 da RFC4180, que afirma que "Cada campo pode ou não ser colocado entre aspas duplas", observe que todos os dados nos arquivos de registro estão entre aspas duplas.

Os arquivos permanecem no intervalo por sete dias e depois são removidos.

Observação: os campos podem mudar com as novas versões. O cliente sempre precisa analisar os arquivos CSV com base no cabeçalho, caso novos campos sejam adicionados ou campos antigos sejam removidos.

Registro de entrega do manifesto

Este registro tem informações sobre a entrega de stream de vídeo. Os seguintes campos estão presentes:

Campo**	Descrição
timestamp INTEGER	Carimbo de data/hora UTC da solicitação (no horário Unix)
entry_id STRING	ID exclusivo da entrada de registro No momento, há uma limitação no nosso sistema que faz com que uma entrada de registro apareça mais de uma vez. Esse ID pode ser usado para desduplicar entradas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do SAM)
network_code INTEGER	Código da rede do publisher
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	Código da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave de recurso da transmissão ao vivo
custom_asset_key STRING	Chave de recurso da transmissão ao vivo definida pelo publisher
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 solicitação: 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 beacon de anúncio para a transmissão: BEACONING_TYPE_SERVER_TRIGGERED: lado do servidor BEACONING_TYPE_CLIENT_TRIGGERED: lado do cliente (SDK do IMA) BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED: lado do cliente (API DAI e SDK do IMA em um futuro próximo)
http_method STRING	Método usado na solicitação HTTP
user_agent STRING	User agent do dispositivo
response_code INTEGER	Código de resposta HTTP
response_time DOUBLE	Latência da solicitação (em segundos)

Registro de intervalos veiculados

Esse registro tem informações sobre intervalos de anúncios veiculados para clientes da DAI. Consulte Estrutura do registro de intervalo de anúncio veiculado para mais detalhes e exemplos de como as informações são apresentadas no registro.

Campo**	Descrição
timestamp INTEGER	Carimbo de data/hora UTC da solicitação (no horário Unix)
entry_id STRING	ID exclusivo da entrada de registro No momento, há uma limitação no nosso sistema que faz com que uma entrada de registro apareça mais de uma vez. Esse ID pode ser usado para desduplicar entradas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do SAM)
network_code STRING	Código de rede do publisher
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	Código da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave de recurso da transmissão ao vivo
custom_asset_key STRING	Chave de recurso da transmissão ao vivo definida pelo publisher
break_id STRING	ID do intervalo de anúncio veiculado Para VOD, será um ID de intervalo de VMAP. Por exemplo: "preroll-1", "midroll-2" Para o recurso "Ao vivo", esse será um número de intervalo sequencial atribuído a esse intervalo pela DAI. Exemplo: "0000000001", "0000000024"
expected_break_duration DOUBLE	A duração dos anúncios solicitados pela DAI com base no tempo que ela esperava que o intervalo durasse.
actual_break_duration DOUBLE	A duração que a DAI preencheu no conteúdo. É a duração total dos anúncios, da inserção reserva e da DAI do conteúdo subjacente preenchida no intervalo de anúncio.
ads_duration DOUBLE	A duração da mídia do intervalo de anúncio. Para VOD, também marca a duração real do intervalo de anúncio.
slate_duration DOUBLE	A duração da mídia de inserção reserva no intervalo de anúncio.
ads_status STRING	O status da inserção de anúncios no intervalo. Consulte Estrutura do registro de intervalo veiculado para mais detalhes.
slate_status STRING	O status da inserção reserva no intervalo de anúncio. Consulte Estrutura do registro de intervalo veiculado para ver mais detalhes.
complete BOOLEANO	Indica se o conjunto de anúncios foi concluído. Para streams HLS, isso significa que a DAI inseriu um marcador de ponto de início para sinalizar o fim do conjunto de anúncios. Para streams DASH, isso significa que o período de anúncio está concluído.

Estrutura do registro de intervalos veiculados

Os registros de intervalos veiculados da DAI têm informações sobre como ela veicula intervalos de anúncios para os clientes. As tabelas Status dos anúncios e Status da inserção reserva a seguir apresentam informações de registros de DAI em diferentes cenários de agrupamento de anúncios. Saiba mais sobre os registros de intervalos veiculados para transmissões ao vivo.

Status dos anúncios

Confira abaixo uma lista de status de anúncios e o que eles indicam.

Status dos anúncios	Descrição
ADS_STATUS_INSERTED	A inserção do anúncio foi bem-sucedida.
ADS_STATUS_DROPPED_UNKNOWN	O conjunto de anúncios foi descartado por um motivo desconhecido.
ADS_STATUS_ALL_ADS_MISSING	O conjunto de anúncios foi descartado porque todos os anúncios no conjunto estavam ausentes.
ADS_STATUS_TOO_MANY_MIDROLLS	O conjunto de anúncios foi descartado porque mais conjuntos de anúncios intermediários foram retornados pelo servidor de anúncios do que intervalos de anúncios para inserção.
ADS_STATUS_OUT_OF_WINDOW	O intervalo de anúncio está parcialmente ou totalmente fora da janela de agrupamento no momento da solicitação e tem o conteúdo subjacente agrupado em vez dos anúncios.
ADS_STATUS_DISABLED	Os anúncios foram desativados para esta transmissão.
ADS_STATUS_DROPPED_FOR_PREROLL	Este conjunto de anúncios intermediários foi descartado devido a um intervalo de anúncio precedente em andamento.
ADS_STATUS_EXPIRED	O conjunto de anúncios expirou porque a solicitação de anúncio não foi concluída a tempo para ser agrupada ao conteúdo.
ADS_STATUS_HOLIDAY	O conjunto de anúncios foi descartado devido a um intervalo de anúncio em andamento.
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE	Os anúncios foram descartados devido a um erro que ocorreu com a inserção reserva. Consulte o status da inserção reserva.
ADS_STATUS_INTERNAL_ERROR	A DAI encontrou um erro ao solicitar ou agrupar anúncios.
ADS_STATUS_INVALID_POD_REQUEST	O conjunto de anúncios foi descartado devido a uma solicitação inválida.
ADS_STATUS_DROPPED_FOR_MIDROLL	O intervalo de anúncio precedente solicitado se sobrepõe a um intervalo de anúncio intermediário.
ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION	É necessário muito conteúdo para preencher o conjunto de anúncios (não há anúncios suficientes veiculados).
ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT	A duração do intervalo foi muito curta para solicitar anúncios.
ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK	A transmissão foi criada depois que o intervalo de anúncio terminou.
ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE	As informações sobre o stream de conteúdo necessárias para juntar os anúncios estão ausentes ou indisponíveis.
ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE	Nenhum anúncio estava disponível antes do prazo da solicitação.

Status de slate

Confira abaixo uma lista dos status de inserção e o que eles indicam.

Status de slate	Descrição
SLATE_STATUS_INSERTED	A inserção reserva foi inserida.
SLATE_STATUS_SKIPPED	A inserção reserva foi ignorada devido à configuração do evento de transmissão ao vivo (desativado, pular em branco).
SLATE_STATUS_DROPPED_UNKNOWN	A inserção reserva não foi inserida neste intervalo de anúncio por motivos desconhecidos.
SLATE_STATUS_MINIMUM_INSERTED	O restante do intervalo de anúncio foi agrupado com o conteúdo subjacente, com uma pequena quantidade de inserção para preencher a lacuna entre os anúncios e o conteúdo.
SLATE_STATUS_INTERNAL_ERROR	A inserção não foi inserida neste intervalo de anúncio devido a um erro interno.

Registro de interações do servidor de anúncios

Esse registro tem informações sobre interações com um servidor de anúncios para receber anúncios. Consulte Estrutura do registro de interações do servidor de anúncios para ver mais detalhes e exemplos de como as informações são apresentadas no registro.

Campo**	Descrição
timestamp INTEGER	Carimbo de data/hora UTC da solicitação (no horário Unix)
entry_id STRING	ID exclusivo da entrada de registro No momento, há uma limitação no nosso sistema que faz com que uma entrada de registro apareça mais de uma vez. Esse ID pode ser usado para desduplicar entradas.
stream_id STRING	ID exclusivo atribuído a cada stream (também conhecido como ID do SAM)
network_code INTEGER	Código de rede do Ad Manager
dai_type STRING	Tipo de DAI: DAI_TYPE_STITCHED DAI_TYPE_PODSERVING
content STRING	Código da origem do conteúdo
vid STRING	ID do vídeo
asset_key STRING	Chave de recurso da transmissão ao vivo
custom_asset_key STRING	Chave de recurso da transmissão ao vivo definida pelo publisher
pod_id INTEGER	ID do intervalo de anúncio: Para VOD, é o ID do intervalo do VMAP. Para transmissões ao vivo, é o número sequencial do intervalo
ad_server_host_name STRING	Nome de domínio do servidor de anúncios
response_time DOUBLE	Latência da solicitação (em segundos)
response_type STRING	Tipo de resposta: VAST VMAP UNKNOWN: definido quando uma resposta inválida é recebida ou quando a resposta atinge o tempo limite.
response_code INTEGER	Código de resposta HTTP
row_type STRING	Tipo de entrada de arquivo de registro: PRIMARY_REQUEST AD_POD WRAPPER INLINE Consulte o exemplo de resposta VMAP que inclui cada tipo de arquivo de registro.
vast_error_code STRING	Código do erro de VAST
prefetch_stage STRING	Fase de pré-busca (se estiver ativada)
ad_position STRING	Posição do anúncio decidido no conjunto de anúncios O valor dos anúncios selecionados começa em 1 Este campo está vazio para anúncios de buffet não utilizados e anúncios descontinuados
ad_id STRING	ID de publicidade *
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 criativo do anúncio *
universal_ad_id_registry STRING	Registro do ID universal do anúncio *
universal_ad_id_value STRING	Valor do ID universal do anúncio *
creative_duration DOUBLE	Duração do criativo
mezzanine_uri STRING	URI do mezanino * Tudo no URI tem escape, exceto os caracteres especificados como não reservados no RFC3986.
media_uri STRING	Este é o primeiro elemento encontrado no nó MediaFiles * Tudo no URI tem escape, exceto os caracteres especificados como não reservados no RFC3986.
break_start_uri STRING	O elemento de rastreamento usado para acompanhar o início de um intervalo de anúncio. Esses dados são provenientes da resposta VMAP. Tudo no URI tem escape, exceto os caracteres especificados como não reservados no RFC3986.
google_video_id STRING	Identificador exclusivo de um criativo associado a esse anúncio.

  * Esses valores são do VAST

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