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

# Referência de campo ORTB
<a name="yield-optimization-ortb-reference"></a>

Esta página é uma referência completa para cada campo na solicitação de oferta do OpenRTB. Os campos são categorizados de acordo com a forma como os MediaTailor trata e se o APS os exige ou os recomenda para o preenchimento ideal do anúncio.

Para obter a especificação completa do OpenRTB 2.6, consulte a especificação [ IAB OpenRTB 2.6. ](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)

## Categorias de campo
<a name="yield-optimization-ortb-reference-categories"></a>


| Categoria | Significado | Sua ação | 
| --- | --- | --- | 
| Obrigatório  | Deve estar presente em seu modelo. MediaTailor gera um erro se estiver ausente. | Você deve fornecê-los. | 
| Codificado pela EMT  | MediaTailor sempre os define usando valores da configuração do console ou do contexto atual de disponibilidade. Os valores do seu modelo são substituídos. | Não os defina em seu modelo. | 
| APS recomendado  | Não é estritamente exigido por MediaTailor, mas a APS os recomenda para melhor preenchimento e segmentação de anúncios. A falta de campos recomendados pode resultar em menores taxas de preenchimento ou respostas sem licitação. | Altamente recomendado. | 
| Opcional | Incluído na solicitação de lance somente se você os fornecer. Nenhum valor padrão. | Forneça se for relevante para seu caso de uso. | 

## ``objeto de aplicativo
<a name="yield-optimization-ortb-reference-app"></a>


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| app | Obrigatório  | O app objeto deve existir em seu modelo. | 
| app.bundle | Obrigatório  | ID do pacote do seu aplicativo (por exemplo,G15147002586). Não deve estar vazio. | 
| app.storeurl | Obrigatório  | URL da loja de aplicativos (por exemplo,https://apps.apple.com/us/app/yourapp/id123). | 
| app.publisher.id | Codificado pela EMT  | Sempre defina como sua a PublisherId partir da configuração do console. | 
| app.content | Obrigatório (objeto)  | MediaTailor envia um Content objeto vazio se você omitir isso. Forneça metadados de conteúdo para uma melhor segmentação. | 
| app.name | APS recomendado | Nome do aplicativo para identificação. | 
| app.id | APS recomendado | Seu identificador de aplicativo no APS. | 
| app.domain | APS recomendado | Domínio do aplicativo. | 
| app.content.genre | APS recomendado | Gênero de conteúdo (por exemplo,"Sport","News"). | 
| app.content.contentrating | APS recomendado | Classificação do conteúdo (por exemplo,"TV-G","TV-14"). | 
| app.content.language | APS recomendado | Idioma do conteúdo (ISO-639-1). | 
| app.content.id | APS recomendado | Identificador de conteúdo. | 
| app.content.title | APS recomendado | Título do conteúdo. | 
| app.content.episode | APS recomendado | Número do episódio. | 
| app.content.len | APS recomendado | Tamanho do conteúdo em segundos. | 
| app.cat | Opcional | Categorias de conteúdo (taxonomia do IAB). | 
| app.sectioncat | Opcional | Categorias de seção. | 
| app.pagecat | Opcional | Categorias de páginas. | 
| app.ver | Opcional | Versão do aplicativo. | 
| app.privacypolicy | Opcional | 1 = tem política de privacidade. | 
| app.paid | Opcional | 1 = aplicativo pago. | 
| app.keywords | Opcional | Comma-separated palavras-chave. | 
| app.kwarray | Opcional | Palavras-chave como matriz. | 
| app.inventorypartnerdomain | Opcional | Domínio do parceiro de inventário. | 
| app.ext | Opcional | Objeto de extensão (passagem). | 

## ``objeto de dispositivo
<a name="yield-optimization-ortb-reference-device"></a>


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| device | Obrigatório  | O device objeto deve existir em seu modelo. | 
| device.ua | Obrigatório  | Sequência do agente do usuário. Não deve estar vazio. Use {{session.user\_agent}}. | 
| device.ip | Obrigatório  | Endereço IPv4. Não deve estar vazio. Use {{session.client\_ip}}. | 
| device.lmt | Opcional (padrão: 0) | Sinalizador de limite de rastreamento de anúncios. 0= rastreamento permitido, 1 = rastreamento limitado. Se não for fornecido em seu modelo, o padrão é. 0 | 
| device.devicetype | Codificado pelo EMT (padrão: 3)  | MediaTailor conjuntos 3 (TV conectada) se não forem fornecidos. Seu valor é usado se estiver presente. | 
| device.make | APS recomendado | Fabricante do dispositivo (por exemplo,"Samsung","Apple"). | 
| device.model | APS recomendado | Modelo do dispositivo (por exemplo,"Tizen TV","iPhone"). | 
| device.os | APS recomendado | Sistema operacional (por exemplo,"Tizen","iOS"). | 
| device.osv | APS recomendado | Versão do sistema operacional. | 
| device.h | APS recomendado | Altura da tela em pixels. | 
| device.w | APS recomendado | Largura da tela em pixels. | 
| device.language | APS recomendado | Idioma do dispositivo (ISO-639-1). | 
| device.ifa | APS recomendado | ID de publicidade do dispositivo. Nem todos os dispositivos têm um (por exemplo, navegadores da web). | 
| device.dnt | APS recomendado | Sinalizador do Do Not Track. | 
| device.geo | Opcional | Objeto geográfico comcountry,lat,lon. | 
| device.sua | Opcional | Agente de usuário estruturado (UA-CH). | 
| device.ipv6 | Opcional | Endereço IPv6. | 
| device.hwv | Opcional | Versão de hardware. | 
| device.connectiontype | Opcional | Tipo de conexão (WiFicelular e assim por diante). | 
| device.carrier | Opcional | Nome da operadora. | 
| device.mccmnc | Opcional |  country/network Código móvel. | 
| device.ext | Opcional | Objeto de extensão (passagem). | 

## `objeto imp` (impressão)
<a name="yield-optimization-ortb-reference-imp"></a>

Seu modelo deve conter exatamente ** um ** `imp` objeto em uma matriz.


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| imp[0].video | Obrigatório  | O video objeto deve existir. | 
| imp[0].video.mimes | Obrigatório  | Tipos de MIME suportados (por exemplo,["video/mp4"]). | 
| imp[0].video.protocols | Opcional | Protocolos VAST suportados. Se omitido, MediaTailor usa fallback codificado. [1, 2, 3, 4, 5, 6, 7, 8] Veja a referência de enumeração de protocolo abaixo. | 
| imp[0].video.minduration | Codificado pela EMT  | Defina como seu MinimumUnfilledDuration a partir do console. | 
| imp[0].video.maxduration | Codificado pela EMT  | Defina para a duração real não preenchida (segundos). | 
| imp[0].video.maxseq | Codificado pela EMT  | Calculado:floor(unfilled\_duration / 6). A APS recomenda poddur um maxseq ou mais anúncios. | 
| imp[0].video.poddur | Codificado pela EMT  | Defina para a duração não preenchida (segundos). | 
| imp[0].video.startdelay | Opcional | Atraso no início. 0= pré-rolo, -1 = rolo médio genérico, -2 = pós-rolo, = deslocamento médio do rolo em segundos. > 0 Use -1 para pausas intermediárias ao vivo. Recurso codificado:. 6 | 
| imp[0].video.w | APS recomendado | Largura do vídeo em pixels. | 
| imp[0].video.h | APS recomendado | Altura do vídeo em pixels. | 
| imp[0].video.plcmt | APS recomendado | Tipo de posicionamento (1 = in-stream). | 
| imp[0].video.podid | APS recomendado | Identificador do pod. | 
| imp[0].video.slotinpod | APS recomendado | Posição do slot na cápsula. | 
| imp[0].video.ext.slotId | Opcional (padrão:"default\_slot\_id") | Seu ID de slot APS do console APS. O padrão funciona, mas fornecer seu ID real do slot permite que a APS aplique a segmentação específica do slot e o preço mínimo. | 
| imp[0].bidfloor | Opcional (padrão: 1,0) | Preço mínimo do lance em CPM. | 
| imp[0].secure | Opcional (padrão: 1) | 1 = requer URLs criativos em HTTPS. | 
| imp[0].id | Opcional | ID de impressão. Auto-generated se não for fornecido. | 
| imp[0].tagid | Opcional | Tag/placement ID. | 
| imp[0].bidfloorcur | Opcional | Moeda mínima de oferta (USD padrão). | 
| imp[0].ssai | Opcional | Indicador SSAI. | 
| imp[0].exp | Opcional | Prazo de validade da impressão. | 
| imp[0].rqddurs | Opcional | Matriz de durações solicitadas. | 
| imp[0].mincpmpersec | Opcional | CPM mínimo por segundo. | 
| imp[0].pmp | Opcional | Objeto de mercado privado. | 
| imp[0].ext | Opcional | Objeto de extensão (passagem). | 

### Referência de enumeração de protocolo
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| Valor | Protocolo | 
| --- | --- | 
| 1 | VASTO 1.0 | 
| 2 | VASTO 2.0 | 
| 3 | VASTO 3.0 | 
| 4 | Embalagem VAST 1.0 | 
| 5 | Embalagem VAST 2.0 | 
| 6 | Embalagem VAST 3.0 | 
| 7 | VASTO 4.0 | 
| 8 | Embalagem VAST 4.0 | 
| 9\+ | DAST | 

## Top-level campos
<a name="yield-optimization-ortb-reference-top-level"></a>


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| id | Codificado pela EMT  | Auto-generated: {sessionId}\_{availId} formato (por exemplo,abc123-def456\_78901). Útil para correlacionar solicitações de lances com registros de sessão. | 
| cur | Opcional (padrão:["USD"]) | Moedas permitidas. | 
| ext.integrationType | Codificado pela EMT  | Sempre configurado como"EMT". | 
| bcat | Opcional | Categorias de anúncios bloqueados (taxonomia do IAB). O valor do seu modelo é enviado no estado em que se encontra para o APS. | 
| badv | Opcional | Domínios de anunciantes bloqueados. | 
| bapp | Opcional | IDs de pacotes de aplicativos bloqueados. | 
| test | Opcional | Sinalizador do modo de teste. | 
| at | Opcional | Tipo de leilão. | 
| tmax | Opcional | Tempo máximo (ms) de espera pela resposta do lance. | 
| wseat | Opcional | Assentos de comprador permitidos. | 
| bseat | Opcional | Assentos de compradores bloqueados. | 
| wlang | Opcional | Linguagens criativas permitidas. | 
| source | Opcional | Objeto de origem para a cadeia de suprimentos. | 
| ext | Opcional | Seus campos de extensão personalizados são mesclados com os EMTs. integrationType | 

## ``objeto de usuário
<a name="yield-optimization-ortb-reference-user"></a>


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| user | APS recomendado (UE) | Necessário para tráfego na UE com o consentimento do GDPR. | 
| user.consent | APS recomendado (UE) | Cadeia de consentimento do GDPR (TCF). | 
| user.id | Opcional | ID de usuário. | 
| user.buyeruid | Opcional | Buyer-specific ID do usuário. | 
| user.eids | Opcional | Identificadores estendidos (LiveRamp, UID2 e assim por diante). | 
| user.data | Opcional | Segmentos de dados do usuário. | 
| user.ext | Opcional | Objeto de extensão. | 

## `objeto regs`
<a name="yield-optimization-ortb-reference-regs"></a>


| Campo | Categoria | Observações | 
| --- | --- | --- | 
| regs | APS recomendado | Inclua para fins de conformidade regulatória. | 
| regs.coppa | APS recomendado (EUA) | Bandeira da COPPA (1 = dirigida por crianças). | 
| regs.us\_privacy | APS recomendado (EUA) | Sequência de caracteres de privacidade dos EUA/CCPA. | 
| regs.gdpr | APS recomendado (UE) | O GDPR se aplica (1 = sim). | 
| regs.gpp | APS recomendado | Cadeia de caracteres da Plataforma de Privacidade Global. Preferida us\_privacy ao público dos EUA, resulta em melhores taxas de preenchimento. Consulte [Práticas recomendadas](yield-optimization-best-practices.md). | 
| regs.gpp\_sid | APS recomendado | IDs de seção GPP (por exemplo, [7] para cidadãos dos EUA). Obrigatório quando gpp está presente. | 
| regs.ext | Opcional | Objeto de extensão. | 

## Próximas etapas
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ Para modelos de copiar e colar, consulte. [Exemplos de modelos do ](yield-optimization-examples.md)
+ Para recomendações sobre como maximizar as taxas de preenchimento, consulte[Práticas recomendadas](yield-optimization-best-practices.md).