Anexo: mapeamento de campos de IU para campos de API por tipo de criativo
A tabela abaixo mapeia os campos da IU para os campos da API correspondentes, separados por tipo de criativo. Alguns campos da API exigem especificações adicionais por meio de um papel ou tipo atribuído para o recurso fornecido.
Criativo de imagem padrão
| Tipo de criativo: CREATIVE_TYPE_STANDARD |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Recurso do criativo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Tag de rastreamento HTML anexada
|
|
Opcional
|
|
Nome do campo da API:attachingTag
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo HTML5
| Tipo de criativo: CREATIVE_TYPE_STANDARD |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Recurso do criativo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Imagens de backup
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_BACKUP
|
|
|
URL da página de destino de backup
|
|
Opcional
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_BACKUP
|
|
|
Rótulo de relatório de saída de backup
|
|
Opcional
|
|
Nome do campo da API: exitEvents[].reportingName
|
|
Tipo de evento de saída: exit_EVENT_TYPE_BACKUP
|
|
|
Imagens de carregamento discreto
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_POLITE_LOAD
|
|
|
Saídas
|
|
Obrigatório
|
|
Nome do campo da API: exitEvents[]
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Contadores
|
|
Opcional
|
|
Nome do campo da API:counterEvents[]
|
|
|
Temporizadores
|
|
Opcional
|
|
Nome do campo da API: timerEvents[]
|
|
|
Tag de rastreamento HTML anexada
|
|
Opcional
|
|
Nome do campo da API:attachingTag
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Opcional
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de display de terceiros
| Tipo de criativo: CREATIVE_TYPE_STANDARD |
| Origem da hospedagem: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Dimensões
|
|
Obrigatório
|
|
Nome do campo da API:dimensões
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Requer MRAID
|
|
Opcional
|
|
Nome do campo da API:requiredMraid
|
|
|
Requer HTML5
|
|
Opcional
|
|
Nome do campo da API:requiredHTML5
|
|
|
Tag de terceiros
|
|
Obrigatório
|
|
Nome do campo da API:thirdPartyTag
|
|
|
Requer um ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requiredPingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo expansível de terceiros
| Tipo de criativo: CREATIVE_TYPE_EXPANDABLE |
| Origem da hospedagem: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Dimensões
|
|
Obrigatório
|
|
Nome do campo da API:dimensões
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Requer MRAID
|
|
Opcional
|
|
Nome do campo da API:requiredMraid
|
|
|
Requer HTML5
|
|
Opcional
|
|
Nome do campo da API:requiredHTML5
|
|
|
Direção da expansão
|
|
Obrigatório
|
|
Nome do campo da API:expansívelDirection
|
|
|
Abrir ao passar o cursor
|
|
Opcional
|
|
Nome do campo da API:expandOnHover
|
|
|
Terceiros
|
|
Obrigatório
|
|
Nome do campo da API:thirdPartyTag
|
|
|
Requer um ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requiredPingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de vídeo de terceiros
| Tipo de criativo: CREATIVE_TYPE_VIDEO |
| Origem da hospedagem: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
URL da tag VAST
|
|
Obrigatório
|
|
Nome do campo da API:vastTagUrl
|
|
|
VPAID
|
|
Somente leitura
|
|
Nome do campo da API:vpaid
|
|
|
Vídeo HTML5
|
|
Somente leitura
|
|
Nome do campo da API:html5Video
|
|
|
Requer um ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requiredPingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo em áudio de terceiros
| Tipo de criativo: CREATIVE_TYPE_AUDIO |
| Origem da hospedagem: HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
URL da tag VAST
|
|
Obrigatório
|
|
Nome do campo da API:vastTagUrl
|
|
|
Requer um ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requiredPingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo em vídeo
| Tipo de criativo: CREATIVE_TYPE_VIDEO |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Arquivo de origem
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Incluir o botão "Pular"
|
|
Opcional
|
|
Nome do campo da API:pulável
|
|
|
Tempo até a opção pular
|
|
Opcional
|
|
Nome do campo da API:skipOffset
|
|
|
Tempo sem cobrança
|
|
Opcional
|
|
Nome do campo da API:progressOffset
|
|
|
ID universal do anúncio
|
|
Opcional
|
|
Nome do campo da API: universalAdId
|
|
|
OBA
|
|
Opcional
|
|
Nome do campo da API:obaIcon
|
|
|
Criativos complementares
|
|
Opcional
|
|
Nome do campo da API:companionCreativeIds
|
|
|
Veiculação de arquivo
|
|
Somente leitura
|
|
Nome do campo da API:transcodificações.
|
|
|
URLs de terceiros
|
|
Opcional
|
|
Nome do campo da API:thirdPartyUrls
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de áudio
| Tipo de criativo: CREATIVE_TYPE_AUDIO |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Arquivo de origem
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
Recurso complementar (fazer upload ou atribuir)
|
|
Obrigatório
|
|
Nome do campo da API:companionCreativeIds
|
|
|
Nome do arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API: transcodificações[].name
|
|
|
Veiculação de tipo de arquivo
|
|
Somente leitura
|
|
Nome do campo da API: transcodificações[].mimeType
|
|
|
Taxa de bits de áudio do arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API: transcodificações[].audioBitRateKbps
|
|
|
Taxa de amostragem de áudio do arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API: transcodificações[].audioSampleRateHz
|
|
|
URLs de terceiros
|
|
Opcional
|
|
Nome do campo da API:thirdPartyUrls
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de display nativo
| Tipo de criativo:CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_square |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
reconhecimento
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Logo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_ICON
|
|
|
Imagem / Imagem quadrada
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
Título
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_HEADLINE
|
|
|
Título longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_LONG_HEADLINE
|
|
|
Texto do corpo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_body
|
|
|
Corpo do texto longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_LONG_Body
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
URL da legenda
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_CAPTION_URL
|
|
|
Call-to-action
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_CALL_TO_ACTION
|
|
|
Anúncio de rastreamento do Campaign Manager 360
|
|
Opcional
|
|
Nome do campo da API:cmTrackingAd
|
|
|
URL de rastreamento de impressões 1
|
|
Opcional
|
|
Nome do campo da API:TrackingUrls[]
|
|
|
URL de rastreamento de impressões 2
|
|
Opcional
|
|
Nome do campo da API:TrackingUrls[]
|
|
|
URL de rastreamento JavaScript
|
|
Opcional
|
|
Nome do campo da API: jsTrackerUrl
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de vídeo nativo
| Tipo de criativo: CREATIVE_TYPE_NATIVE_VIDEO |
| Origem da hospedagem: HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API: displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API:entityStatus
|
|
|
Logo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_ICON
|
|
|
Video
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_MAIN
|
|
|
Imagem da capa
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_COVER_IMAGE
|
|
|
Nome do anunciante
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_ADVERTISER_NAME
|
|
|
Título
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_HEADLINE
|
|
|
Título longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_LONG_HEADLINE
|
|
|
Texto do corpo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_body
|
|
|
Corpo do texto longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_LONG_Body
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída: exit_EVENT_TYPE_DEFAULT
|
|
|
URL da legenda
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_CAPTION_URL
|
|
|
Call-to-action
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_CALL_TO_ACTION
|
|
|
URL de rastreamento de impressões 1
|
|
Opcional
|
|
Nome do campo da API:TrackingUrls[]
|
|
|
URL de rastreamento de impressões 2
|
|
Opcional
|
|
Nome do campo da API:TrackingUrls[]
|
|
|
URL de rastreamento JavaScript
|
|
Opcional
|
|
Nome do campo da API: jsTrackerUrl
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API: observações
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2023-12-01 UTC.
[null,null,["Última atualização 2023-12-01 UTC."],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
