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úncios atuaisnú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 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 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 line item ID]") 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", 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 "Maximizar cliques", essa coluna deverá ser 0 ao fazer o upload.
Segmentação por palavras-chave: inclusãoNãostring, listSim

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 - ExcluirNãostring, listSim

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, listSim

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 - ExcluirNãostring, listSimLista 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.

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, listSim

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 - ExcluirNãostring, listSim

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, listSim

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, listSim

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 (incluir)Nãostring, listSim

Lista de conteúdo em alta no YouTube e no Google parceiros de vídeo para incluir. Cada agrupamento de conteúdo precisa 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 - ExcluirNãostring, listSim

Lista de conteúdo em alta no YouTube e no Google parceiros de vídeo para exclusão. Cada agrupamento de conteúdo precisa 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, listSim

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, listSim

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 - IncluirNãostring, listSim

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

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

Segmentação por canal - Apps - ExcluirNãostring, listSim

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

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, listSim

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 - ExcluirNãostring, listSim

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 demográfica por gêneroSimstring, listSimLista 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, listSim

Lista de idades 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: renda familiarSimstring, listSim

Lista de rendas familiares 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 demográfica por status parentalSimstring, listSim

Lista de status parentais a serem segmentados. 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"
Nível de expansão de público-alvoNãonúmero inteiroSim

Nível de expansão do 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 sugestão da expansão de público-alvo foi excluídaNãostringSim

Ativar a exclusão da lista de sugestão 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, listSim

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.

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, listSim

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.

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, listSim

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

Formato da lista: ID do público-alvo semelhante; ID do público-alvo semelhante;

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

Segmentação por público-alvo semelhante - ExcluirNãostring, listSim

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

Formato da lista: ID do público-alvo semelhante; ID do público-alvo semelhante;

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

Segmentação por público-alvo no mercado e de afinidade: incluirNãostring, listSim

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 - ExcluirNãostring, listSim

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, listSim

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, listSim

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, listSim

Lista de públicos-alvo segmentados por 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 - ExcluirNãostring, listSim

Lista de públicos-alvo segmentados por informações demográficas 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, listSim

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, listSim

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.

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

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

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.

Disponível somente 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, listSim

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.

Disponível somente 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 - ExcluirNãostring, listSim

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, listSimOrigens de inventário ativadas pela 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 "Filtro de produtos".

  • 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, listSim

A configuração do filtro de produtos. 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 de produtos numéricos 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 estão no 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 deve ficar vazia.

ID da etapa de 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 da sequência de vídeo" do item de linha principal antes da criação do grupo de anúncios.

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

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