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