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

Construção e modelagem de propostas

Esta página explica como MediaTailor cria uma solicitação de lance do OpenRTB a partir do seu modelo, como a interpolação de variáveis funciona e quais valores são definidos automaticamente. MediaTailor

Campos de configuração

Ao ativar a otimização de rendimento em uma configuração de reprodução, você fornece quatro campos:

Como a solicitação de licitação é construída

Quando um intervalo de anúncio tem a duração restante não preenchida, cria MediaTailor a solicitação de lance nas seguintes etapas:

Modelo padrão do console

Quando você ativa a otimização de rendimento no MediaTailor console, o seguinte modelo pré-preenchido é fornecido como ponto de partida. Você deve personalizar os valores do seu aplicativo:

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field explicação:

Interpolação de modelos (modelagem Mustache)

Seu modelo ORTB usa a sintaxe de modelagem Mustache para substituição dinâmica de valores. Os espaços reservados usam colchetes duplos. {{ }}

Variáveis de modelo disponíveis

Seu modelo ORTB pode usar as mesmas variáveis dinâmicas disponíveis nos modelos de URL do ADS. Isso inclui variáveis de sessão (por exemplo,{{session.client_ip}}){{session.user_agent}}, parâmetros do player ({{player_params.*}}), metadados do ativo ({{asset.*}}), contexto de disponibilidade ({{avail.*}}) e dados de sinal SCTE (). {{scte.*}}

Para obter a lista completa das variáveis disponíveis e suas descrições, consulteMediaTailor variáveis de anúncios dinâmicos para solicitações de ADS. Para saber como os parâmetros MediaTailor URL-decodes do jogador são avaliados antes de substituí-los no modelo, veja Comportamento de codificação e decodificação mais adiante nesta página.

As variáveis mais usadas nos modelos ORTB são:

Como passar os parâmetros do jogador

Há duas maneiras de passar parâmetros do jogador durante a inicialização da sessão.

Método 1: solicitação POST com corpo JSON (recomendado)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

Esse método é preferido porque evita URL-encoding problemas com valores complexos, como cadeias de caracteres de agente de usuário.

Método 2: parâmetros de consulta de URL

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

Com esse método, os valores devem ser URL-encoded. MediaTailor URL-decodes eles antes da interpolação.

Comportamento de codificação e decodificação

MediaTailor executa um nível de decodificação de URL nos valores dos parâmetros do player antes de interpolá-los no modelo. Isso se aplica independentemente de como os parâmetros são passados (corpo do POST ou parâmetros de consulta de URL).

Exemplos de valores decodificados:

Pontos-chave:

O que acontece quando uma variável está ausente

Se o player não enviar um parâmetro referenciado em seu modelo (por exemplo, {{player_params.app_name}} mas não app_name nos parâmetros do player), o espaço reservado será resolvido para uma string vazia. ""

Impacto: se a string vazia estiver em um campo obrigatório (comoapp.bundle), a solicitação de lance falhará comBidRequestConfigurationError. Se estiver em um campo opcional, o APS recebe um valor vazio que pode causar uma resposta sem oferta (HTTP 204).

O que MediaTailor define automaticamente

Os campos a seguir são sempre definidos MediaTailor usando valores da configuração do console e do contexto atual de disponibilidade. Se você incluí-los em seu modelo, seus valores serão substituídos:

Próximas etapas