View a markdown version of this page

Guia de início rápido do Yield Optimization - AWS Elemental MediaTailor
Pré-requisitosEtapa 1: ativar a otimização de rendimento no consoleEtapa 2: Configurar o modelo OpenRTBEtapa 3: iniciar uma sessão e verificarEtapa 2 (alternativa): configurar usando a APIPróximas etapas

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

Guia de início rápido do Yield Optimization

Este guia explica como ativar a otimização de rendimento em uma configuração de reprodução e verificar se ela funciona.

Objetivo: Ao final deste guia, você terá uma configuração de reprodução que preenche automaticamente o inventário de anúncios não preenchidos com anúncios programáticos da APS.

Pré-requisitos

  • Uma configuração de MediaTailor reprodução existente com uma fonte de conteúdo ao vivo.

  • Um ID de editor da APS. Veja Integração com APS se você não tem um.

Etapa 1: ativar a otimização de rendimento no console

  1. Abra o console do MediaTailor.

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

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

  4. Escolha Editar.

  5. Expanda a seção Configurações de otimização de rendimento (marcada com um novo emblema no lançamento). A descrição da seção diz: “Defina as configurações de otimização de rendimento, incluindo ID do editor, limites de duração do anúncio e segmentação regional”.

  6. Defina o menu suspenso de habilitação como Ativado.

  7. Preencha os seguintes campos:

    • ID do editor do APS: O ID do editor do APS associado à sua conta do editor (por exemplo,8caf35b3-402b-4d75-bab2-f2aef63a66d3). Veja Integração com APS como obter isso.

    • Duração mínima não preenchida: a duração mínima não preenchida em segundos que o Yield Optimization tentará preencher. Defina isso como 15 ou superior. Valores abaixo de 15 segundos não retornarão anúncios porque os criativos de anúncios APS normalmente duram 15 segundos ou mais.

    • Região do Amazon Ads: a região do Amazon Ads para a qual encaminhar as solicitações de lances. Escolha um dos AmericasEurope, ou Asia Pacific com base no seu público principal. Isso é mapeado para o Region campo no modelo de YieldOptimizationConfiguration API, e os nomes das regiões correspondem às regiões APS descritas emIntegração com APS.

    • Configuração do modelo OpenRTB: Seu modelo JSON. Veja Exemplos de modelos do os pontos de partida. O console valida a sintaxe JSON e mostra erros e avisos em linha. O modelo padrão é preenchido previamente com o modelo inicial do console. Consulte Construção e modelagem de propostas.

  8. Escolha Salvar.

Etapa 2: Configurar o modelo OpenRTB

O console fornece um editor JSON para o modelo OpenRTB. No mínimo, seu modelo deve incluir:

{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}

O console avisará você se os campos obrigatórios estiverem ausentes.

Etapa 3: iniciar uma sessão e verificar

  1. Inicie uma sessão de reprodução que inclua os parâmetros do player (agente do usuário, endereço IP etc.).

  2. Aguarde um intervalo publicitário com duração não preenchida.

  3. Verifique CloudWatch as métricas YieldOptimization.BidRequest de YieldOptimization.AdsInserted e.

Se BidRequest estiver emitindo, mas AdsInserted for 0, verifique o RAW_BID_REQUEST evento no ads_interaction_log para verificar se seu modelo está produzindo solicitações de lance válidas.

Etapa 2 (alternativa): configurar usando a API

Use a PutPlaybackConfiguration API com o YieldOptimizationConfiguration parâmetro:

aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'

Próximas etapas