View a markdown version of this page

Referência de campo ORTB - AWS Elemental MediaTailor
Categorias de campoobjeto de aplicativoobjeto de dispositivoobjeto imp (impressão)Top-level camposobjeto de usuárioobjeto regsPró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á.

Referência de campo ORTB

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.

Categorias de campo

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

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

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)

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

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

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

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

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