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
<a name="yield-optimization-quickstart"></a>

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
<a name="yield-optimization-quickstart-prereqs"></a>
+ 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](yield-optimization-integrating-aps.md) se você não tem um.

## Etapa 1: ativar a otimização de rendimento no console
<a name="yield-optimization-quickstart-step1"></a>

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

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

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

1. Escolha **Editar**.

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

1. Defina o menu suspenso de habilitação como Ativado. ** **

1. 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](yield-optimization-integrating-aps.md) 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 `Americas``Europe`, 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 em[Integração com APS](yield-optimization-integrating-aps.md).
   + **Configuração do modelo OpenRTB**: Seu modelo JSON. Veja [Exemplos de modelos do ](yield-optimization-examples.md) 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](yield-optimization-bid-construction.md).

1. Escolha **Salvar**.

## Etapa 2: Configurar o modelo OpenRTB
<a name="yield-optimization-quickstart-step2"></a>

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
<a name="yield-optimization-quickstart-step3"></a>

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

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

1. 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
<a name="yield-optimization-quickstart-step2-api"></a>

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
<a name="yield-optimization-quickstart-next-steps"></a>
+ Para se registrar no APS e obter seu ID de editor, consulte[Integração com APS](yield-optimization-integrating-aps.md).
+ Para entender como MediaTailor decide quando fazer solicitações de lance, consulte[Como funciona a otimização de rendimento](yield-optimization-how-it-works.md).
+ Para ver exemplos completos de modelos, consulte[Exemplos de modelos do ](yield-optimization-examples.md).