Dados estruturados - v7 – Grupo de anúncios do YouTube

Esta versão do SDF foi descontinuada. Os usuários precisam migrar para o SDF v9 antes de 4 de novembro de 2025 para continuar usando arquivos de dados estruturados.

Consulte a visão geral para uma explicação do formato.

Campo	Obrigatório	Tipo	Gravável	Descrição
ID do grupo de anúncios	Obrigatório apenas ao editar grupos de anúncios atuais	número inteiro	Não	É o valor do ID numérico do grupo de anúncios. Se deixado em branco, um novo ID de grupo de anúncios será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar novos grupos de anúncios, você pode usar um identificador personalizado para atribuir anúncios TrueView ao novo grupo. O formato do identificador personalizado é "ext[custom identifier]", por exemplo, ext123. Quando o arquivo é enviado e processado, todos os identificadores personalizados são substituídos por IDs atribuídos pelo DBM, e os objetos são associados (por exemplo, anúncio ao grupo de anúncios) com base nos identificadores personalizados.
ID do item de linha	Sim	número inteiro	Não	É o valor do ID numérico do item de linha principal. Você pode especificar um identificador personalizado (por exemplo, "ext[custom line item ID]") para um item de linha criado ao mesmo tempo que este grupo de anúncios.
Nome do item de linha	Não	string	Não	Nome do item de linha
Nome	Sim	string	Sim	O nome da entrada.
Status	Sim	string	Sim	A configuração de status da entrada. Ativo Pausado Excluído
Formato do anúncio em vídeo	Sim	string	Sim	O formato de anúncio em vídeo do grupo de anúncios. In-stream Vídeo In-feed Bumper Não pulável Responsivo Alcance eficiente Áudio do YouTube
Custo do lance	Sim	float	Sim	O valor que representa o custo máximo do lance desejado para o grupo de anúncios com base no tipo de lance definido na coluna "Tipo de estratégia de lances do TrueView". Por exemplo, se o tipo de estratégia de lances TrueView for CPV manual, ele será o custo por visualização máximo. Observação: se a coluna "Tipo de estratégia de lances TrueView" for "Maximizar conversões", "Maximizar o valor da conversão" ou "ROAS desejado", essa coluna deverá ser 0 ao fazer o upload.
Segmentação por palavras-chave: inclusão	Não	string, list	Sim	Lista de strings de palavras-chave a serem incluídas na segmentação. Essa lista é gerada em ordem alfabética crescente.
Segmentação por palavras-chave - Excluir	Não	string, list	Sim	Lista de strings de palavras-chave a serem excluídas na segmentação. Essa lista é gerada em ordem alfabética crescente.
Segmentação por categoria – incluir	Não	string, list	Sim	Lista de categorias a serem incluídas na segmentação. Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY. Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por categoria - Excluir	Não	string, list	Sim	Lista de categorias a serem excluídas na segmentação. Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY. Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por canal: canais do YouTube: incluir	Não	string, list	Sim	Lista de canais do YouTube a serem incluídos. Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.).
Segmentação por posição - Canais do YouTube - Excluir	Não	string, list	Sim	Lista de canais do YouTube a serem excluídos. Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.).
Segmentação por canal: vídeos do YouTube (incluir)	Não	string, list	Sim	Lista de vídeos do YouTube a serem incluídos. Formato da lista = (ID do vídeo do YouTube; ID do vídeo do YouTube; etc.).
Segmentação por posição - Vídeos do YouTube - Excluir	Não	string, list	Sim	Lista de vídeos do YouTube a serem excluídos. Formato da lista = (ID do vídeo do YouTube; ID do vídeo do YouTube; etc.).
Segmentação por canal: conteúdo em alta (incluir)	Não	string, list	Sim	Lista de conteúdo em alta no YouTube e no Google parceiros de vídeo para incluir. Selecione um ou mais dos valores aceitáveis: youtube_popular_content::001a1 gvp_popular_content::global_tier2 video_content::<ID>
Segmentação por canal: URLs: incluir	Não	string, list	Sim	Lista de URLs a serem incluídos na segmentação. A lista consiste em strings de URL. Formato da lista = (algumsite.com; algumsite2.com; etc.).
Segmentação por canal - URLs - Excluir	Não	string, list	Sim	Lista de URLs a serem excluídos da segmentação. A lista consiste em strings de URL. Formato da lista = (algumsite.com; algumsite2.com; etc.).
Segmentação por canal - Apps - Incluir	Não	string, list	Sim	Lista de apps para dispositivos móveis a serem excluídos da segmentação. A lista consiste em IDs de plataforma de app. O ID é fornecido pela plataforma relevante, como um ID do pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID do app da App Store da Apple (exemplo: 422689480). Formato da lista = (com.google.android.gm; 422689480; etc.).
Segmentação por canal - Apps - Excluir	Não	string, list	Sim	Lista de apps para dispositivos móveis a serem excluídos da segmentação. A lista consiste em IDs de plataforma de app. O ID é fornecido pela plataforma relevante, como um ID do pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID do app da App Store da Apple (exemplo: 422689480). Formato da lista = (com.google.android.gm; 422689480; etc.).
Segmentação por canal - Coleções de apps - Incluir	Não	string, list	Sim	Lista de coleções de apps a serem incluídas na segmentação. Formato da lista= ID da coleção de apps; ID da coleção de apps;
Segmentação por canal - Coleções de apps - Excluir	Não	string, list	Sim	Lista de coleções de apps a serem excluídas na segmentação. Formato da lista= ID da coleção de apps; ID da coleção de apps;
Segmentação demográfica por gênero	Sim	string, list	Sim	Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis: Feminino Masculino Desconhecido
Idade da segmentação demográfica	Sim	string, list	Sim	Lista de idades a serem segmentadas. Selecione um ou mais dos valores aceitáveis. 18-24 25 a 34 35 a 44 45 a 54 55-64 65+ Desconhecido
Segmentação demográfica: renda familiar	Sim	string, list	Sim	Lista de rendas familiares para segmentação. Selecione um ou mais dos valores aceitáveis. Os 10% com maior renda De 11% a 20% De 21% a 30% De 31% a 40% De 41% a 50% Os 50% com menor renda Desconhecido
Segmentação demográfica por status parental	Sim	string, list	Sim	Lista de status parentais a serem segmentados. Selecione um ou mais dos valores aceitáveis. Com filhos Sem filhos Desconhecido
Segmentação otimizada	Não	string	Sim	Ative a segmentação otimizada. TRUE FALSO A segmentação otimizada não é compatível com todas as estratégias de lances. Essa coluna precisa ser "FALSE" se: "Tipo de estratégia de lances" é "Fixa" "Tipo de estratégia de lances" é "vCPM otimizado" "Tipo de estratégia de lances" é "Máximo" e "Unidade de estratégia de lances" é "CIVA", "IVO_TEN" ou "AV_VIEWED"
Nível de expansão de público-alvo	Não	número inteiro	Sim	Nível de expansão do público-alvo. Ele só pode ser definido como "AdGroups" com valor 0, 1, 2 ou 3.
A lista de sugestão da expansão de público-alvo foi excluída	Não	string	Sim	Ativar a lista de sugestão da expansão de público-alvo excluída. TRUE FALSO
Segmentação por público-alvo: incluir	Não	string, list	Sim	Lista de listas de público-alvo a serem incluídas. Essa coluna usa IDs de recursos FirstPartyAndPartnerAudience da API Display & Video 360. Formato da lista = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por público-alvo: exclusão	Não	string, list	Sim	Lista de listas de público-alvo a serem excluídas. Essa coluna usa IDs de recursos FirstPartyAndPartnerAudience da API Display & Video 360. Formato da lista = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por público-alvo no mercado e de afinidade: incluir	Não	string, list	Sim	Lista de públicos-alvo de afinidade e/ou no mercado a serem incluídos. Os IDs das listas de público-alvo podem ser recuperados na interface do Display & Video 360. Formato da lista = (ID do público-alvo; ID do público-alvo; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por afinidade e no mercado - Excluir	Não	string, list	Sim	Lista de públicos-alvo de afinidade e/ou no mercado a serem excluídos. Os IDs das listas de público-alvo podem ser recuperados na interface do Display & Video 360. Formato da lista = (ID do público-alvo; ID do público-alvo; etc.). Essa lista é gerada em ordem numérica crescente.
Segmentação por lista personalizada	Não	string, list	Sim	Lista de listas personalizadas para segmentar. Essa coluna usa IDs de recursos CustomList da API Display & Video 360. Formato da lista = (CustomList.customListId; CustomList.customListId; etc.). Essa lista é gerada em ordem numérica crescente.