Anexo: mapeamento de campos de IU para campos de API por tipo de criativo

A tabela abaixo mapeia os campos da interface aos campos correspondentes da API, separados por tipo de criativo. Alguns campos da API exigem mais especificações usando uma função 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:appendedTag
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
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:appendedTag
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
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
MRAID obrigatório
Opcional
Nome do campo da API:requireMraid
HTML5 obrigatório
Opcional
Nome do campo da API:requireHtml5
Tag de terceiros
Obrigatório
Nome do campo da API:thirdPartyTag
Requer ping para atribuição
Opcional
Nome do campo da API:requirePingForAttribution
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
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
MRAID obrigatório
Opcional
Nome do campo da API:requireMraid
HTML5 obrigatório
Opcional
Nome do campo da API:requireHtml5
Direção da expansão
Obrigatório
Nome do campo da API:expandingDirection
Expandir ao passar o cursor
Opcional
Nome do campo da API:expandOnHover
Terceiros
Obrigatório
Nome do campo da API:thirdPartyTag
Requer ping para atribuição
Opcional
Nome do campo da API:requirePingForAttribution
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
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 ping para atribuição
Opcional
Nome do campo da API:requirePingForAttribution
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
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 ping para atribuição
Opcional
Nome do campo da API:requirePingForAttribution
Código de integração
Opcional
Nome do campo da API:integrationCode
Observações
Opcional
Nome do campo da API:notas
Status da auditoria
Somente leitura
Nome do campo da API:reviewStatus

Criativo de 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:skippable
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
Arquivo de veiculação
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:notas
Status da auditoria
Somente leitura
Nome do campo da API:reviewStatus

Criativo em á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 (enviar ou atribuir)
Obrigatório
Nome do campo da API:companionCreativeIds
Nome do arquivo de veiculação
Somente leitura
Nome do campo da API:transcodes[].name
Tipo de arquivo de veiculação
Somente leitura
Nome do campo da API:transcodes[].mimeType
Como exibir a taxa de bits do áudio do arquivo
Somente leitura
Nome do campo da API:transcodes[].audioBitRateKbps
Como exibir a taxa de amostragem do áudio do arquivo
Somente leitura
Nome do campo da API:transcodes[].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:notas
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
status
Obrigatório
Nome do campo da API: entityStatus
Logotipo
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
Corpo do texto
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 1 de rastreamento de impressões
Opcional
Nome do campo da API:trackingUrls[]
URL 2 de rastreamento de impressões
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:notas
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
Logotipo
Obrigatório
Nome do campo da API:recursos
Função do recurso: ASSET_ROLE_ICON
Vídeo
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
Corpo do texto
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 1 de rastreamento de impressões
Opcional
Nome do campo da API:trackingUrls[]
URL 2 de rastreamento de impressões
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:notas
Status da auditoria
Somente leitura
Nome do campo da API:reviewStatus