Esta página foi traduzida pela API Cloud Translation.

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

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

Visão geral

O paradigma atual de extensões com base em feed foi descontinuado em favor de 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, enquanto as 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 vão ser migradas para as novas extensões com base em recursos. Depois da migração, as extensões com base em feed vão deixar de ser veiculadas. Neste guia, vamos descrever a migração, independentemente de você ter extensões de anúncio baseadas em feed e em recursos na sua conta do Google Ads ou apenas extensões de anúncio baseadas em feed.

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.

Como buscar extensões de anúncio

O conjunto atual de seletores de extensões de anúncios (por exemplo, o SitelinkSelector) pode buscar extensões de anúncios com base em feed ou em recursos. Por padrão, esses seletores vão retornar o tipo de extensão de anúncio que está sendo veiculado. A tabela a seguir resume o tipo de extensão de anúncio atualmente em veiculação (e, portanto, será retornada por padrão):

Tipo de extensões de anúncio na conta
Somente extensões de anúncios com base em feed	As extensões de anúncios com base em feed serão retornadas por padrão
Somente extensões de anúncios 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 feed forem migradas, todos os seletores de extensão de anúncio vão retornar extensões de anúncio baseadas em recursos por padrão. Ainda será possível buscar extensões de anúncios baseadas em feed pelo 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, não é necessário fazer mudanças no código antes ou depois da migração das extensões de anúncios com base em feed. No entanto, há alguns cenários em que mudanças no código podem ser necessárias.

Filtrar extensões de anúncio por ID

Quando uma extensão de anúncio baseada em feed é migrada, a extensão de anúncio baseada em recurso correspondente tem um ID diferente. Isso significa que, se o script atualmente filtrar extensões de anúncios por ID, não será possível buscar extensões de anúncios com base 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 esse problema, filtre por um atributo diferente ou atualize seu código para usar os IDs das extensões de anúncios baseadas em recursos.

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

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

Você também deve ter isso em mente ao gerar relatórios de desempenho para suas extensões de anúncio. Seus relatórios podem apresentar mudanças ou quedas significativas quando as extensões de anúncios baseadas em feed são migradas.

Métodos obsoletos

Como parte da migração, vários campos não são mais aceitos. 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, vários campos não são mais aceitos. 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`

Criar extensões de anúncio

O conjunto atual de criadores de extensões de anúncios (por exemplo, o SitelinkBuilder) pode criar extensões de anúncios baseadas em feed ou em recursos. Por padrão, esses builders vão criar qualquer tipo de extensão de anúncio que esteja sendo veiculado. A tabela a seguir resume o tipo de extensão de anúncio que está em veiculação no momento e, portanto, será criada por padrão:

Tipo de extensões de anúncio na conta
Somente extensões de anúncios com base em feed	As extensões de anúncio com base em feed serão criadas por padrão
Somente extensões de anúncios 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 as extensões de um cliente forem migradas, todos os editores de extensões de anúncios vão criar extensões de anúncios baseadas em recursos por padrão. A criação de extensões de anúncio com base no feed não será mais possível, já que elas não serão mais veiculadas.

Se você quiser criar uma extensão com base em feed em vez de depender do 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ê quiser criar uma extensão baseada em recursos e sua conta tiver apenas extensões baseadas em feed, aguarde até 28 de março ou ligue para 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 sem suporte

Como parte da migração da extensão de anúncio, alguns campos foram descontinuados. Por exemplo, as datas de início e término foram descontinuadas nas extensões de snippets. As 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 para 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`