O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

A funcionalidade de compartilhamento de anúncios será descontinuada na API Google Ads em janeiro de 2026

Quarta-feira, 9 de julho de 2025

O que muda?

O Google está descontinuando a funcionalidade de compartilhamento de anúncios na API Google Ads.

Com o lançamento da v23 em janeiro de 2026, a capacidade de criar anúncios compartilhados será removida de todas as versões compatíveis em 28 de janeiro de 2026.

O que está acontecendo? O recurso "Anúncios compartilhados" será encerrado no segundo trimestre de 2026.
Qual é o impacto? Os anúncios compartilhados originais vão deixar de ser veiculados nos grupos de anúncios "compartilhados".
Qual é a solução? Para garantir que seus anúncios continuem sendo veiculados, vamos criar automaticamente uma cópia individual de cada um deles. Essas novas cópias vão continuar sendo veiculadas como anúncios normais.
Quando? A data exata ainda não foi definida e será comunicada no futuro.

Essa mudança vai afetar a forma como os anúncios são criados e gerenciados em grande escala. Por isso, é fundamental entender as implicações e preparar seus sistemas de acordo. Vamos explicar o que está acontecendo, por que isso é importante e o que você precisa fazer.

Em termos simples, "compartilhamento de anúncios" significa criar um anúncio e usar esse mesmo anúncio em vários grupos de anúncios.

Em vez de criar anúncios idênticos repetidamente para cada grupo de anúncios, você cria um anúncio uma vez e o vincula onde for necessário.

Qual é o motivo da mudança?

Essa mudança está alinhada à transição para os anúncios baseados em recursos. O futuro do Google Ads está centrado em formatos de anúncio baseados em recursos, como anúncios responsivos de pesquisa (RSAs) e campanhas Performance Max. Nesses formatos, o "anúncio" é montado dinamicamente com base em um conjunto de recursos (títulos, descrições, imagens), o que torna o conceito de um objeto de anúncio estático e compartilhável menos eficiente.

Como se preparar

O cronograma dá tempo suficiente para você se adaptar, mas recomendamos que comece o processo agora para evitar interrupções nas suas operações de publicidade. Siga estas etapas para garantir uma transição tranquila.

Etapa 1: auditar o aplicativo

A primeira etapa é determinar se o aplicativo usa o modelo de compartilhamento de anúncios.

Revise sua base de código, especificamente qualquer lógica que interaja com o AdGroupAdService. Procure instâncias em que você criou um AdGroupAd apontando para o nome do recurso de um anúncio que já está em uso em outro grupo de anúncios.

Sua lógica atual, que será descontinuada em breve, pode ser conceitualmente semelhante a esta:

Crie um AdGroupAd que contenha um Ad.
Crie um AdGroup.
Crie outro AdGroupAd usando o Ad incorporado da etapa 1 e o AdGroup da etapa 2. (Essa é a funcionalidade que será removida).

Etapa 2: atualizar a lógica de criação de anúncios

Você precisa refatorar o código para criar um anúncio novo e exclusivo para cada grupo de anúncios. Em vez de compartilhar um anúncio, seu novo fluxo de trabalho deve ser um loop que cria um anúncio diferente para cada grupo de anúncios segmentado. Não será mais possível criar um anúncio independente. Em vez disso, você vai especificar os parâmetros de anúncio ao criar um AdGroup.

A nova lógica compatível vai ficar assim:

Para AdGroup_1:
- Crie um AdGroupAd usando ad for ad_group_1.
Para AdGroup_2:
- Crie um AdGroupAd usando ad for ad_group_2.

Mesmo que o texto do anúncio seja idêntico, os anúncios precisam ser criados como objetos separados na API.

Se você ainda tiver anúncios de texto expandidos (ETAs) legados sendo veiculados e compartilhados, converta-os em anúncios responsivos de pesquisa e atribua cada instância compartilhada a um único grupo de anúncios.

Etapa 3: entender o impacto nos relatórios

Quando você para de compartilhar um único anúncio e começa a criar anúncios exclusivos para cada grupo, o histórico de performance é afetado.

Importante: as estatísticas de performance (impressões, cliques, conversões) estão vinculadas ao anúncio exclusivo. Os novos anúncios que você criar vão começar sem histórico de performance. Os dados históricos dos seus anúncios antigos compartilhados vão permanecer, mas não serão transferidos para os novos.

Não se esqueça de comunicar isso à sua equipe ou aos seus clientes. Planeje exportar e arquivar dados históricos de performance antes de fazer a transição para realizar análises de longo prazo no nível do anúncio.

Migração de anúncios compartilhados

Etapa 1: identificar seus anúncios compartilhados

Primeiro, você precisa de uma lista definitiva de todos os anúncios que estão compartilhados em mais de um grupo.

SELECT
  ad_group_ad.ad.id,  -- This is the unique ID of the 'Ad' itself
  ad_group.id,        -- This is the unique ID of the 'AdGroup'
  ad_group_ad.status,
  ad_group_ad.ad.type,
  campaign.id,
  campaign.name,
  ad_group.name
FROM
  ad_group_ad
WHERE
  ad_group_ad.status IN ('ENABLED', 'PAUSED')
ORDER BY
  ad_group_ad.ad.id, ad_group.id

Se você encontrar um ad_group_ad.ad.id nos resultados em que a coleção associada de ad_group.ids tem mais de uma entrada, isso significa que o anúncio específico (identificado por ad_group_ad.ad.id) está vinculado a vários grupos de anúncios (cada um identificado por um ad_group.id exclusivo na coleção).

Se um ad_group.id estiver associado a mais de um ad_group.id, esse anúncio será considerado "compartilhado".

Etapa 2: coletar o conteúdo do anúncio e os grupos de anúncios associados

Para cada anúncio compartilhado que você identificou na Etapa 1, é necessário recuperar duas coisas:

O conteúdo do anúncio (títulos e descrições).
A lista de todos os grupos de anúncios em que ele está ativo.

Etapa 3: criar um ResponsiveSearchAd novo e exclusivo em cada grupo de anúncios

Para o núcleo da migração, faça um loop em cada grupo de anúncios identificado na Etapa 2 e crie um novo ResponsiveSearchAd dentro dele.

Prática recomendada: se o anúncio compartilhado for um anúncio de texto expandido, não copie apenas os três títulos e as duas descrições. Use-os como ponto de partida e adicione mais recursos. O poder dos ResponsiveSearchAds vem de um grande conjunto de títulos e descrições para o Google testar. Tente usar 5 títulos curtos, 1 título longo e 5 descrições.

Confira um resumo dos limites de ResponsiveSearchAds:

Tipo de recurso	Máximo permitido	Limite de caracteres	Práticas recomendadas
Título curto	Até 5	30 caracteres	Forneça todos os 5
Título longo	1	90 caracteres	Sempre forneça 1
Descrição	Até 5	90 caracteres	Forneça todos os 5

Confira um resumo conceitual da operação mutate usando AdGroupAdService:

Percorra cada ad_group.resource_name dos resultados da Etapa 2.
Dentro do loop, crie um novo objeto AdGroupAd.
Defina o campo ad_group como o ad_group.resource_name atual.
Crie um objeto Ad no AdGroupAd.
Preencha o campo responsive_search_ad com seus recursos:
- Crie uma lista de objetos AdTextAsset para seus títulos.
- Crie uma lista de objetos AdTextAsset para suas descrições.
- Defina final_urls, path1 e path3 usando os dados do anúncio antigo.
Execute a solicitação MutateAdGroupAds().

Esse processo garante que cada grupo de anúncios tenha um ResponsiveSearchAds exclusivo, pronto para ser veiculado.

Etapa 4: remover os anúncios compartilhados antigos

Depois que os novos ResponsiveSearchAds forem criados e passarem pela revisão editorial (o status é ENABLED), será hora de desativar os anúncios compartilhados.

Identifique o nome do recurso do AdGroupAd antigo (o link entre o anúncio compartilhado e o grupo de anúncios).
Use o AdGroupAdService para realizar a mutação. Nesse serviço, você vai criar um AdGroupAdOperation. Esse objeto de operação tem um campo de remoção em que você informa o nome do recurso do AdGroupAd que quer remover.
Por fim, chame o método mutateAdGroupAds no AdGroupAdService.

Cronograma para a desativação gradual dos anúncios compartilhados

Recomendamos que você migre manualmente seus anúncios compartilhados por conta própria.

Esta é a melhor abordagem. Ele permite criar anúncios com imagens e títulos exclusivos, adaptados especificamente ao público-alvo de cada grupo de anúncios. Anúncios mais relevantes geram resultados melhores.

Fase 1: a partir de 28 de janeiro de 2026

Não é mais possível criar anúncios compartilhados.
Qualquer tentativa de vincular um único anúncio a um novo grupo será bloqueada e vai retornar um erro. Se você usa ferramentas ou scripts automatizados para isso, eles vão parar de funcionar.

Fase 2: entre 28 de janeiro de 2026 e o 1º trimestre de 2027

Os anúncios compartilhados vão continuar sendo veiculados normalmente.
Não é necessário fazer nada no momento para os anúncios que já foram compartilhados. Eles não serão afetados durante esse período.

Fase 3: no 1º trimestre de 2027

Vamos converter automaticamente todos os anúncios compartilhados restantes.
Para os anúncios que ainda são compartilhados, vamos criar cópias individuais em cada grupo de anúncios a que eles pertencem.

Recomendamos consultar a documentação da API Google Ads oficial e acompanhar o blog para desenvolvedores do Google Ads para mais detalhes conforme a data se aproxima.

Comece sua auditoria hoje mesmo e compartilhe esta postagem com sua equipe de desenvolvimento para garantir que você esteja preparado para uma transição tranquila.

Processo automático no 2º trimestre de 2026

Se você não fizer nada, vamos separar automaticamente seus anúncios compartilhados no segundo trimestre de 2026.

Veja como nosso processo automatizado vai funcionar:

Um grupo de anúncios mantém o anúncio original: seu anúncio original será mantido em apenas um dos grupos de anúncios (especificamente, aquele com o menor ID de grupo de anúncios).
Outros grupos de anúncios recebem cópias: vamos criar novas cópias do anúncio original para todos os outros grupos de anúncios com que ele foi compartilhado.
O conteúdo automatizado será gerado novamente: suas configurações para recursos como "automação de recursos" serão copiadas. No entanto, os recursos gerados por máquina (como títulos ou imagens criados automaticamente) não serão transferidos. Nosso sistema vai criar um conjunto totalmente novo para cada anúncio copiado, o que pode afetar a performance inicial.

Se tiver dúvidas, entre em contato pelo fórum.

Bob Hancock, equipe da API Google Ads

Marcadores: google-ads-api

A funcionalidade de compartilhamento de anúncios será descontinuada na API Google Ads em janeiro de 2026 Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.