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 in-stream
Sim para in-stream
string
Sim
O URL de visualização do anúncio
URL da página de destino in-stream
Sim para in-stream
string
Sim
O URL da página de destino do anúncio
URL do rastreador de cliques no stream
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.
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 do anúncio Discovery
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
Descrição da descoberta de vídeo 2
Sim para a descoberta de vídeo
string
Sim
O texto da descrição 2 do anúncio Discovery
Página de destino do Discovery de vídeo
Sim para a descoberta de vídeo
string
Sim
A página de destino do anúncio Discovery
ID do app para dispositivos móveis
Sim para o subtipo "Instalação de apps para dispositivos móveis"
string
Sim
O app para dispositivos móveis usado para anúncios de instalação de apps para dispositivos móveis. Formato:com.google.android.gm ou 422689480
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis SDF version is outdated and users should transition to SDF v7 for continued use of structured data files.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation is solely for referencing previously generated files and not for creating new ones.\u003c/p\u003e\n"],["\u003cp\u003eThe structured data file format includes fields for managing video and discovery ads, requiring specific details for each ad type.\u003c/p\u003e\n"],["\u003cp\u003eFields like 'Ad Id' and 'Ad Group Id' help manage ad relationships while 'Name' and 'Status' control ad identification and state.\u003c/p\u003e\n"],["\u003cp\u003eFor video ads, essential fields include 'Video Id', display and landing page URLs, and optional click trackers and custom parameters.\u003c/p\u003e\n"]]],[],null,["# Structured Data - v3.1 - 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| In-stream Display URL | Yes for In-stream | string | Yes | The ad display URL |\n| In-stream Landing Page URL | Yes for In-stream | string | Yes | The ad landing page URL |\n| In-stream 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| 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 discovery ad headline text |\n| Video Discovery Description 1 | Yes for Video Discovery | string | Yes | The discovery ad description 1 text |\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 |\n| Mobile App Id | Yes for Mobile App Install subtype | string | Yes | The mobile app used for mobile app install ads. Format:com.google.android.gm or 422689480 |"]]
