View a markdown version of this page

Server-side rastreamento com inserção de anúncios guiada pelo servidor (SGAI) - AWS Elemental MediaTailor
Como funciona o beaconing do lado do servidor sem sessãoRequisitos do jogadorComparação entre Stitched e SGAI

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á.

Server-side rastreamento com inserção de anúncios guiada pelo servidor (SGAI)

Quando você usa a inserção de anúncios guiada pelo servidor (SGAI), o rastreamento do lado do servidor usa um mecanismo de sinalização sem sessão que difere da abordagem de modo integrado descrita acima. Em vez de MediaTailor unir segmentos de anúncios ao manifesto de conteúdo (onde rastreia /v1/segment solicitações), o SGAI retorna referências de anúncios como playlists separadas em uma resposta da lista de ativos com metadados de beacon incorporados nos URIs do anúncio.

Como funciona o beaconing do lado do servidor sem sessão

As etapas a seguir descrevem como o beaconing do lado do servidor funciona para sessões do SGAI:

  1. Inicialização da sessão: o player solicita a playlist multivariante HLS com. aws.insertionMode=GUIDED Server-side o relatório é o padrão (nenhum aws.reportingMode parâmetro é necessário). Ao contrário do modo costurado, a resposta de inicialização da sessão não inclui a. trackingUrl

  2. Manifesto armazenável em cache: MediaTailor retorna um manifesto armazenável em cache contendo EXT-X-DATERANGE tags CLASS="com.apple.hls.interstitial" e X-ASSET-LIST atributos apontando para o endpoint da lista de ativos MediaTailor intersticiais.

  3. Lista de ativos com metadados de beacon: quando o jogador encontra uma pausa no anúncio, ele busca a lista de ativos. MediaTailorretorna uma resposta JSON em que cada URI do anúncio inclui metadados de beacon criptografados:

    {
  "ASSETS": [
    {
      "DURATION": 30.0,
      "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>"
    }
  ]
}

    Quando os relatórios do lado do servidor estão ativos, a resposta não inclui uma seção. TRACKING Os URIs do anúncio carregam todos os dados do beacon.

  4. Substituição da variável HLS: o player busca a playlist multivariante do anúncio. O manifesto do anúncio usa #EXT-X-DEFINE:QUERYPARAM diretivas para passar os parâmetros do beacon da string de consulta do URI para os URLs do segmento por meio da substituição da variável HLS:

    #EXTM3U
#EXT-X-DEFINE:QUERYPARAM="awsBeaconData"
#EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain"
#EXT-X-DEFINE:QUERYPARAM="awsConfigurationName"
#EXTINF:5.0,
{$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts

    O player resolve as {$awsConfigurationName} variáveis {$awsBeaconData}{$awsBeaconDomain}, e usando os valores da string de consulta do URI do manifesto do anúncio e, em seguida, solicita cada segmento do MediaTailor anúncio.

  5. Acionamento de farol na solicitação de segmento: à medida que o player solicita cada segmento de anúncio, a solicitação é encaminhada. MediaTailor O serviço decifra os dados do beacon, determina a posição do segmento no anúncio (impressão, primeiro quartil, ponto médio, terceiro quartil ou completo) e dispara o beacon de rastreamento VAST apropriado para o servidor de anúncios. MediaTailor em seguida, redireciona o player para o segmento real do conteúdo do anúncio.

Requisitos do jogador para sinalização SGAI do lado do servidor

Para usar o beaconing do lado do servidor com o SGAI, seu jogador deve atender aos seguintes requisitos:

  • HLS versão 11 ou posterior

  • Suporte para EXT-X-DATERANGE com CLASS atributo para intersticiais HLS

  • Suporte para substituição de #EXT-X-DEFINE:QUERYPARAM variáveis (RFC 8216bis). O player deve decodificar por cento os valores dos parâmetros de consulta antes de substituí-los em URLs de segmentos.

nota

Atualmente, o beaconing SGAI do lado do servidor é suportado somente para HLS. O DASH ainda não é suportado pelo beaconing SGAI do lado do servidor.

Comparação com o rastreamento do lado do servidor em modo integrado

A tabela a seguir resume como o rastreamento do lado do servidor difere entre a inserção de anúncios costurados e a inserção guiada pelo servidor:

Aspecto Costurado (SSAI) Server-guided (SAGI)
Capacidade de armazenamento em cache manifesta Per-session, não armazenável em cache Armazenável em cache, compartilhado entre os espectadores
Roteamento de segmentos de anúncios /v1/segment/Usando o ID da sessão Por meio do /v1/segment/ uso de um blob de dados de beacon criptografado
Estado da sessão para beacons Armazenado por sessão em MediaTailor Sem sessão — todo o estado é transportado no parâmetro criptografado awsBeaconData
URL de rastreamento no início da sessão Retornado na resposta de inicialização da sessão Não fornecidos — os dados do beacon são incorporados aos URIs do anúncio em cada resposta da lista de ativos
Suporte para DASH Compatível Sem suporte no momento
nota

Para sessões SGAI ao vivo, você pode ativar a pré-busca de anúncios baseada em manifestos usando. aws.guidedPrefetchMode=MANIFEST Isso é separado da API de pré-busca baseada em agendamento usada com sessões costuradas (SSAI). Para obter detalhes, consulte Pré-busca guiada com batimento cardíaco manifesto.