Migration des scripts des extensions d'annonce

Important :Vous pouvez continuer à utiliser vos extensions actuelles basées sur des flux via l'ancienne interface des scripts Google Ads. Toutefois, les extensions basées sur des flux ne seront bientôt plus disponibles, et les extensions basées sur des assets ne sont disponibles que dans la nouvelle interface des scripts Google Ads. Nous vous recommandons de migrer vos anciens scripts Google Ads vers la nouvelle interface dès que possible.

Ce document décrit le processus de migration des scripts qui accèdent aux extensions d'annonce ou les gèrent. À compter du 28 mars 2022, les clients dont les scripts mettent à jour leurs extensions d'annonces migreront leurs extensions basées sur des flux vers de nouvelles extensions basées sur des assets. À partir du 13 mai 2022, les extensions basées sur des flux seront migrées vers de nouvelles extensions basées sur des assets pour les clients dont les scripts récupèrent des extensions d'annonces (et qui n'ont aucun script qui les met à jour).

Présentation

Remarque :Si vous ne disposez d'aucun script permettant d'accéder aux extensions d'annonce ou de les mettre à jour, aucune action de votre part n'est requise. Vous pouvez plutôt consulter le guide des extensions d'annonces.

Le paradigme existant basé sur les flux est abandonné au profit des extensions basées sur des éléments. Dans l'interface Google Ads, les extensions basées sur des flux sont appelées "anciennes" extensions, tandis que les extensions basées sur des composants sont appelées "extensions mises à jour" dans l'interface Google Ads.

À compter du 28 mars 2022, les extensions basées sur des flux seront migrées vers de nouvelles extensions basées sur des composants. Une fois la migration effectuée, elles cesseront d'être diffusées. Ce guide décrit la migration, que votre compte Google Ads comporte à la fois des extensions d'annonces basées sur les flux et sur les composants, ou si votre compte ne contient que des extensions basées sur des flux.

Détails de la migration

Pour accéder aux extensions d'annonces basées sur les assets ou les mettre à jour, vous devez utiliser la nouvelle interface des scripts Google Ads. Pour en savoir plus sur la nouvelle interface des scripts Google Ads, consultez le guide de démarrage.

Récupération des extensions d'annonce...

L'ensemble existant de sélecteurs d'extensions d'annonces (par exemple, SitelinkSelector) est capable d'extraire des extensions d'annonce basées sur des flux ou des composants. Par défaut, ces sélecteurs affichent le type d'extension d'annonce en cours de diffusion. Le tableau suivant récapitule le type d'extension d'annonce actuellement diffusée (et sera donc renvoyé par défaut):

Type d'extension d'annonce dans le compte
Uniquement les extensions d'annonce basées sur des flux	Les extensions d'annonce basées sur des flux s'afficheront par défaut
Uniquement les extensions d'annonce asset	Les extensions d'annonce basées sur des composants s'afficheront par défaut
Extensions d'annonce basées sur les flux et sur les composants	Les extensions d'annonce basées sur des composants s'afficheront par défaut

Une fois que toutes les extensions d'annonces basées sur des flux auront été migrées, tous les sélecteurs d'extensions d'annonce afficheront par défaut des extensions basées sur les composants. Il sera toujours possible d'extraire des extensions d'annonces basées sur des flux à l'aide de la méthode withOnlyLegacy. Cela est utile pour collecter des métriques historiques.

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

Dans la plupart des cas, aucune modification de code ne doit être requise avant ou après la migration des extensions d'annonces basées sur des flux. Toutefois, dans certains cas, des modifications de code peuvent être nécessaires.

Filtrer les extensions d'annonce par ID

Lorsqu'une extension d'annonce basée sur des flux est migrée, l'extension d'annonce basée sur des éléments correspondante possède un ID différent. Cela signifie que si votre script filtre actuellement les extensions d'annonce par ID, il ne pourra pas extraire les extensions d'annonces basées sur les assets.

// 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();

Pour résoudre ce problème, vous devez soit filtrer par un autre attribut, soit modifier votre code afin d'utiliser les ID des extensions d'annonces basées sur les composants.

Filtrage des extensions d'annonce en fonction des statistiques

Lorsqu'une extension d'annonce basée sur des flux est migrée, les statistiques de l'extension d'annonce basée sur des composants correspondante sont réinitialisées. Tenez-en compte lorsque vous filtrez les extensions d'annonce en fonction de statistiques. Par exemple, si vous demandez des extensions Liens annexes avec Clicks > 100 dans le LAST_MONTH, vous risquez d'afficher moins d'extensions d'annonces que d'habitude si vos extensions basées sur des flux ont été récemment migrées.

Tenez-en compte lorsque vous générez des rapports sur les performances de vos extensions d'annonces. Vos rapports peuvent constater des variations ou des baisses importantes lors de la migration de vos extensions d'annonces basées sur les flux.

Méthodes obsolètes

Plusieurs champs ne sont plus acceptés durant la migration. Par exemple, les dates de début et de fin ont été abandonnées dans les extensions d'extraits. Les appels à getStartDate() renvoient null. Un message d'avertissement est également consigné. Consultez le tableau suivant pour savoir quelles méthodes sont obsolètes:

Classe	Méthodes obsolètes
Accroche	Aucune méthode obsolète
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
Prix	getEndDate getSchedules getStartDate
Lien annexe	Aucune méthode obsolète
Snippet	getEndDate getSchedules getStartDate

Mise à jour des extensions d'annonce...

Plusieurs champs ne sont plus acceptés durant la migration. Par exemple, les dates de début et de fin ont été abandonnées dans les extensions d'extraits. Les appels à setStartDate n'auront aucun effet sur l'extension d'annonce. Un message d'avertissement est également consigné. Consultez le tableau suivant pour comprendre les méthodes obsolètes:

Classe	Méthodes obsolètes
Accroche	Aucune méthode obsolète
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
Prix	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Lien annexe	Aucune méthode obsolète
Snippet	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

Créer des extensions d'annonce

L'ensemble existant de compilateurs d'extensions d'annonce (par exemple, SitelinkBuilder) permet de créer des extensions d'annonce basées sur des flux ou des composants. Par défaut, ces compilateurs créent le type d'extension d'annonce actuellement diffusé. Le tableau suivant récapitule le type d'extension d'annonce actuellement diffusée (et sera donc créée par défaut):

Type d'extension d'annonce dans le compte
Uniquement les extensions d'annonce basées sur des flux	Les extensions d'annonce basées sur les flux seront créées par défaut
Uniquement les extensions d'annonce asset	Les extensions d'annonce basées sur des composants seront créées par défaut
Extensions d'annonce basées sur les flux et sur les composants	Les extensions d'annonce basées sur des composants seront créées par défaut

Une fois qu'un client a migré ses extensions, tous les outils de création d'extensions d'annonce créent par défaut des extensions d'annonce basées sur les composants. Il ne sera plus possible de créer des extensions basées sur des flux, car celles-ci ne seront plus diffusées.

Si vous souhaitez créer une extension basée sur des flux plutôt que d'utiliser le comportement par défaut, vous pouvez appeler build(true) au lieu de build(), par exemple:

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 vous souhaitez créer une extension basée sur les composants et que votre compte ne comporte actuellement que des extensions basées sur des flux, vous pouvez attendre le 28 mars ou appeler le 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();

Champs non compatibles

Lors de la migration des extensions d'annonce, certains champs ont été abandonnés. Par exemple, les dates de début et de fin ont été abandonnées dans les extensions d'extraits. Les appels à withEndDate ou withStartDate n'auront aucune incidence sur l'extension. Un message d'avertissement est alors consigné. Consultez le tableau suivant pour comprendre les méthodes obsolètes pour chaque classe:

Classe	Méthodes obsolètes
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate