Dados estruturados - v9.2 - Grupo de anúncios

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

CampoObrigatórioTipoGravávelDescrição
ID do grupo de anúnciosObrigatório apenas ao editar grupos de anúnciosnúmero inteiroNã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 de um identificador personalizado é "ext[identificador personalizado]", 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 a 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 principal. Você pode especificar um identificador personalizado (por exemplo, "ext[custom ID do item de linha]") para um item de linha criado ao mesmo tempo que este 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 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 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 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 de Conversão" ou "Maximizar cliques", essa coluna precisará ser 0 ao fazer o upload.
Segmentação por palavras-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.

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

Segmentação por palavras-chave: exclusãoNãostring, listaSim

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

Essa lista é gerada em ordem alfabética crescente.

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

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

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.

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

Segmentação por categoria: exclusãoNãostring, listaSimLista de categorias a serem excluídas da 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.

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

Segmentação por canal: canais do YouTube: incluirNãostring, listaSim

Lista de canais do YouTube a serem incluídos.

Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.).

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

Segmentação por posição: canais do YouTube (excluir)Nãostring, listaSim

Lista de canais do YouTube a serem excluídos.

Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.).

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

Segmentação por canal: vídeos do YouTube (incluir)Nãostring, listaSim

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.).

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

Segmentação por posição: vídeos do YouTube: excluirNãostring, listaSim

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.).

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

Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google para incluir. Cada agrupamento de conteúdo individual deve ter o 'video_content::ID do agrupamento de conteúdo' estruturado.

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 (excluir)Nãostring, listaSim

Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google para exclusão. Cada agrupamento de conteúdo individual deve ter o 'video_content::ID do agrupamento de conteúdo' estruturado.

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

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.).

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

Segmentação por canal: URLs - ExcluirNãostring, listaSim

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.).

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

Segmentação por canal: apps (incluir)Nãostring, listaSim

Lista de apps para dispositivos móveis a serem excluídos da 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.).

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

Segmentação por canal: apps (excluir)Nãostring, listaSim

Lista de apps para dispositivos móveis a serem excluídos da 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.).

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

Segmentação por canal - Coleções de apps - IncluirNãostring, listaSim

Lista de coleções de apps 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_APP_CATEGORY.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

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

Segmentação por canal: coleções de apps (excluir)Nãostring, listaSim

Lista de coleções de apps a serem excluídas da segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_APP_CATEGORY.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

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

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

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

Idade da segmentação demográficaSimstring, listaSim

Lista de faixas etárias a serem segmentadas. Selecione um ou mais dos valores aceitáveis.

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

Segmentação demográfica por renda familiarSimstring, listaSim

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

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

Segmentação demográfica por status parentalSimstring, listaSim

Lista de status parentais para segmentação. Selecione um ou mais dos valores aceitáveis.

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

Segmentação otimizadaNãostringSimAtive 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"

Essa restrição também se aplica se o item de linha herdar uma das estratégias de lances acima da ordem de inserção mãe. 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 de público-alvoNãonúmero inteiroSim

Nível de expansão de público-alvo.

Só pode ser definido como "AdGroups" com valor 0, 1, 2 ou 3.

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

A lista de origem da expansão de público-alvo foi excluídaNãostringSim

Ative a exclusão da seedlist da expansão de público-alvo.

  • TRUE
  • FALSO

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

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

Lista de públicos-alvo a serem incluídos.

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.

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

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

Lista de públicos-alvo a serem excluídos.

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.

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

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

Uma lista de públicos-alvo semelhantes para incluir na segmentação.

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 semelhante; ID do público-alvo semelhante; etc.)

Disponível apenas para grupos de anúncios da Geração de demanda.

Segmentação por público-alvo semelhante: exclusãoNãostring, listaSim

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

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 semelhante; ID do público-alvo semelhante; etc.)

Disponível apenas para grupos de anúncios da Geração de demanda.

Segmentação por afinidade e no mercado: incluirNãostring, listaSim

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.

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

Segmentação por afinidade e no mercado: exclusãoNãostring, listaSim

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.

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

Segmentação por eventos importantes: incluirNãostring, listaSim

Lista de públicos-alvo de eventos importantes 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.

Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda".

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

Segmentação por eventos importantes: exclusãoNãostring, listaSim

Lista de públicos-alvo de eventos importantes 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.

Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda".

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

Segmentação por informações demográficas detalhadas: incluirNãostring, listaSim

Lista de públicos-alvo com informações demográficas detalhadas 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.

Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda".

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

Segmentação por informações demográficas detalhadas: exclusãoNãostring, listaSim

Lista de públicos-alvo de demonstrações detalhadas 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.

Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda".

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

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

Lista de públicos-alvo combinados a serem segmentados.

Essa coluna usa IDs de recursos CombinedAudience da API Display & Video 360.

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

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

Segmentação por lista personalizadaNãostring, listaSim

Lista de listas personalizadas para segmentação.

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.

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

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

Lista de idiomas a serem incluídos na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_LANGUAGE.

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

Só disponível se as seguintes condições forem atendidas:

  • A coluna "Formato do anúncio em vídeo" está definida como "Geração de demanda"
  • O item de linha principal tem um nível de segmentação geográfica e por idioma definido como grupo de anúncios na interface
Segmentação geográfica: incluirNãostring, listaSim

Lista de regiões geográficas 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_GEO_REGION.

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

Só disponível se as seguintes condições forem atendidas:

  • A coluna "Formato do anúncio em vídeo" está definida como "Geração de demanda"
  • O item de linha principal tem um nível de segmentação geográfica e por idioma definido como grupo de anúncios na interface
Segmentação geográfica: exclusãoNãostring, listaSim

Lista de regiões geográficas a serem excluídas da segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_GEO_REGION.

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

Só está disponível se as seguintes condições forem atendidas:
  • A coluna "Formato do anúncio em vídeo" está definida como "Geração de demanda"
  • O item de linha principal tem um nível de segmentação geográfica e por idioma definido como grupo de anúncios na interface
Estratégia de origem de inventário da Geração de DemandaSim para grupos de anúncios da Geração de demandastringSimEstratégia de fontes de inventário da Geração de Demanda.
  • Todo o inventário do Google
  • Todo o inventário da Rede de Display do Google
  • Inventários selecionados
Origens de inventário ativadas para a Geração de demandaNãostring, listaSimFontes de inventário ativadas para a Geração de demanda. Isso é usado quando a estratégia de origem do inventário não está definida.
  • Anúncios puláveis do YouTube
  • Anúncios in-feed do YouTube
  • Anúncios do YouTube Shorts
  • Gmail
  • Discover
  • Rede de Display do Google
Tipo de filtro de produtoObrigatório quando o "ID da conta do Merchant Center" está definido para o item de linha principalstringSim

A seleção da opção de filtro de produto.

  • Todos os produtos
  • Produtos específicos
  • Rótulo personalizado
  • Nenhum produto
Configuração de filtro de produtoObrigatório quando o "Tipo de filtro de produto" é "Produtos específicos" ou "Rótulo personalizado".string, listaSim

A configuração do filtro de produto. Dependendo da seleção de "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 numéricos de produtos que podem ser encontrados no Google Merchant Center. Exemplo: (1; 2; 3; etc.).

Se "Tipo de filtro de produto" for "Rótulo personalizado", a lista vai conter pares de chave-valor em que as chaves são do tipo "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 vai ficar vazia.

ID da etapa da sequência de vídeoObrigatório quando o subtipo do item de linha principal é "Sequência de vídeo"número inteiroSim

O ID da etapa da sequência a que este grupo de anúncios pertence. A etapa precisa estar em "Etapas de sequência de vídeo" do item de linha principal antes da criação do grupo de anúncios.

Esse campo é imutável depois de definido.

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