En este documento, se describe el proceso de migración de las secuencias de comandos que acceden o administran extensiones de anuncio. A partir del 28 de marzo de 2022, los clientes con secuencias de comandos que actualicen el anuncio las extensiones basadas en feeds se migrarán a las nuevas extensiones extensiones. A partir del 13 de mayo de 2022, los clientes con secuencias de comandos que extensiones de anuncio (y ninguna secuencia de comandos que actualice las extensiones de anuncio) tendrá su feed de extensiones migradas a nuevas extensiones basadas en elementos.
Descripción general
El paradigma existente de extensiones basadas en el feed dejó de estar disponible y se reemplazó por extensiones basadas en recursos. Las extensiones basadas en feeds se denominan "heredadas". extensiones en la IU de Google Ads, mientras que las que se basan en recursos “Actualizado” en la IU de Google Ads.
A partir del 28 de marzo de 2022, las extensiones basadas en feeds se migrarán a las nuevas extensiones basadas en recursos: Una vez migradas, las extensiones basadas en feeds dejarán de publicarse. En esta guía, se describirá la migración, ya sea que hayas utilizado extensiones de anuncio basadas en recursos en tu cuenta de Google Ads o solo tienen anuncios extensiones de su cuenta.
Detalles de la migración
Para comenzar a acceder a las extensiones de anuncios basadas en recursos o actualizarlas, debes usar la nueva experiencia de secuencias de comandos de Google Ads. Para obtener información sobre la nueva experiencia de Google Ads, de secuencias de comandos, consulta el artículo Cómo comenzar de la guía de YouTube.
Recuperando extensiones de anuncio
El conjunto existente de selectores de extensiones de anuncio (por ejemplo, el
SitelinkSelector
Deben ser capaces de recuperar extensiones de anuncios basadas en feeds o basadas en recursos.
extensiones. De forma predeterminada, estos selectores mostrarán cualquier tipo de anuncio
se está publicando la extensión. En la siguiente tabla, se resume el tipo de anuncio
extensión que se está publicando actualmente (y, por lo tanto, se mostrará de forma predeterminada):
Tipo de extensiones de anuncio en la cuenta | |
---|---|
Solo extensiones de anuncio basadas en el feed | Las extensiones de anuncio basadas en el feed se muestran de forma predeterminada |
Solo extensiones de anuncio basadas en recursos | Las extensiones de anuncio basadas en elementos se mostrarán de forma predeterminada |
Extensiones de anuncio basadas en feeds y basadas en recursos | Las extensiones de anuncio basadas en elementos se mostrarán de forma predeterminada |
Después de que se hayan migrado todas las extensiones de anuncios basadas en el feed, todas
selectores mostrarán extensiones de anuncio basadas en elementos de forma predeterminada. Seguirá siendo
posible recuperar extensiones de anuncio basadas en el feed mediante el método withOnlyLegacy
. Esta
es útil para recopilar métricas históricas.
// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();
En la mayoría de los casos, no es necesario realizar cambios en el código antes ni después de los anuncios basados en feeds se migraron las extensiones. Sin embargo, hay algunas situaciones en las que el código podrían requerirse cambios.
Cómo filtrar extensiones de anuncio por ID
Cuando se migra una extensión de anuncio basada en un feed, el anuncio basado en elementos correspondiente tendrá un ID diferente. Esto significa que si tu secuencia de comandos filtra extensiones de anuncio por ID, no podrá recuperar anuncios basados en elementos extensiones.
// 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 solucionar esto, debes filtrar por un atributo diferente o actualizar su código para usar las extensiones de anuncio basadas en elementos en su lugar.
Cómo filtrar extensiones de anuncio por estadísticas
Cuando se migra una extensión de anuncio basada en un feed, el anuncio basado en elementos correspondiente
las estadísticas de esa extensión se restablecerán. Debes tener esto en cuenta
cuando filtre las extensiones de anuncio por estadísticas. Por ejemplo, si solicitas un vínculo a sitio
extensiones con Clicks > 100
en LAST_MONTH
, podría ver menos anuncio
de lo normal si sus extensiones de anuncio basadas en el feed se migraron recientemente.
También debes tener esto en cuenta al generar informes de rendimiento para tus extensiones de anuncio. Tus informes podrían ver cambios o disminuciones significativos cuando tus se migran extensiones de anuncio basadas en feeds.
Métodos obsoletos
Como parte de la migración, varios campos ya no son compatibles. Por ejemplo:
las fechas de inicio y finalización ya no están disponibles en las extensiones de fragmentos. Llamadas a
getStartDate()
mostrará null
. Además, se mostrará un mensaje de advertencia
registrado. Consulta la siguiente tabla para comprender qué métodos dejaron de estar disponibles:
Clase | Métodos obsoletos |
---|---|
Texto destacado | No hay métodos obsoletos |
Aplicación para dispositivos móviles | getSchedules |
Númerotelefónico | getEndDate getStartDate |
Precio | getEndDate getSchedules getStartDate |
Vínculo de sitio | No hay métodos obsoletos |
Fragmento | getEndDate getSchedules getStartDate |
Actualizando extensiones de anuncio
Como parte de la migración, varios campos ya no son compatibles. Por ejemplo:
las fechas de inicio y finalización ya no están disponibles en las extensiones de fragmentos. Llamadas a
setStartDate
no afectará la extensión de anuncio. Además, se incluye una advertencia
el mensaje de registro. Consulta la siguiente tabla para comprender cuáles son
obsoleto:
Clase | Métodos obsoletos |
---|---|
Texto destacado | No hay métodos obsoletos |
Aplicación para dispositivos móviles | setSchedules |
Númerotelefónico | clearEndDate clearStartDate setEndDate setStartDate |
Precio | clearEndDate clearStartDate setEndDate setSchedules setStartDate |
Vínculo de sitio | No hay métodos obsoletos |
Fragmento | clearEndDate clearStartDate setEndDate setSchedules setStartDate |
Cómo crear extensiones de anuncio
el conjunto existente de creadores de extensiones de anuncio (por ejemplo, el
SitelinkBuilder
Pueden crear extensiones de anuncios basadas en feeds o basadas en recursos
extensiones. De forma predeterminada, estos creadores crearán cualquier tipo de anuncio
se está publicando la extensión. En la siguiente tabla, se resume el tipo de anuncio
que se está publicando actualmente (y, por lo tanto, se creará de forma predeterminada):
Tipo de extensiones de anuncio en la cuenta | |
---|---|
Solo extensiones de anuncio basadas en el feed | Las extensiones de anuncio basadas en el feed se crean de forma predeterminada |
Solo extensiones de anuncio basadas en recursos | Las extensiones de anuncio basadas en elementos se crearán de forma predeterminada |
Extensiones de anuncio basadas en feeds y basadas en recursos | Las extensiones de anuncio basadas en elementos se crearán de forma predeterminada |
Después de que un cliente migre sus extensiones, todos los creadores de extensiones de anuncios crear extensiones de anuncio basadas en recursos de forma predeterminada. Creación de un anuncio basado en el feed ya no se admitirán extensiones de anuncio, ya que las extensiones de anuncio basadas en feeds publicar anuncios durante más tiempo.
Si desea crear una extensión basada en feeds en lugar de utilizar la configuración
comportamiento, puedes hacerlo llamando a build(true)
, en lugar de build()
, para
ejemplo:
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();
Si desea crear una extensión basada en elementos y su cuenta actualmente solo está disponible
tiene extensiones basadas en el feed, puede esperar hasta el 28 de marzo o llamar
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 no admitidos
Como parte de la migración de extensiones de anuncio, algunos campos dejaron de estar disponibles. Para
ejemplo, las fechas de inicio y de finalización dejaron de estar disponibles en las extensiones de fragmentos.
Las llamadas a withEndDate
o withStartDate
no afectarán de ninguna manera el
extensión), en su lugar, se registrará un mensaje de advertencia. Consulta lo siguiente
a fin de comprender qué métodos dejaron de estar disponibles para cada clase:
Clase | Métodos obsoletos |
---|---|
CalloutBuilder | withMobilePreferred |
MobileAppBuilder | withMobilePreferred withSchedules |
PhoneNumberBuilder | withEndDate withMobilePreferred withStartDate |
PriceBuilder | withEndDate withMobilePreferred withSchedules withStartDate |
SitelinkBuilder | withMobilePreferred |
SnippetBuilder | withEndDate withMobilePreferred withSchedules withStartDate |