Dados estruturados - v9 - 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 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[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 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[ID do item de linha personalizado]") 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 da conversão' ou 'Maximizar cliques', essa coluna precisará ter o valor 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.

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

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

Lista de categorias a serem incluídas na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 TargetingOption 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 na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 TargetingOption 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, listaSim

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 canal: canais do YouTube: excluirNã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.).

Segmentação por canal: vídeos do YouTube: incluirNã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.).

Segmentação por canal: 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.).

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 serem incluídos. 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, listaSim

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

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

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

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

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 familiarSimstring, listaSim

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 parentalSimstring, listaSim

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

  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação otimizadaNãostringSimAtivar a segmentação otimizada.
  • TRUE
  • FALSE

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 principal. 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ãonúmero inteiroSimNí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ídaNãostringSimAtivar a lista de origem da expansão de público-alvo excluída.
  • TRUE
  • FALSE
Segmentação por público-alvo: incluirNãostring, listaSim

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

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

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

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

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

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úblico-alvo de afinidade e/ou no mercado a serem incluídas.

Os IDs da lista 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: excluirNãostring, listaSim

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

Os IDs da lista 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 personalizadaNãostring, listaSim

Lista de listas personalizadas a serem segmentadas.

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.

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.

Disponível apenas 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.

Disponível apenas 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, listaSim

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

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

Disponível apenas 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 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 demandaNãostring, listaSimOrigens de inventário ativadas da Geração de demanda. Isso é usado quando a estratégia de origem de 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