Dados estruturados - v10 - QA do grupo de anúncios

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

Este é um formato de arquivo QA. Os arquivos nesse formato são somente leitura e não podem ser enviados.

CampoTipoDescrição
ID do grupo de anúnciosnúmero inteiro
ID do item de linhanúmero inteiro
Nome do item de linhastringNome do item de linha
NomestringO nome da entrada.
StatusstringA configuração de status da entrada.
  • Ativo
  • Pausado
  • Arquivado
  • Excluído
  • Rascunho
Formato do anúncio em vídeostringO formato do anúncio do grupo de anúncios.

Selecione um dos seguintes valores:
  • In-stream
  • Vídeo In-feed
  • Bumper
  • Não pulável
  • Responsivo
  • Alcance eficiente
  • Áudio do YouTube
  • Geração de demanda
Custo do lancefloatO 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 TrueView". Por exemplo, se o 'Tipo de estratégia de lances TrueView' for 'CPV manual', será o custo máximo por visualização.

Observação: se a coluna 'Tipo de estratégia de lances TrueView' for 'Maximizar conversões', 'Maximizar o valor da conversão' ou 'Maximizar cliques', essa coluna precisará ser 0 ao fazer o upload.
Segmentação por palavras-chave: incluir QAstring, lista

Lista de strings de palavras-chave a serem incluídas na segmentação. Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação por palavras-chave: excluir QAstring, lista

Lista de strings de palavras-chave a serem excluídas na segmentação. Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação por categoria: incluir QAstring, listaLista de categorias a serem incluídas na segmentação. Formato da lista = (nome da categoria; nome da categoria; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por categoria: excluir QAstring, listaLista de categorias a serem excluídas na segmentação. Formato da lista = (nome da categoria; nome da categoria; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: canais do YouTube: incluir QAstring, listaLista de canais do YouTube a serem incluídos. Formato da lista = (nome do canal do YouTube; nome do canal do YouTube; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: canais do YouTube: excluir QAstring, listaLista de canais do YouTube a serem excluídos. Formato da lista = (nome do canal do YouTube; nome do canal do YouTube; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: vídeos do YouTube: incluir QAstring, listaLista de vídeos do YouTube a serem incluídos. Formato da lista = (nome do vídeo do YouTube; nome do vídeo do YouTube; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: vídeos do YouTube: excluir QAstring, listaLista de vídeos do YouTube a serem excluídos. Formato da lista = (nome do vídeo do YouTube; nome do vídeo do YouTube; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: conteúdo em alta: incluirstring, lista

Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google a serem incluídos. Os agrupamentos de conteúdo individuais precisam ter o formato estruturado 'video_content::ID do agrupamento de conteúdo'.

Formato da lista = (video_content::ID do agrupamento de conteúdo; video_content::ID do agrupamento de conteúdo; etc.).

Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo".

Segmentação por canal: conteúdo em alta: excluirstring, lista

Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google a serem excluídos. Os agrupamentos de conteúdo individuais precisam ter o formato estruturado 'video_content::ID do agrupamento de conteúdo'.

Formato da lista = (video_content::ID do agrupamento de conteúdo; video_content::ID do agrupamento de conteúdo; etc.).

Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo".

Segmentação por canal: URLs: incluirstring, lista

Lista de URLs a serem incluídos na segmentação. A lista consiste em strings de URL.

Formato da lista = (someurl.com; someurltwo.com; etc.).

Segmentação por canal: URLs: excluirstring, lista

Lista de URLs a serem excluídos na segmentação. A lista consiste em strings de URL.

Formato da lista = (someurl.com; someurltwo.com; etc.).

Segmentação por canal: apps: incluirstring, lista

Lista de apps para dispositivos móveis a serem excluídos na segmentação. A lista consiste em IDs de plataforma de apps.

O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de app da App Store da Apple (exemplo: 422689480).

Formato da lista = (com.google.android.gm; 422689480; etc.).

Segmentação por canal: apps: excluirstring, lista

Lista de apps para dispositivos móveis a serem excluídos na segmentação. A lista consiste em IDs de plataforma de apps.

O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de 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 QAstring, listaLista de coleções de apps a serem incluídas na segmentação. Formato da lista = (nome da coleção de apps; nome da coleção de apps; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por canal: coleções de apps: excluir QAstring, listaLista de coleções de apps a serem excluídas na segmentação. Formato da lista = (nome da coleção de apps; nome da coleção de apps; etc.). Essa lista é gerada em ordem alfabética.
Segmentação demográfica: gênerostring, listaLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Segmentação demográfica: idadestring, lista

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 familiarstring, lista

Lista de rendas familiares a serem segmentadas. Selecione um ou mais dos valores aceitáveis.

  • 10% com maior renda
  • 11-20%
  • De 21% a 30%
  • De 31% a 40%
  • De 41% a 50%
  • 50% com menor renda
  • Desconhecido
Segmentação demográfica: status parentalstring, lista

Lista de status parentais a serem segmentados. Selecione um ou mais dos valores aceitáveis.

  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação otimizadastringAtivar 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:
  • O "Tipo de estratégia de lances" for "Fixa"
  • O "Tipo de estratégia de lances" for "vCPM otimizado"
  • O "Tipo de estratégia de lances" for "Máximo" e a "Unidade de estratégia de lances" for "CIVA", "IVO_TEN" ou "AV_VIEWED"

Essa restrição também se aplica se o item de linha herdar uma das estratégias de lances acima do pedido de inserção pai. As estratégias de lances definidas no nível do pedido de inserção serão herdadas pelos itens de linha se a coluna "Otimização do pedido de inserção" estiver definida como "TRUE".

Nível de expansão do público-alvonúmero inteiroNível de expansão de público-alvo. Ele só pode ser definido para grupos de anúncios com valor 0, 1, 2 ou 3.
Lista de sugestão da expansão de público-alvo excluídastringAtivar a lista de origem da expansão de público-alvo excluída.
  • TRUE
  • FALSO
Segmentação por público-alvo: incluir QAstring, lista

Lista de públicos-alvo próprios e de terceiros a serem incluídos na segmentação.

Formato da lista = (nome do público-alvo; nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por público-alvo: excluir QAstring, lista

Lista de públicos-alvo próprios e de terceiros a serem excluídos na segmentação.

Formato da lista = (nome do público-alvo; nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por público-alvo semelhante: incluir QAstring, lista

Uma lista de públicos-alvo semelhantes a serem incluídos na segmentação.

Formato da lista = (nome do público-alvo semelhante; nome do público-alvo semelhante; etc.)

Segmentação por público-alvo semelhante: excluir QAstring, lista

Uma lista de públicos-alvo semelhantes a serem excluídos na segmentação.

Formato da lista = (nome do público-alvo semelhante; nome do público-alvo semelhante; etc.)

Segmentação por afinidade e no mercado: incluir QAstring, listaLista de públicos-alvo de afinidade e/ou no mercado a serem incluídos. Formato da lista = (nome do público-alvo; nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por afinidade e no mercado: excluir QAstring, lista
Segmentação por eventos importantes: incluir QAstring, lista

Uma lista de nomes de públicos-alvo de eventos importantes a serem incluídos na segmentação.

Formato da lista: nome do evento importante; nome do evento importante;

Segmentação por eventos importantes: excluir QAstring, lista

Uma lista de nomes de públicos-alvo de eventos importantes a serem excluídos na segmentação.

Formato da lista: nome do evento importante; nome do evento importante;

Segmentação demográfica detalhada: incluir QAstring, lista

Uma lista de nomes de públicos-alvo demográficos detalhados a serem incluídos na segmentação.

Formato da lista: nome demográfico detalhado; nome demográfico detalhado;

Segmentação demográfica detalhada: excluir QAstring, lista

Uma lista de nomes de públicos-alvo demográficos detalhados a serem excluídos na segmentação.

Formato da lista: nome demográfico detalhado; nome demográfico detalhado;

Segmentação por público-alvo combinado: QAstring, listaLista de públicos-alvo combinados a serem segmentados. Formato da lista = (nome do público-alvo; nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por lista personalizada: QAstring, listaLista de listas personalizadas a serem segmentadas. Formato da lista = (nome da lista personalizada; nome da lista personalizada; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por idioma: incluir QAstring, listaLista de idiomas a serem incluídos na segmentação. Formato da lista = (nome do idioma; nome do idioma; etc.). Essa lista é gerada em ordem alfabética.
Segmentação geográfica: incluir QAstring, listaLista de regiões geográficas a serem incluídas na segmentação. Formato da lista = (nome da região geográfica; nome da região geográfica; etc.). Essa lista é gerada em ordem alfabética.
Segmentação geográfica: excluir QAstring, listaLista de regiões geográficas a serem excluídas na segmentação. Formato da lista = (nome da região geográfica; nome da região geográfica; etc.). Essa lista é gerada em ordem alfabética.
Segmentação por lista de locais regionais: incluir QAstring, listaLista de nomes de listas de locais regionais a serem incluídos na segmentação. Uma entidade só pode segmentar duas listas de locais, incluindo listas de locais por proximidade. Formato da lista = (nome da lista de locais; nome da lista de locais;).
Segmentação por lista de locais regionais: excluir QAstring, listaLista de nomes de listas de locais regionais a serem excluídos na segmentação. Uma entidade só pode segmentar duas listas de locais, incluindo listas de locais por proximidade. Formato da lista = (nome da lista de locais; nome da lista de locais;).
Estratégia de origem de inventário da Geração de DemandastringEstratégia de origens de inventário da Geração de Demanda.
  • Todo o inventário do Google
  • Todo o inventário do Google e da Rede de Display
  • Inventários selecionados
Origens de inventário ativadas da Geração de Demandastring, listaOrigens de inventário ativadas da Geração de Demanda. Isso é usado quando a estratégia de origem de inventário não está definida.
Tipo de filtro de produtostring

A seleção da opção "Filtro de produto".

  • Todos os produtos
  • Produtos específicos
  • Rótulo personalizado
  • Nenhum produto
Configuração do filtro de produtostring, lista

A configuração do filtro de produto. Dependendo da seleção do "Tipo de filtro de produto", ele consiste em uma lista de IDs ou pares de chave-valor.

Se o "Tipo de filtro de produto" for "Produtos específicos", a lista vai conter IDs de produtos numéricos que podem ser encontrados no Google Merchant Center. Exemplo: (1; 2; 3; etc.).

Se o "Tipo de filtro de produto" for "Rótulo personalizado", a lista vai conter uma lista de pares de chave-valor em que as chaves são do formato "Rótulo personalizado [0-4]" e os valores são strings. Exemplo: (Rótulo personalizado 0: valor; Rótulo personalizado 1: valor; etc.)

Se o "Tipo de filtro de produto" for "Todos os produtos" ou "Nenhum produto", essa coluna precisará estar vazia.

ID da etapa da sequência de vídeonúmero inteiro

O ID da etapa da sequência a que esse grupo de anúncios pertence. A etapa precisa existir nos "Etapas da sequência de vídeo" do item de linha pai antes que esse grupo de anúncios seja criado.

Esse campo não pode ser modificado depois de definido.

Disponível apenas para grupos de anúncios de itens de linha "Sequência de vídeo".