Cómo migrar secuencias de comandos de extensiones de anuncios

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):

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:

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:

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):

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: