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 existentes
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
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 do ID numérico 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 do ID numérico 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 do ID numérico do criativo 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".
URL do rastreador de cliques
Não
string
Sim
O URL do rastreador de cliques do anúncio
Parâmetros personalizados no stream
Não
string, lista de listas
Sim
Os parâmetros personalizados do URL do Rastreador de cliques. Formato = (nome1; valor1;); (nome2; valor2;); etc.
Rótulo do botão de ação
Sim, se o item de linha pai 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 (1 linha com até 15 caracteres).
Miniatura do vídeo na descoberta de vídeos
Sim para a descoberta de vídeo
string
Sim
A miniatura do vídeo que será usada nos anúncios video discovery
0
1
2
3
Título da descoberta de vídeo
Sim para a descoberta de vídeo
string
Sim
O texto do título de um anúncio responsivo ou de descoberta
Descrição 1 do Discovery em vídeo
Sim para a descoberta de vídeo
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-07-25 UTC."],[[["\u003cp\u003eThis specific Structured Data File (SDF) version is outdated and no longer supported for new uploads.\u003c/p\u003e\n"],["\u003cp\u003eUsers are strongly encouraged to switch to SDF version 7 to continue utilizing structured data files for campaign management.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation remains available solely for reference purposes when working with previously created files using this older SDF version.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation details the required fields and their specifications for defining various aspects of an ad, including its identification, status, targeting, and creative elements.\u003c/p\u003e\n"],["\u003cp\u003eUsers can find a comprehensive explanation of the overall SDF format through the provided overview link.\u003c/p\u003e\n"]]],[],null,["# Structured Data - v5.2 - YouTube Ad\n\n| This SDF version has been sunset. Users should migrate to SDF [v7.1](/display-video/api/structured-data-file/v7-1/Campaign) in order to continue using structured data files. Only use this documentation when referring to previously-generated 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| 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| Video Discovery Video Thumbnail | Yes for Video Discovery | string | Yes | The video thumbnail to use for video discovery ads - 0 - 1 - 2 - 3 |\n| Video Discovery Headline | Yes for Video Discovery | string | Yes | The headline text for a discovery or responsive ad |\n| Video Discovery Description 1 | Yes for Video Discovery | string | Yes | The discovery ad description 1 text or responsive ad description |\n| Video Discovery Description 2 | Yes for Video Discovery | string | Yes | The discovery ad description 2 text |\n| Video Discovery Landing Page | Yes for Video Discovery | string | Yes | The discovery ad landing page |"]]