

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

# Pré-busca de anúncios
<a name="prefetching-ads"></a>

Use a pré-busca de AWS Elemental MediaTailor anúncios para transmissões ao vivo para ajudar a reduzir o pico de carga nos servidores de decisão de anúncios (ADS) e diminuir a latência de entrega do manifesto no início de cada intervalo de anúncio. Quando você define um cronograma de busca prévia, MediaTailor segue o cronograma para recuperar anúncios do ADS e prepará-los para a inserção de anúncios antes que sejam necessários para um intervalo publicitário. Durante as transmissões ao vivo, a busca prévia pode ajudar a reduzir as taxas de preenchimento de anúncios e a perda de oportunidades de monetização devido a solicitações de anúncios, tempos limite de transcodificação ou outros atrasos na rede. 

**nota**  
A busca prévia de anúncios não funciona com métodos de inserção de anúncios guiados pelo servidor (SGAI), incluindo os tradicionais intersticiais guiados pelo servidor e HLS. Os métodos SGAI não exigem busca prévia porque os jogadores buscam apenas os anúncios que vão jogar, e os manifestos podem ser veiculados CDNs sem MediaTailor ver solicitações de sessão individuais.

Para configurar a pré-busca de anúncios, você cria uma ou mais *agendas de pré-busca* na sua configuração de reprodução. Um cronograma de pré-busca MediaTailor informa como e quando recuperar e preparar anúncios para um próximo intervalo publicitário. 
+ Se um evento tiver anúncios disponíveis em um cronograma previsível, use um *único cronograma de pré-busca*. Cada agenda de pré-busca define um único conjunto de anúncios MediaTailor para colocar em um único anúncio disponível. Para pré-buscar anúncios para vários anúncios disponíveis ao usar agendas de pré-busca únicas, você deve criar várias agendas de pré-busca (até 24 horas antes da disponibilidade do anúncio) que se correlacionem com cada disponibilidade do anúncio. 
+ Se um evento tiver anúncios disponíveis que não estejam em um cronograma previsível, use um cronograma de *pré-busca recorrente*. Uma agenda de pré-busca recorrente cria automaticamente uma agenda e pré-busca anúncios antes de cada intervalo publicitário em um evento. A programação recorrente de pré-busca recupera anúncios para cada anúncio disponível em um período de tempo definido (até 24 horas antes do término do evento). Você não precisa criar um cronograma para cada anúncio disponível, mas perde parte do controle de tempo que a pré-busca única oferece.

Os tópicos a seguir descrevem mais sobre a busca prévia de anúncios.

**Topics**
+ [Como funciona a pré-busca](understanding-prefetching.md)
+ [Criação de agendas de pré-busca](creating-prefetch-schedules.md)
+ [Modelagem de tráfego baseada em TPS](tps-traffic-shaping.md)
+ [Excluindo agendas de pré-busca](deleting-prefetch-schedules.md)

# Como funciona a pré-busca
<a name="understanding-prefetching"></a>

Quando seu cliente faz uma solicitação manifesta para MediaTailor, o serviço avalia todos os agendamentos de pré-busca associados à configuração de reprodução. Se MediaTailor não encontrar um cronograma de pré-busca correspondente, o serviço reverte para a inserção normal de anúncios e não faz a pré-busca de anúncios.

Se MediaTailor encontrar um cronograma de pré-busca correspondente, o serviço avalia o cronograma com base em dois componentes: recuperação e consumo. A configuração de cada componente varia entre agendamentos de pré-busca únicos e agendamentos de pré-busca recorrentes, conforme descrito nas seções a seguir.

## Fluxo único de agendamento de pré-busca
<a name="understanding-prefetching-single"></a>

**Recuperação**  
Isso define a *janela de recuperação*, que é o intervalo de tempo em que MediaTailor pré-busca anúncios do ADS. Certifique-se de programar essa janela para um horário que seja antes do intervalo publicitário. A seguir, é apresentada uma visão geral de como MediaTailor processa um único cronograma de pré-busca.  
Para ver as etapas para criar uma única agenda de pré-busca no console, consulte. [Criação de agendas de pré-busca](creating-prefetch-schedules.md) Para obter instruções sobre a API, consulte [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)a *Referência AWS Elemental MediaTailor da API*.  
Durante a *janela de recuperação* especificada, MediaTailor envia solicitações ao ADS para recuperar e preparar anúncios para inserção posterior nas sessões de reprodução.  
+ MediaTailor opcionalmente, usa modelagem de tráfego para limitar o número de solicitações ao ADS ao mesmo tempo. Você pode escolher entre duas abordagens:

  *Modelagem de tráfego com janela de tempo* - MediaTailor distribui as solicitações pelo número especificado de segundos em vez de enviar solicitações para todas as sessões ao mesmo tempo. Essa distribuição dispersa de tráfego ajuda a evitar que o ADS fique sobrecarregado, resultando em tempos limite e baixas taxas de preenchimento de anúncios.

  *Modelagem de tráfego baseada em TPS* - MediaTailor limita as solicitações com base em transações por segundo (TPS) e usuários simultâneos. Essa abordagem fornece uma configuração mais intuitiva com base nos limites de capacidade do ADS. Para obter mais informações, consulte [Modelagem de tráfego baseada em TPS](tps-traffic-shaping.md).
+ Se você configurar *variáveis dinâmicas*, MediaTailor inclua essas variáveis nas solicitações ao ADS. MediaTailor usa essas variáveis para combinar e aproveita para pré-buscar programações durante a janela de consumo. Consulte a seção *Consumo* a seguir para obter mais informações.

**Example**  
Um evento ao vivo dura das 7h45 às 10h, com um intervalo publicitário às 8h15. Você configura MediaTailor para recuperar anúncios das 7h45 às 8h, com uma janela de modelagem de tráfego de 60 segundos. Com 500.000 usuários simultâneos, MediaTailor distribui as solicitações do ADS para atingir uma taxa média de aproximadamente 8.333 transações por segundo por 60 segundos (500.000 usuários/60 segundos = 8.333 solicitações por segundo), em vez de enviar todas as solicitações simultaneamente.   
A configuração de recuperação inclui a chave `scte.event` e o valor `1234` da variável dinâmica. MediaTailor inclui essa variável nas solicitações para o ADS, que então pode ser usada para direcionar anunciantes específicos para a ID de evento 1234. 

**Consumo**  
Quando MediaTailor encontra os marcadores de quebra de anúncio SCTE-35 durante a janela de consumo, ele coloca os anúncios pré-buscados em um intervalo publicitário.  
+ Se você não definiu critérios de correspondência de disponibilidade, MediaTailor insere anúncios na primeira pausa na janela de consumo.
+ Se você definiu uma *chave de variável dinâmica* para *aproveitar* *os *critérios* de correspondência*, MediaTailor avalia esses critérios em relação às variáveis dinâmicas definidas na janela de recuperação. Um intervalo publicitário é elegível para inserção de anúncios pré-buscados somente se os critérios de correspondência de disponibilidade forem atendidos. MediaTailor insere anúncios no primeiro intervalo que atendam aos critérios.

  Para obter uma lista dos critérios de correspondência disponível compatíveis, consulte a coluna *Disponível para pré-busca de anúncios* na tabela em. [MediaTailor variáveis de sessão para solicitações de ADS](variables-session.md)

**Example contínuo**  
Você define a hora de início do consumo como 8h15 e a hora de término como 8h17. Você inclui `scte.event_id` a chave nos critérios de correspondência disponíveis.   
Para cada intervalo publicitário que MediaTailor acontece das 8h15 às 8h17, ele avalia o ID do SCTE evento para cada intervalo publicitário. Em cada sessão de reprodução, MediaTailor insere os anúncios pré-buscados no primeiro intervalo publicitário que tem uma ID de evento de 1234 (conforme definido nas variáveis dinâmicas de recuperação). Para intervalos publicitários que não contêm o ID de evento correto, MediaTailor realiza a inserção de anúncios padrão. 

## Fluxo recorrente do cronograma de pré-busca
<a name="understanding-prefetching-recurring"></a>

**Recuperação**  
Isso define a *janela de recuperação recorrente*, que é o intervalo de tempo em que MediaTailor pré-busca e insere anúncios para um evento ao vivo (até 24 horas). A seguir, é apresentada uma visão geral de como MediaTailor processa agendamentos de pré-busca recorrentes.  
Para ver as etapas para criar uma agenda de pré-busca recorrente no console, consulte. [Criação de agendas de pré-busca](creating-prefetch-schedules.md) Para obter instruções sobre a API, consulte [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)a *Referência AWS Elemental MediaTailor da API*.  
Durante a janela de pré-busca recorrente especificada, MediaTailor recupera e insere anúncios de um evento ao vivo de até 24 horas. Depois de cada intervalo publicitário na janela, recupera MediaTailor automaticamente os anúncios para o próximo intervalo publicitário.   
+ Se você definir o *atraso após o término da disponibilidade*, MediaTailor aguarda o tempo especificado antes de recuperar o próximo conjunto de anúncios para o próximo intervalo publicitário.
+ MediaTailor opcionalmente, usa modelagem de tráfego para limitar o número de solicitações ao ADS ao mesmo tempo. Você pode escolher entre duas abordagens:

  *Modelagem de tráfego com janela de tempo* - MediaTailor distribui as solicitações pelo número especificado de segundos em vez de enviar solicitações para todas as sessões ao mesmo tempo. Essa distribuição dispersa de tráfego ajuda a evitar que o ADS fique sobrecarregado, resultando em tempos limite e baixas taxas de preenchimento de anúncios.

  *Modelagem de tráfego baseada em TPS* - MediaTailor limita as solicitações com base em transações por segundo (TPS) e usuários simultâneos. Essa abordagem fornece uma configuração mais intuitiva com base nos limites de capacidade do ADS. Para obter mais informações, consulte [Modelagem de tráfego baseada em TPS](tps-traffic-shaping.md).
+ Se você configurar *variáveis dinâmicas*, MediaTailor inclua essas variáveis nas solicitações ao ADS. MediaTailor usa essas variáveis para combinar e aproveita para pré-buscar programações durante a janela de consumo. Consulte a seção *Consumo* a seguir para obter mais informações.

**Example**  
Um evento ao vivo dura das 19h às 20h45, com quatro intervalos publicitários durante esse período. Os intervalos publicitários não estão em um cronograma previsível. Você configura a pré-busca recorrente das 19h às 20h45, com um atraso de 10 minutos e uma janela de modelagem de tráfego de 60 segundos. Depois de cada disponibilidade, MediaTailor recupera os anúncios para o próximo intervalo publicitário. Dez minutos após o término da disponibilidade, MediaTailor começa a enviar solicitações de recuperação para o ADS. Com uma janela de modelagem de tráfego de 60 segundos e 500.000 usuários simultâneos, MediaTailor distribui as solicitações do ADS para atingir uma taxa média de aproximadamente 8.333 transações por segundo durante 60 segundos (500.000 usuários/60 segundos = 8.333 solicitações por segundo), em vez de enviar todas as solicitações simultaneamente.   
A configuração de recuperação inclui a chave `scte.event` e o valor `1234` da variável dinâmica. MediaTailor inclui essa variável nas solicitações para o ADS, que então pode ser usada para direcionar anunciantes específicos para a ID de evento 1234.

**Consumo**  
Quando MediaTailor encontra os marcadores de quebra de anúncio SCTE-35, ele coloca os anúncios pré-buscados em um intervalo de anúncio.  
+ Se você definir a *expiração do anúncio recuperado*, os anúncios pré-buscados estarão disponíveis para inserção até a expiração especificada.
+ Se você não definiu critérios de correspondência de disponibilidade, MediaTailor insere anúncios na primeira pausa na janela de consumo.
+ Se você definiu uma *chave de variável dinâmica* para *aproveitar* *os *critérios* de correspondência*, MediaTailor avalia esses critérios em relação às variáveis dinâmicas definidas na janela de recuperação. Um intervalo publicitário é elegível para inserção de anúncios pré-buscados somente se os critérios de correspondência de disponibilidade forem atendidos. MediaTailor insere anúncios no primeiro intervalo que atendam aos critérios.

  Para obter uma lista dos critérios de correspondência disponível compatíveis, consulte a coluna *Disponível para pré-busca de anúncios* na tabela em. [MediaTailor variáveis de sessão para solicitações de ADS](variables-session.md)

**Example contínuo**  
No consumo, você inclui `scte.event_id` a chave nos critérios de correspondência disponíveis.   
Para cada intervalo publicitário encontrado MediaTailor , ele avalia o ID do SCTE evento para cada intervalo publicitário. Em cada sessão de reprodução, MediaTailor insere os anúncios pré-buscados em cada intervalo de anúncio que tem uma ID de evento de 1234 (conforme definido nas variáveis dinâmicas de recuperação). Para intervalos publicitários que não contêm o ID de evento correto, MediaTailor realiza a inserção de anúncios padrão.   
Você define a expiração do anúncio em 2.700 segundos para que os anúncios recuperados fiquem disponíveis para inserção por 45 minutos.
O gráfico a seguir ilustra o exemplo, com os pequenos quadrados representando intervalos publicitários. As configurações recorrentes do cronograma de pré-busca são ilustradas ao longo da linha do tempo do evento.  

![\[Ilustração gráfica de um evento ao vivo, incluindo configurações recorrentes do cronograma de pré-busca.\]](http://docs.aws.amazon.com/pt_br/mediatailor/latest/ug/images/recurring_prefetch_timeline.png)


## Entendendo os custos de pré-busca
<a name="billing"></a>

Não há custos para fazer solicitações de recuperação de anúncios. No entanto, para a recuperação de anúncios pré-buscados, você será cobrado de acordo com a taxa de transcodificação padrão dos anúncios pré-buscados que transcodificam. MediaTailor Para o consumo de anúncios pré-buscados, você será cobrado pela taxa padrão pela inserção de anúncios para os anúncios pré-buscados colocados em intervalos publicitários. MediaTailor [Para obter informações sobre os custos de transcodificação e inserção de anúncios, consulte Preços.AWS Elemental MediaTailor](https://aws.amazon.com/mediatailor/pricing/)

# Criação de agendas de pré-busca
<a name="creating-prefetch-schedules"></a>

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 programaticamente usando a MediaTailor API, consulte [PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)a Referência da API.AWS Elemental MediaTailor *

**nota**  
Ao configurar agendamentos de pré-busca MediaTailor, é importante entender como os diferentes tipos de variáveis são tratados.  

**Aproveite os critérios de correspondência**  
Se você quiser usar os critérios de correspondência de disponibilidade em uma programação, primeiro configure o modelo de URL do ADS da configuração de reprodução com [variáveis de sessão dinâmicas](variables-session.md), 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 de sessão, consulte [Etapa 3: Configurar o URL de solicitação do ADS e os parâmetros de consulta](getting-started-ad-insertion.md#getting-started-configure-request) o tópico Introdução à inserção de MediaTailor anúncios.

**Variáveis do jogador em agendas de pré-busca**  
Ao criar um cronograma de pré-busca, não defina as variáveis do player como variáveis dinâmicas na sua configuração de pré-busca. Em vez disso, passe as variáveis do player como faria normalmente no início da sessão. MediaTailor incluirá automaticamente essas variáveis em solicitações de anúncios pré-buscadas se as variáveis forem mapeadas na URL do modelo do ADS.

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

1. Abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

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

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

1. 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 configuração de reprodução tiver um stream de esportes e um stream de um programa de TV, você poderá 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. [MediaTailor Rastreamento e relatórios de anúncios do lado do servidor](ad-reporting-server-side.md) Uma solicitação de manifesto para um endpoint HLS 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 até o endpoint. **MediaTailor/v1/session** Para obter informações gerais sobre o rastreamento do lado do cliente, consulte. [Rastreamento de anúncios do lado do cliente](ad-reporting-client-side.md) 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',
           'reportingMode': 'client'
       }
       ```

1. Para o **tipo de busca prévia**, faça sua seleção e escolha a seção correspondente para obter ajuda com campos adicionais:
   + Escolha **Único** se você estiver criando um cronograma de pré-busca para um intervalo publicitário em um evento.
   + Escolha **Recorrente** se você estiver criando uma programação que pré-busca anúncios automaticamente antes de cada intervalo publicitário em um evento. 

## Cronograma único de pré-busca
<a name="single-prefetch"></a>

Para criar uma programação que pré-busque anúncios antes que um anúncio seja disponibilizado em um evento.

1. 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 de sessão devem ser incluídas na solicitação ao ADS, 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.
   + Opcionalmente, configure a modelagem de tráfego para limitar o número de solicitações ao ADS ao mesmo tempo. Escolha uma das seguintes abordagens:

     *Abordagem de janela de tempo*: para a **duração da janela de modelagem de tráfego**, insira o número de segundos que MediaTailor devem distribuir as solicitações ao ADS. Para obter mais informações, consulte Explicação da [recuperação do cronograma de pré-busca única](understanding-prefetching.md#avail-matching-criteria-retr).

     *Abordagem baseada em TPS*: configure usuários **simultâneos de **pico de TPS** e pico para limitar as solicitações com base nas transações por segundo e nos usuários simultâneos**. Para obter mais informações, consulte [Modelagem de tráfego baseada em TPS](tps-traffic-shaping.md).
   + Na seção [**Variáveis dinâmicas**](variables.md), insira até 100 variáveis de sessão dinâmica. MediaTailor usa essas variáveis para substituição em solicitações de pré-busca enviadas ao ADS. Se você não inserir nenhuma variável dinâmica de sessão, MediaTailor faça o possível para interpolar os valores das variáveis dinâmicas contidas em seu URL do [ADS](configurations-create.md#configurations-create-main).
     + Selecione **Adicionar variável dinâmica**. 
     + Em **Chave**, insira uma chave variável de sessão dinâmica, como`scte.event_id`. Você pode usar qualquer variável dinâmica que MediaTailor ofereça suporte. Para obter informações sobre variáveis dinâmicas de sessão, consulte[MediaTailor variáveis de sessão para solicitações de ADS](variables-session.md).
     + 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**. 

1. 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**](variables.md), 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, como`scte.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. Se um intervalo publicitário não atender aos critérios de correspondência especificados, MediaTailor ignora a busca prévia desse intervalo. Para obter informações, consulte a explicação do [consumo do cronograma de pré-busca única](understanding-prefetching.md#avail-matching-criteria).

1. 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 seguir[Excluindo agendas de pré-busca](deleting-prefetch-schedules.md).

### Determinar com que frequência seu cliente deve chamar a CreatePrefetchSchedule API
<a name="how-often"></a>

Seu cliente pode chamar programaticamente a [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html)API uma 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 chamar a API várias vezes ao longo do dia para definir a recuperação e o consumo. Ao escolher a frequência de chamadas da API, leve em consideração o [número máximo de agendas de pré-busca ativas](quotas.md#prefetch-schedules-limit) e a probabilidade de sua agenda de intervalos publicitários mudar depois de criar suas agendas de pré-busca. Se for provável que o cronograma de intervalos publicitários mude depois que você criar seus agendamentos de pré-busca, convém chamar a API com mais frequência.

## Cronograma de pré-busca recorrente
<a name="recurring-prefetch"></a>

Para criar uma programação que pré-busque anúncios antes de cada anúncio ser disponibilizado em um evento.

1. No painel **Recuperação recorrente**, 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 de sessão devem ser incluídas na solicitação ao ADS, se houver.
   + Em **Janela de pré-busca recorrente**, insira a hora em que MediaTailor você pode iniciar as recuperações de pré-busca 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 **Atraso após o término** da disponibilidade, insira o número de segundos que MediaTailor devem esperar após o término de uma disponibilidade antes de pré-buscar anúncios para a próxima disponibilidade. Se você não especificar um valor, o MediaTailor padrão é sem atraso. 
   + Opcionalmente, configure a modelagem de tráfego para limitar o número de solicitações ao ADS ao mesmo tempo. Escolha uma das seguintes abordagens:

     *Abordagem de janela de tempo*: para a **duração da janela de modelagem de tráfego**, insira o número de segundos que MediaTailor devem distribuir as solicitações ao ADS. Para obter mais informações, consulte Explicação da recuperação do cronograma de [pré-busca recorrente](understanding-prefetching.md#avail-matching-criteria-recurring-retr)

     *Abordagem baseada em TPS*: configure usuários **simultâneos de **pico de TPS** e pico para limitar as solicitações com base nas transações por segundo e nos usuários simultâneos**. Para obter mais informações, consulte [Modelagem de tráfego baseada em TPS](tps-traffic-shaping.md).
   + Na seção [**Variáveis dinâmicas**](variables.md), insira até 100 variáveis de sessão dinâmica. MediaTailor usa essas variáveis para substituição em solicitações de pré-busca enviadas ao ADS. Se você não inserir nenhuma variável dinâmica de sessão, MediaTailor faça o possível para interpolar os valores das variáveis dinâmicas contidas em seu URL do [ADS](configurations-create.md#configurations-create-main).
     + Selecione **Adicionar variável dinâmica**. 
     + Em **Chave**, insira uma chave variável de sessão dinâmica, como`scte.event_id`. Você pode usar qualquer variável dinâmica que MediaTailor ofereça suporte. Para obter informações sobre variáveis dinâmicas de sessão, consulte[MediaTailor variáveis de sessão para solicitações de ADS](variables-session.md).
     + 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**. 

1. 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 **Expiração do anúncio recuperado**, indique quanto tempo após a recuperação os anúncios estarão disponíveis para inserção.
   + Na seção [**Critérios de correspondência de disponibilidade**](variables.md), 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, como`scte.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. Se um intervalo publicitário não atender aos critérios de correspondência especificados, MediaTailor ignora a busca prévia desse intervalo. Para obter informações, consulte a explicação do [consumo do cronograma de pré-busca recorrente](understanding-prefetching.md#avail-matching-criteria-recur).

1. 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 seguir[Excluindo agendas de pré-busca](deleting-prefetch-schedules.md).

# Modelagem de tráfego baseada em TPS
<a name="tps-traffic-shaping"></a>

AWS Elemental MediaTailor fornece duas abordagens opcionais de modelagem de tráfego para limitar o número de solicitações ao ADS ao mesmo tempo. A modelagem de tráfego baseada em TPS oferece uma alternativa à modelagem de tráfego baseada em janela de tempo para agendas de pré-busca. Essa abordagem fornece uma configuração mais intuitiva, permitindo que você especifique a capacidade do servidor de decisão de anúncios (ADS) em termos de transações por segundo (TPS) e de usuários simultâneos esperados, em vez de cálculos de tempo.

## Como funciona a modelagem de tráfego baseada em TPS
<a name="tps-how-it-works"></a>

Em vez de especificar as durações da janela de recuperação, você fornece os seguintes parâmetros:

Pico de TPS  
O número máximo de solicitações por segundo que seu ADS pode processar. Esse parâmetro não tem valor padrão.

Pico de usuários simultâneos  
O número máximo esperado de espectadores simultâneos para seu conteúdo. Esse parâmetro não tem valor padrão.

MediaTailor distribui automaticamente as solicitações de pré-busca ao longo do tempo para permanecer dentro do limite de TPS especificado, independentemente do número de sessões simultâneas.

**Example Exemplo de configuração baseada em TPS**  
Seu ADS pode lidar com 500 TPS e você espera 100.000 espectadores simultâneos durante os horários de pico. Você configura:  
+ Pico de TPS: 500
+ Pico de usuários simultâneos: 100.000
MediaTailor distribui automaticamente as solicitações de pré-busca ao longo do tempo para permanecer dentro do limite de TPS especificado, independentemente do número de sessões simultâneas.

# Excluindo agendas de pré-busca
<a name="deleting-prefetch-schedules"></a>

O procedimento a seguir explica como excluir uma agenda de pré-busca usando o MediaTailor console. *Para obter informações sobre como excluir agendamentos de pré-busca programaticamente usando a MediaTailor API, consulte [DeletePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePrefetchSchedule.html)a Referência da API.AWS Elemental MediaTailor *

**nota**  
A exclusão não ocorre em tempo real. Você pode enfrentar um atraso ao MediaTailor excluir os agendamentos de pré-busca, período durante o qual a recuperação e o consumo da pré-busca continuarão sendo executados em segundo plano.

**Para excluir uma agenda de pré-busca usando o console**

1. Abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. No painel de navegação, escolha **Configurações**. Selecione a configuração de reprodução que contém os agendamentos de pré-busca que você deseja excluir.

1. Na guia Agendas de **pré-busca, selecione a agenda** de pré-busca que você deseja excluir. Em seguida, selecione **Excluir**.