Extensões dinâmicas

Além das extensões manuais, a API Google Ads é compatível com extensões baseadas em recursos automatizadas, também conhecidas como extensões dinâmicas. Como o nome indica, as extensões automáticas são gerenciadas automaticamente pelo Google Ads, e o escopo da API é limitado a pausar ou remover extensões individuais e recuperar estatísticas.

Criação e atualização de extensões

Se uma conta é ativada para esse recurso, o Google Ads cria extensões automáticas da seguinte maneira:

  1. Os recursos são criados para a extensão automática.
  2. Os objetos CampaignAsset, AdGroupAsset ou CustomerAsset são criados para associar a extensão a recursos do cliente, da campanha ou do grupo de anúncios, respectivamente.

Não é possível criar ou atualizar recursos automatizados usando a API Google Ads, nem criar CampaignAsset, AdGroupAsset ou CustomerAsset para as extensões automáticas usando a API Google Ads.

Use a versão 11 ou mais recente da API para pausar ou remover entidades CampaignAsset, AdGroupAsset ou CustomerAsset que associam a extensão de recurso automatizada ao recurso correspondente.

Pausar ou remover a associação

Se você pausar a associação, a extensão deixará de ser veiculada na entidade correspondente temporariamente. Depois que você pausar a associação, o Google Ads não reativará automaticamente nem veiculará a extensão automatizada correspondente nesse recurso até que ele seja reativado por meio da IU ou da API. Remova a associação para desativar permanentemente a associação da extensão à entidade.

O Google Ads impõe um limite no número de extensões automáticas de um determinado tipo que podem ser associadas a uma determinada entidade (por exemplo, sitelinks automáticos por campanha). Uma associação pausada conta para esse limite, enquanto uma associação removida não. As extensões automáticas não são contabilizadas nos limites das extensões adicionadas manualmente.

Recuperar extensões automáticas

Com a API v11 e mais recentes, os usuários podem recuperar extensões automáticas. É possível filtrar por AssetSource = AUTOMATICALLY_CREATED ao recuperar entidades Asset, CustomerAsset, CampaignAsset ou AdGroupAsset. No momento, os seguintes tipos de extensão automática são compatíveis:

  • Número
  • Sitelink
  • Snippet estruturado

Mais tipos de extensão poderão ser compatíveis no futuro.

Relatórios

As estatísticas de desempenho da extensão com base em recursos podem ser solicitadas no relatório asset_field_type_view. Este relatório inclui as estatísticas agregadas para as extensões automáticas e manuais.

As estatísticas de desempenho de extensões individuais podem ser recuperadas dos relatórios campaign_asset, customer_asset e ad_group_asset na versão v11 da API.