Talvez seja necessário migrar para a v9 para fazer upload de arquivos de dados estruturados após 8 de setembro de 2025. Consulte nossa página de descontinuações para mais detalhes e nosso guia de migração para a v9 para instruções detalhadas.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Consulte a visão geral para uma explicação do formato.
Campo
Obrigatório
Tipo
Gravável
Descrição
ID do anúncio
Obrigatório apenas ao editar anúncios
número inteiro
Não
É o valor do ID numérico do anúncio do grupo de anúncios. Se deixado em branco, um novo anúncio será criado e um ID exclusivo será atribuído.
ID do grupo de anúncios
Sim
número inteiro
Não
É o valor do ID numérico do grupo de anúncios principal. Você pode especificar um identificador personalizado (por exemplo, "ext[custom ad group ID]") para um grupo de anúncios criado ao mesmo tempo que este anúncio.
Nome do grupo de anúncios
Não
string
Não
Nome do grupo de anúncios
Nome
Sim
string
Sim
O nome da entrada.
Status
Sim
string
Sim
A configuração de status da entrada.
Ativo
Pausado
Excluído
ID do vídeo
Sim
string
Sim
O ID do vídeo do YouTube
URL de visualização
Sim para in-stream e bumper
string
Sim
O URL de visualização do anúncio
URL da página de destino
Sim para in-stream e bumper
string
Sim
O URL da página de destino do anúncio
Rastreamento do DCM: ID da posição
Obrigatório apenas ao atualizar o anúncio de rastreamento do DCM
número inteiro
Sim
Valor numérico do ID da posição do DCM para o anúncio de rastreamento correspondente. Para remover um anúncio de rastreamento do DCM, deixe as três colunas "Rastreamento do DCM: ID da posição", "Rastreamento do DCM: ID do anúncio" e "Rastreamento do DCM: ID do criativo" em branco.
Rastreamento do DCM: ID do anúncio
Obrigatório apenas ao atualizar o anúncio de rastreamento do DCM
número inteiro
Sim
Valor numérico do ID do anúncio do DCM para o anúncio de rastreamento correspondente.Para remover um anúncio de rastreamento do DCM, deixe em branco as três colunas "Rastreamento do DCM: ID da posição", "Rastreamento do DCM: ID do anúncio" e "Rastreamento do DCM: ID do criativo".
Rastreamento do DCM: ID do criativo
Obrigatório apenas ao atualizar o anúncio de rastreamento do DCM
número inteiro
Sim
Valor numérico do ID do criativo para o anúncio de rastreamento correspondente.Para remover um anúncio de rastreamento do DCM, deixe as três colunas "Rastreamento do DCM: ID da posição", "Rastreamento do DCM: ID do anúncio" e "Rastreamento do DCM: ID do criativo" em branco.
URL do rastreador de cliques
Não
string
Sim
O URL do rastreador de cliques do anúncio
Parâmetros personalizados in-stream
Não
string, lista de listas
Sim
Os parâmetros personalizados do URL do rastreador de cliques. Formato = (name1; value1;); (name2; value2;); etc.
Etiqueta do botão de ação
Sim, se o item de linha principal for um item de linha TrueView for Action ou se a coluna "Título da ação" não estiver vazia
string
Sim
Rótulo do botão de call-to-action (uma linha com até 10 caracteres).
Título da ação
Não
string
Sim
Título da sobreposição de call-to-action (uma linha com até 15 caracteres).
Caminho 1 do URL de visualização do anúncio responsivo
Não
string
Sim
O caminho 1 do URL de visualização do anúncio responsivo
Caminho 2 do URL de exibição do anúncio responsivo
Não
string
Sim
O caminho 2 do URL de visualização do anúncio responsivo
Miniatura de vídeo in-feed
Sim para vídeo in-feed
string
Sim
A miniatura do vídeo a ser usada nos anúncios video discovery
0
1
2
3
Título do vídeo in-feed
Sim para vídeo in-feed
string
Sim
O texto do título de um anúncio responsivo ou de descoberta
Descrição 1 do vídeo In-feed
Sim para vídeo in-feed
string
Sim
O texto da descrição 1 do anúncio Discovery ou a descrição do anúncio responsivo
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThis document outlines the format for a structured data file used to create or edit video ads.\u003c/p\u003e\n"],["\u003cp\u003eThe file uses specific fields to define ad properties like Ad Group ID, Video ID, Display URL, and various tracking parameters.\u003c/p\u003e\n"],["\u003cp\u003eCertain fields are required for different ad formats like In-stream, Bumper, and In-feed Video, ensuring ads are properly configured.\u003c/p\u003e\n"],["\u003cp\u003eDCM Tracking fields are specifically used for managing and updating tracking associated with ads in DCM.\u003c/p\u003e\n"],["\u003cp\u003eFields for Responsive Ads and In-feed Video ads allow for customization of display URLs, thumbnails, headlines, and descriptions.\u003c/p\u003e\n"]]],[],null,["# Structured Data - v7 - YouTube Ad\n\n| This SDF version has been deprecated. Users should migrate to SDF [v9](/display-video/api/structured-data-file/v9/Campaign) before November 4, 2025 in order to continue using structured data files.\n\nSee the [overview](/display-video/api/structured-data-file/format) for an explanation of format.\n\n| Field | Required | Type | Writable | Description |\n|----------------------------------|-------------------------------------------------------------------------------------------------------|-----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Ad Id | Required only when editing existing Ads | integer | No | Numeric ID value of the ad group ad. If left blank a new Ad will be created and a unique ID will be assigned. |\n| Ad Group Id | Yes | integer | No | Numeric ID value of the parent ad group. You can specify a custom identifier (for example, \"ext\\[custom ad group ID\\]\") for an Ad Group that you are creating at the same time as this Ad. |\n| Ad Group Name | No | string | No | Ad Group Name |\n| Name | Yes | string | Yes | The name of the entry. |\n| Status | Yes | string | Yes | The status setting for the entry. - Active - Paused - Deleted |\n| Video Id | Yes | string | Yes | The YouTube video ID |\n| Display URL | Yes for In-stream and Bumper | string | Yes | The ad display URL |\n| Landing Page URL | Yes for In-stream and Bumper | string | Yes | The ad landing page URL |\n| DCM Tracking - Placement Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of DCM placement for the corresponding tracking ad. To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |\n| DCM Tracking - Ad Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of DCM Ad for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |\n| DCM Tracking - Creative Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of the creative for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |\n| Click Tracker URL | No | string | Yes | The ad click tracker URL |\n| In-stream Custom Parameters | No | string, list of lists | Yes | The click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc. |\n| Action Button Label | Yes if the parent line item is a TrueView for action line item or column Action Headline is not empty | string | Yes | Label for the Call to Action button (1 line with up to 10 characters). |\n| Action Headline | No | string | Yes | Headline for the Call to Action overlay (1 line with up to 15 characters). |\n| Responsive Ad Display Url Path 1 | No | string | Yes | The responsive ad display url path 1 |\n| Responsive Ad Display Url Path 2 | No | string | Yes | The responsive ad display url path 2 |\n| In-feed Video Thumbnail | Yes for In-feed Video | string | Yes | The video thumbnail to use for video discovery ads - 0 - 1 - 2 - 3 |\n| In-feed Video Headline | Yes for In-feed Video | string | Yes | The headline text for a discovery or responsive ad |\n| In-feed Video Description 1 | Yes for In-feed Video | string | Yes | The discovery ad description 1 text or responsive ad description |\n| In-feed Video Description 2 | Yes for In-feed Video | string | Yes | The discovery ad description 2 text |\n| In-feed Video Landing Page | Yes for In-feed Video | string | Yes | The discovery ad landing page |"]]