View a markdown version of this page

Criando e gerenciando funções - AWS Elemental MediaTailor
Configurando uma funçãoGerenciar funçõesRemovendo uma funçãoRegras de validaçãoReferência de 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á.

Criando e gerenciando funções

Esta página explica como criar, anexar, atualizar e excluir funções usando o MediaTailor console. As funções permitem que você personalize o comportamento da sessão e as solicitações de anúncios executando a lógica em pontos-chave durante a reprodução.

Configurando uma função

Criação de uma função usando o console

  1. Abra o console do MediaTailor.

  2. Selecione Funções no painel de navegação.

  3. Escolha a opção Criar função.

  4. Em ID da função, insira um nome exclusivo para a função (por exemplo,fetchIdentity).

  5. Em Tipo de função CUSTOM_OUTPUT, escolhaHTTP_REQUEST,VAST_REQUEST,SEQUENTIAL_EXECUTOR, ouCONCURRENT_EXECUTOR. O console exibe os campos de configuração para o tipo selecionado.

  6. Preencha os campos de configuração específicos do tipo. Para obter uma descrição de cada tipo de função e seus campos, consulteTipos de funções e composição.

  7. Escolha a opção Criar função.

Anexando uma função a uma configuração de reprodução

Uma função não é executada até que você a anexe a uma configuração de reprodução por meio de um mapeamento de função (um link entre um gancho de ciclo de vida e uma função). O mapeamento da função especifica qual gancho do ciclo de vida aciona a função.

  1. Abra o MediaTailor console.

  2. No painel de navegação, escolha Configurações.

  3. Escolha a configuração de reprodução que você deseja atualizar.

  4. Na seção Mapeamento de funções, escolha Editar.

  5. Para cada gancho de ciclo de vida, selecione a função a ser conectada:

    • Gancho de inicialização da sessão — Escolha uma função a ser executada uma vez no início da sessão.

    • Gancho de solicitação de anúncio — Escolha uma função a ser executada antes de cada solicitação do ADS.

    • Gancho de resposta para publicar anúncios — Escolha uma função a ser executada após cada resposta do ADS ser recebida e analisada.

    • Gancho de inserção pré-manifesto — Escolha uma função para ser executada no conjunto final de anúncios logo antes de os anúncios serem inseridos no manifesto.

  6. Escolha Salvar.

Gerenciar funções

Funções de visualização

Navegue até Funções para ver todas as funções em sua conta. Escolha um nome de função para visualizar sua configuração.

Atualizando uma função existente

Para atualizar uma função, navegue até Funções, escolha a função e modifique a configuração. A atualização substitui toda a definição da função.

dica

Salve uma cópia da configuração da função antes de fazer alterações. Não há controle de versão ou reversão embutidos para funções.

Removendo uma função

Separando uma função de uma configuração de reprodução

Antes de excluir uma função, remova-a de todas as configurações de reprodução que fazem referência a ela.

  1. Abra o MediaTailor console.

  2. No painel de navegação, escolha Configurações.

  3. Escolha a configuração de reprodução.

  4. Na seção Mapeamento de funções, escolha Editar.

  5. Remova a função do gancho do ciclo de vida.

  6. Escolha Salvar.

Como excluir uma função

Navegue até Funções, selecione a função e escolha Excluir.

Regras de bloqueio de exclusão

MediaTailor impede que você exclua uma função que ainda está em uso.

Condição Resultado
A função é anexada a uma configuração de reprodução por meio do mapeamento de funções A exclusão está bloqueada. Desconecte a função primeiro.
A função é referenciada em um SEQUENTIAL_EXECUTOR ou CONCURRENT_EXECUTOR A exclusão está bloqueada. Remova primeiro a referência da função principal.
A função não é referenciada em nenhum lugar A exclusão foi bem-sucedida.

Regras de validação

MediaTailor valida sua função ao criá-la ou atualizá-la. As seguintes verificações são realizadas:

  • Sintaxe de expressão — Todas as expressões devem ser JSonata válidas.

  • Funções restritas — As expressões não podem chamar funções restritas do JSOnata. Veja JSONatareferência de expressão a lista completa.

  • Prefixos de chave de saída — Todas as chaves de saída devem começar com um prefixo de namespace reconhecido. Para ver a lista de prefixos aceitos, consulte. Hooks do ciclo de vida

  • Referências de função — Todos os IDs de função em um FunctionList devem fazer referência a funções existentes.

  • Referências circulares — Uma função não pode referenciar a si mesma, direta ou indiretamente.

  • Profundidade de aninhamento — A SEQUENTIAL_EXECUTOR pode chamar outras funções, mas essas funções não podem ser executoras por si mesmas.

Para valores específicos e limites de tamanho, consulteLimites.

Referência de API

Para gerenciar funções de forma programática, consulte a Referência da AWS Elemental MediaTailor API.