Migração de scripts de extensão de anúncio

Importante :você pode continuar trabalhando com suas extensões atuais com base em feed usando a experiência legada de scripts do Google Ads. No entanto, as extensões com base em feeds ficarão indisponíveis em breve, e as extensões com base em recursos estarão disponíveis apenas na nova experiência de scripts do Google Ads. Recomendamos que você migre seus scripts legados do Google Ads para a nova experiência assim que possível.

Este documento descreve o processo de migração de scripts que acessam ou gerenciam extensões de anúncio. A partir de 28 de março de 2022, as extensões com base em feed dos clientes que usam scripts atualizando as extensões de anúncio vão ser migradas para novas extensões com base em recursos. A partir de 13 de maio de 2022, as extensões com base em feed dos clientes com scripts que buscam extensões de anúncio (e nenhum script atualizando as extensões de anúncio) vão ser migradas para novas extensões com base em recursos.

Visão geral

Observação :se você não tiver scripts que acessem ou atualizem as extensões de anúncio, não precisará fazer nada. Em vez disso, consulte o guia de extensões de anúncio.

O paradigma existente de extensões com base em feed foi descontinuado e substituído pelas extensões com base em recursos. As extensões com base em feed são chamadas de extensões "legadas" na interface do Google Ads. Já as extensões com base em recursos são chamadas de extensões "atualizadas" na interface do Google Ads.

A partir de 28 de março de 2022, as extensões com base em feed serão migradas para novas extensões baseadas em recursos. Após a migração, as extensões baseadas em feed deixarão de ser veiculadas. Este guia descreve a migração se você tem extensões de anúncio com base em feeds e em recursos na sua conta do Google Ads ou se há apenas extensões de anúncio com base em feeds na sua conta.

Detalhes da migração

Para começar a acessar ou atualizar as extensões de anúncio com base em recursos, você precisa usar a nova experiência de scripts do Google Ads. Para informações sobre a nova experiência de scripts do Google Ads, consulte o Guia explicativo.

Buscando extensões de anúncio

O conjunto atual de seletores de extensões de anúncio (por exemplo, SitelinkSelector) pode buscar extensões de anúncio com base em feeds ou em recursos. Por padrão, esses seletores retornam qualquer tipo de extensão de anúncio que esteja sendo veiculado no momento. A tabela a seguir resume o tipo de extensão de anúncio que está sendo veiculado no momento (e, portanto, será retornado por padrão):

Tipo de extensão de anúncio na conta
Somente extensões de anúncio com base em feeds	As extensões de anúncios com base em feeds serão retornadas por padrão
Somente extensões de anúncio com base em recursos	As extensões de anúncios com base em recursos serão retornadas por padrão.
Extensões de anúncio com base em feed e em recursos	As extensões de anúncios com base em recursos serão retornadas por padrão.

Depois que todas as extensões de anúncio com base em feeds forem migradas, todos os seletores de extensões de anúncio retornarão por padrão. Ainda será possível buscar extensões de anúncio com base em feeds usando o método withOnlyLegacy. Isso é útil para coletar métricas históricas.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

Na maioria dos casos, nenhuma mudança de código é necessária antes ou depois da migração das extensões de anúncios com base em feeds. No entanto, existem alguns cenários em que mudanças no código podem ser necessárias.

Como filtrar extensões de anúncio por ID

Quando uma extensão de anúncio com base em feeds for migrada, a extensão de anúncio com base em recursos correspondente terá um ID diferente. Isso significa que, se o script atualmente filtra extensões de anúncio por ID, ele não poderá buscar extensões de anúncio baseadas em recursos.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

Para resolver isso, filtre por um atributo diferente ou atualize seu código para usar os IDs das extensões de anúncio com base em recursos.

Como filtrar extensões de anúncio por estatísticas

Quando uma extensão de anúncio com base em feeds é migrada, as estatísticas dela são redefinidas. Considere isso ao filtrar as extensões de anúncio por estatísticas. Por exemplo, se você solicitar extensões de sitelink com Clicks > 100 em LAST_MONTH, poderá ver menos extensões de anúncio do que o normal se as extensões de anúncio com base em feed tiverem sido migradas recentemente.

Lembre-se também disso ao gerar relatórios de desempenho para suas extensões de anúncio. Seus relatórios poderão ter mudanças ou quedas significativas quando as extensões de anúncio com base em feed forem migradas.

Métodos obsoletos

Como parte da migração, não há mais suporte para vários campos. Por exemplo, as datas de início e término foram descontinuadas nas extensões de snippet. As chamadas para getStartDate() vão retornar null. Além disso, uma mensagem de aviso será registrada. Consulte a tabela a seguir para entender quais métodos foram descontinuados:

Turma	Métodos obsoletos
Frase de destaque	Nenhum método descontinuado
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
Preço	getEndDate getSchedules getStartDate
Sitelink	Nenhum método descontinuado
Snippet	getEndDate getSchedules getStartDate

Como atualizar extensões de anúncio

Como parte da migração, não há mais suporte para vários campos. Por exemplo, as datas de início e término foram descontinuadas nas extensões de snippet. Chamadas para setStartDate não afetarão a extensão de anúncio. Além disso, uma mensagem de aviso será registrada. Consulte a tabela a seguir para entender quais métodos foram descontinuados:

Turma	Métodos obsoletos
Frase de destaque	Nenhum método descontinuado
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
Preço	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Sitelink	Nenhum método descontinuado
Snippet	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

Como criar extensões de anúncio

Com o conjunto existente de criadores de extensões de anúncio (por exemplo, o SitelinkBuilder), é possível criar extensões de anúncio com base em feed ou em recursos. Por padrão, esses criadores criam o tipo de extensão de anúncio que estiver sendo veiculado no momento. A tabela a seguir resume o tipo de extensão de anúncio que está sendo exibido no momento (e, portanto, será criado por padrão):

Tipo de extensão de anúncio na conta
Somente extensões de anúncio com base em feeds	As extensões de anúncio com base em feeds serão criadas por padrão
Somente extensões de anúncio com base em recursos	As extensões de anúncio com base em recursos serão criadas por padrão
Extensões de anúncio com base em feed e em recursos	As extensões de anúncio com base em recursos serão criadas por padrão

Depois que um cliente migrar as extensões, todos os criadores de extensões de anúncio vão criar extensões de anúncio com base em recursos por padrão. Não haverá mais suporte à criação de extensões de anúncio com base em feeds, já que elas não serão mais veiculadas.

Se você quiser criar uma extensão com base em feed em vez de confiar no comportamento padrão, chame build(true) em vez de build(). Por exemplo:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

Se você quer criar uma extensão com base em recursos e atualmente sua conta só tem extensões com base em feed, aguarde até 28 de março ou chame build(false).

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

Campos não aceitos

Como parte da migração para a extensão de anúncio, o uso de alguns campos foi suspenso. Por exemplo, as datas de início e término foram descontinuadas nas extensões de snippet. Chamadas para withEndDate ou withStartDate não terão nenhum efeito na extensão. Em vez disso, uma mensagem de aviso será registrada. Consulte a tabela a seguir para entender quais métodos foram descontinuados em cada classe:

Turma	Métodos obsoletos
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate