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

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

CampoObrigatórioTipoGravávelDescrição
ID do grupo de anúnciosObrigatório apenas ao editar grupos de anúncios existentesnúmero inteiroNãoValor 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. Como opção, ao criar novos grupos de anúncios, é possível usar um identificador personalizado com a finalidade de atribuir anúncios TrueView ao novo grupo de anúncios. O formato do identificador personalizado é "ext[identificador personalizado]", por exemplo, ext123. Quando o arquivo for enviado e processado, todos os identificadores personalizados serão substituídos por IDs atribuídos pelo DBM, e os objetos serão associados (por exemplo, Anúncio para grupo de anúncios) com base nos identificadores personalizados.
ID do item de linhaSimnúmero inteiroNãoÉ o valor do ID numérico do item de linha pai. É possível especificar um identificador personalizado (por exemplo, "ext[ID do item de linha personalizado]") para um item de linha criado ao mesmo tempo que esse grupo de anúncios.
Nome do item de linhaNãostringNãoNome do item de linha
NomeSimstringSimO nome da entrada.
StatusSimstringSimA configuração de status da entrada.
  • Ativo
  • Pausado
  • Excluído
Formato do anúncio em vídeoSimstringSimO formato do 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 lanceSimfloatSimO 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 do TrueView for CPV manual, ele será o custo máximo por visualização.

Observação: se a coluna "Tipo de estratégia de lances de TrueView" for "Maximizar conversões", "Maximizar o valor da conversão" ou "ROAS desejado", essa coluna precisará ser zero durante o upload.
Segmentação por palavra-chave - IncluirNãostring, listaSim

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: excluirNãostring, listaSim

Lista de strings de palavras-chave a serem excluídas da segmentação.

Essa lista é gerada em ordem alfabética crescente.

Segmentação por categoria: incluirNãostring, listaSim

Lista de categorias a serem incluídas na segmentação. Esta coluna usa campanhas da Rede de Display e IDs de recurso TargetingOption da API 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: excluirNãostring, listaSimLista de categorias a serem excluídas da segmentação. Esta coluna usa campanhas da Rede de Display e IDs de recurso TargetingOption da API 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 - IncluirNãostring, listaSimLista de canais do YouTube a serem incluídos.
Segmentação por canal - Canais do YouTube - ExcluirNãostring, listaSimLista de canais do YouTube a serem excluídos.
Segmentação por canal - Vídeos do YouTube - IncluirNãostring, listaSimLista de vídeos do YouTube a serem incluídos.
Segmentação por canal - Vídeos do YouTube - ExcluirNãostring, listaSimLista de vídeos do YouTube a serem excluídos.
Segmentação por canal - Conteúdo em alta - IncluirNãostring, listaSimLista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google a ser incluída. 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 - IncluirNãostring, listaSimLista de URLs a serem incluídos.
Segmentação por canal - URLs - ExcluirNãostring, listaSimLista de URLs a serem excluídos.
Segmentação por canal - Aplicativos - IncluirNãostring, listaSimLista de apps para dispositivos móveis a serem incluídos.
Segmentação por canal - Aplicativos - ExcluirNãostring, listaSimLista de apps para dispositivos móveis a serem excluídos.
Segmentação por canal – Coleções de apps – IncluirNãostring, listaSimLista de coleções de apps a serem incluídas na segmentação. List format= ID da coleção do app ID da coleção de apps
Segmentação por canal - Coleções de aplicativos - ExcluirNãostring, listaSimLista de coleções de apps a serem excluídas da segmentação. List format= ID da coleção do app ID da coleção de apps
Segmentação demográfica por gêneroSimstring, listaSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Segmentação demográfica IdadeSimstring, listaSimLista de faixas etárias para segmentação. Selecione um ou mais valores aceitáveis.
  • 18-24
  • 25 a 34
  • 35 a 44
  • 45 a 54
  • 55-64
  • 65+
  • Desconhecido
Segmentação demográfica por renda familiarSimstring, listaSimLista de rendas familiares para segmentar. Selecione um ou mais 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: status parentalSimstring, listaSimLista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação otimizadaNãostringSimAtive a segmentação otimizada.
  • VERDADEIRO
  • FALSO

A partir de 30 de setembro de 2024, a segmentação otimizada não será mais compatível com determinadas estratégias de lances. Este valor será atualizado de "TRUE" como "FALSE" se:
  • "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 do público-alvoNãonúmero inteiroSimNível de expansão do público-alvo. Ele só pode ser definido para grupos de anúncios com valor 0, 1, 2, 3.
A lista de origem de expansão de público-alvo foi excluídaNãostringSimA lista de origem da expansão de público-alvo foi excluída.
  • VERDADEIRO
  • FALSO
Segmentação por público-alvo – IncluirNãostring, listaSim

Lista de listas de público-alvo a serem incluídas.

Esta coluna usa campanhas da Rede de Display e IDs de recurso FirstAndThirdPartyAudience da API Video 360

Formato da lista = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por público-alvo: excluirNãostring, listaSim

Lista de listas de público-alvo a serem excluídas.

Esta coluna usa campanhas da Rede de Display e IDs de recurso FirstAndThirdPartyAudience da API Video 360

Formato da lista = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; etc.). Essa lista é gerada em ordem numérica crescente.

Afinidade e Segmentação no mercado - IncluirNãostring, listaSim

É uma lista de afinidades e/ou listas de público-alvo no mercado a serem incluídas.

Os IDs de lista de público-alvo podem ser recuperados na Interface do Video 360.

Formato da lista = (código do público-alvo, código do público-alvo etc.). Essa lista é gerada em ordem numérica crescente.

Afinidade e Segmentação no mercado: excluirNãostring, listaSim

Lista de listas de público-alvo no mercado e/ou afinidade a serem excluídas.

Os IDs de lista de público-alvo podem ser recuperados na Interface do Video 360.

Formato da lista = (código do público-alvo, código do público-alvo etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por lista personalizadaNãostring, listaSim

Lista de listas personalizadas para segmentar.

Esta coluna usa campanhas da Rede de Display e IDs de recurso CustomList da API Video 360

Formato da lista = (CustomList.customListId; CustomList.customListId; etc.). Essa lista é gerada em ordem numérica crescente.