Criação de agendas de pré-busca - AWS Elemental MediaTailor
Determinar com que frequência seu cliente deve ligar para o CreatePrefetchSchedule API

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

Criação de agendas de pré-busca

O procedimento a seguir explica como criar uma agenda de pré-busca usando o MediaTailor console. Para obter informações sobre como criar e gerenciar agendamentos de pré-busca de forma programática usando o, consulte no MediaTailor API PrefetchSchedulesAWS Elemental MediaTailor APIReferência.

nota

Se você quiser usar critérios de correspondência de disponibilidade em uma programação, certifique-se de primeiro configurar o ADS URL modelo de configuração de reprodução com variáveis dinâmicas, caso contrário, os critérios de correspondência de disponibilidade não terão efeito. Para obter informações sobre como trabalhar com variáveis dinâmicas, consulte Etapa 3: configurar os parâmetros de ADS solicitação URL e consulta o tópico Introdução à inserção de MediaTailor anúncios.

Para criar uma nova agenda de pré-busca usando o console

  1. Abra o MediaTailor console em https://console.aws.amazon.com/mediatailor/.

  2. No painel de navegação, escolha Configurações. Selecione a configuração de reprodução para a qual você deseja criar uma agenda de pré-busca.

  3. Na guia Programações de pré-busca, escolha Adicionar agenda de pré-busca.

  4. No painel de detalhes do cronograma do Prefetch, faça o seguinte:

    • Em Nome, insira um identificador para sua agenda de pré-busca, como. my-prefetch-schedule

    • Em Stream ID, opcionalmente, insira um ID exclusivo. Se sua origem contiver vários streams de reprodução, você poderá usar esse ID para MediaTailor instruir a colocar anúncios em um stream específico. Por exemplo, se sua origem tem um stream de esportes e um stream de um programa de TV, você pode usar o ID do stream para criar agendas de pré-busca para inserir anúncios segmentados para o stream de esportes. Você passa o valor do ID do stream para a MediaTailor inicialização da sessão ou solicitação de manifesto do seu cliente. Para obter mais informações, consulte o exemplo a seguir.

      • Para rastreamento do lado do servidor, inclua o parâmetro e o valor da ?aws.streamId consulta na GET HTTP solicitação do seu cliente ao seu endpoint. MediaTailor Para obter informações gerais sobre o rastreamento do lado do servidor, consulte. Rastreamento de anúncios do lado do servidor Uma solicitação de manifesto para um HLS endpoint que inclui um ID de stream tem a seguinte aparência, onde myStreamId está o nome do seu ID de stream:

        GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

      • Para rastreamento do lado do cliente, inclua a streamId chave e o valor no corpo da solicitação de inicialização da POST HTTP sessão do seu cliente no endpoint /v1/sessão. MediaTailor Para obter informações gerais sobre o rastreamento do lado do cliente, consulte. Rastreamento de anúncios do lado do cliente Uma solicitação de inicialização de sessão que inclui um ID de stream tem a seguinte aparência, onde myStreamId está o nome do seu ID de stream:

        POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
{
    'streamId': 'myStreamId'
}
      Mostrar maisMostrar menos

  5. No painel Recuperação, especifique as configurações de recuperação que você deseja usar. Essas configurações determinam quando MediaTailor pré-busca anúncios do. ADS Eles também determinam quais variáveis dinâmicas devem ser incluídas na solicitação aoADS, se houver.

    • Em Hora de início, insira a hora em que MediaTailor você pode iniciar as recuperações prévias para esse intervalo publicitário. MediaTailor tentará pré-buscar anúncios para solicitações manifestas feitas por seu cliente em ou após esse período. O valor padrão é o horário atual. Se você não especificar um valor, o serviço iniciará a recuperação da pré-busca assim que possível.

    • Em Hora de término, insira a hora em que você MediaTailor deseja parar de pré-buscar anúncios para esse intervalo publicitário. MediaTailor tentará pré-buscar anúncios para solicitações de manifesto que ocorrerem nesse momento ou antes dele. A janela de recuperação pode se sobrepor à janela de consumo.

    • Na seção Variáveis dinâmicas, insira até 100 variáveis dinâmicas. MediaTailor usa essas variáveis para substituição em solicitações de pré-busca que ele envia para o. ADS Se você não inserir nenhuma variável dinâmica, MediaTailor faça o possível para interpolar os valores das variáveis dinâmicas contidas em seu. ADSURL

      • Selecione Adicionar variável dinâmica.

      • Em Chave, insira uma chave de variável dinâmica, comoscte.event_id. Você pode usar qualquer variável dinâmica que MediaTailor ofereça suporte. Para obter informações sobre variáveis dinâmicas, consulteUsando variáveis dinâmicas de anúncios em MediaTailor.

      • Em Valor, insira um valor de variável dinâmica, como my-event.

      • Para adicionar outra variável dinâmica, escolha Selecionar Adicionar variável dinâmica.

  6. No painel Consumo, especifique as configurações que você deseja usar para a janela de consumo. Essas configurações determinam quando MediaTailor os anúncios são colocados no intervalo publicitário. Eles também determinam qualquer critério de correspondência disponível que você queira usar.

    • Em Hora de início, insira a hora em que você MediaTailor deseja começar a colocar anúncios pré-buscados no intervalo publicitário. O valor padrão é a hora atual. Se você não especificar um horário, o serviço iniciará o consumo da pré-busca assim que possível.

    • Em Horário de término, insira um horário em que você MediaTailor deseja parar de colocar os anúncios pré-buscados no intervalo publicitário. MediaTailor tentará pré-buscar anúncios para as solicitações manifestas de seu cliente que ocorram nesse momento ou antes dele. A hora de término deve ser posterior à hora de início e em menos de um dia a partir de agora. A janela de consumo pode se sobrepor à janela de recuperação.

    • Na seção Critérios de correspondência de disponibilidade, selecione Adicionar critérios de disponibilidade e adicione quantos e cinco critérios de correspondência de disponibilidade à sua agenda. Em seguida, em Chave de variável dinâmica, adicione uma chave de variável dinâmica, comoscte.event_id. MediaTailor colocará os anúncios pré-buscados no intervalo publicitário somente se atenderem aos critérios definidos pelos valores das variáveis dinâmicas para MediaTailor as quais seu cliente passa ou que MediaTailor deduzem de informações como dados da sessão. Para obter informações, consulte a seção avail-matching-criteria anterior.

  7. Selecione Adicionar critérios de disponibilidade.

Os agendamentos de pré-busca expiram automaticamente após o término da janela de consumo. Para fins de diagnóstico, eles permanecem visíveis por pelo menos 7 dias, após os quais os excluem MediaTailor automaticamente. Como alternativa, você pode excluir manualmente uma agenda de pré-busca a qualquer momento. Para obter informações sobre como excluir manualmente uma agenda de pré-busca, consulte a seção a seguirExcluindo agendas de pré-busca.

Determinar com que frequência seu cliente deve ligar para o CreatePrefetchSchedule API

Seu cliente pode ligar programaticamente CreatePrefetchScheduleAPIuma vez por dia para configurar a recuperação e o consumo, se você souber exatamente quando ocorrerão os intervalos publicitários. Ou seu cliente pode ligar para eles API várias vezes ao longo do dia para definir a recuperação e o consumo. Ao escolher uma frequência de API chamadas, leve em consideração o número máximo MediaTailor de agendas ativas de pré-busca e a probabilidade de sua agenda de intervalos publicitários mudar depois de criar sua (s) agenda (s) de pré-busca. Se for provável que o cronograma de intervalos publicitários mude depois que você criar seus horários de pré-busca, convém ligar para eles com API mais frequência.