Mudanças para apoiar a regulamentação de anúncios políticos na União Europeia na API Display & Video 360 e nos arquivos de dados estruturados

Quinta-feira, 21 de agosto de 2025

O que muda?

Conforme anunciado no ano passado, o Google vai parar de veicular propaganda política na União Europeia (UE) antes que uma nova regulamentação entre em vigor em outubro de 2025. A partir de 8 de setembro de 2025, a API Display & Video 360 e os arquivos de dados estruturados (SDFs) vão implementar restrições relacionadas a essa mudança. Se você usa um desses produtos para criar ou gerenciar itens de linha, talvez seja necessário atualizar seu aplicativo para lidar com essas restrições antes de 8 de setembro de 2025 para evitar uma interrupção do serviço.

Contexto

A partir de 8 de setembro de 2025, o Display & Video 360 vai exigir a autodeclaração para anúncios políticos da UE. Ao criar um item de linha, você precisa declarar se ele veiculará anúncios políticos da UE.

Também é possível fazer essa declaração para o anunciante como um todo. Essa declaração vai informar se algum item de linha do anunciante vai veicular anúncios políticos da UE. Faça a declaração no nível do anunciante usando a API Display & Video 360 ou nas configurações de Detalhes básicos do anunciante na interface do Display & Video 360 após o lançamento em 8 de setembro. Se você declarar que seu anunciante não veiculará anúncios políticos da UE, os novos itens de linha desse anunciante usarão essa declaração se outra não for fornecida, evitando uma interrupção do serviço.

A API Display & Video 360 e os arquivos de dados estruturados agora permitem declarar se um item de linha veicula anúncios políticos da UE. Um suporte semelhante para autodeclaração será lançado na interface do Display & Video 360 a partir de 8 de setembro de 2025.

API Display & Video 360

Na API Display & Video 360, o campo containsEuPoliticalAds foi adicionado aos seguintes objetos da API nas versões 3 e 4 para mostrar a autodeclaração em diferentes níveis de recursos:

  • LineItem para receber e definir a declaração no nível do item de linha.
  • Advertiser para receber e definir a declaração no nível do anunciante.

Os possíveis valores configuráveis para o campo são mostrados na tabela abaixo, com um significado relevante para o recurso ao qual ele é atribuído.

Valor
Significado
CONTAINS_EU_POLITICAL_ADVERTISING O recurso será usado para veicular anúncios políticos da UE.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING O recurso não será usado para veicular anúncios políticos da UE.

A partir de 8 de setembro de 2025, a API Display & Video 360 vai exigir que o campo containsEuPoliticalAds seja definido para recursos de itens de linha novos ou atuais ao atualizar a segmentação geográfica de itens de linha atuais.

O que eu preciso fazer?

Cada item de linha criado precisa de uma declaração válida usando o campo containsEuPoliticalAds.

Defina o campo containsEuPoliticalAds no objeto Advertiser usando o método advertisers.patch ou defina a declaração nas configurações de Detalhes básicos do anunciante na interface do Display & Video 360 quando ela estiver disponível. Se você definir o campo containsEuPoliticalAds como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING para o anunciante principal, os novos itens de linha vão usar esse valor, a menos que outro valor seja definido na criação, e o campo será preenchido para os itens de linha atuais em um dia. Esse campo pode ser atualizado usando a interface, a API ou os arquivos de dados estruturados.

Se o anunciante não estiver veiculando anúncios políticos da UE, declarar no nível do anunciante será suficiente para evitar erros. Se não for possível fazer a declaração no nível do anunciante ou se você tiver declarado que anúncios políticos da UE podem ser veiculados pelo anunciante, atualize o uso dos seguintes métodos de API:

Arquivos de dados estruturados

Nos arquivos de dados estruturados, lançamos a v9, que adiciona a coluna Contains EU Political Ads ao arquivo de item de linha. Isso permite recuperar e definir a declaração de anúncios políticos da UE no nível do item de linha. Essa coluna usa os valores YES e NO para representar a declaração do item de linha.

Com esse lançamento, também vamos descontinuar as versões 7.1, 8 e 8.1 do SDF. Recomendamos que você migre para a v9 assim que possível. Vamos oferecer suporte a essas versões até que elas sejam desativadas em março de 2026.

A partir de 8 de setembro de 2025, o Display & Video 360 vai exigir o uso da v9 para fazer upload de arquivos de dados estruturados e definir a coluna Contains EU Political Ads como YES ou NO para novas entradas de itens de linha do SDF. Se o anunciante tiver declarado que não vai veicular anúncios políticos da UE, você poderá continuar usando as versões anteriores para fazer upload de SDFs.

O que eu preciso fazer?

Cada item de linha criado vai precisar de uma declaração válida usando a coluna Contains EU Political Ads.

Defina o campo containsEuPoliticalAds no anunciante usando o método advertisers.patch da API Display & Video 360 ou defina a declaração nas configurações de Detalhes básicos do anunciante na interface do Display & Video 360 quando ela estiver disponível. Se você declarar que o anunciante não vai veicular anúncios políticos da UE, os novos itens de linha vão usar o valor NO para a coluna Contains EU Political Ads, a menos que outro valor seja definido na criação, e o campo será preenchido para os itens de linha atuais em um dia. Isso permite que você use as versões 7, 7.1, 8 ou 8.1 para o upload de SDF. Depois de criar o item de linha, esse campo pode ser atualizado usando a interface, a API ou os arquivos de dados estruturados.

Se não for possível fazer a declaração no nível do anunciante ou se você tiver declarado que anúncios políticos da UE podem ser veiculados pelo seu anunciante, faça o seguinte antes de 8 de setembro de 2025:

  • Migre para o SDF v9. Consulte nosso guia de migração para ver as instruções.
  • Defina a coluna Contains EU Political Ads como YES ou NO nas entradas de itens de linha no upload do SDF quando:
    • Criar itens de linha.
    • Atualizar qualquer uma das seguintes colunas do item de linha:
      • Geography Targeting - Include
      • Geography Targeting - Exclude
      • Geography Regional Location List Targeting - Include
      • Geography Regional Location List Targeting - Exclude
      • Proximity Targeting
      • Proximity Location List Targeting
    • Criar novos grupos de anúncios com colunas Geography Targeting definidas no item de linha atual.
    • Atualizar as colunas Geography Targeting dos grupos de anúncios no item de linha atual.

Além disso, se você usa arquivos de dados estruturados, migre para a v9 antes que todas as versões anteriores sejam desativadas em março de 2026.

Como faço para receber ajuda?

Entre em contato com os canais de suporte da API Display & Video 360 se tiver mais dúvidas sobre essa mudança.

Retrato do autor – Trevor Mulchay, Equipe de API do Display & Video 360

Rótulos: descontinuação, display-video-360-api, structured-data-files