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 un flux ne seront bientôt plus disponibles, et les extensions basées sur des composants ne sont disponibles que dans la nouvelle interface Google Ads Scripts. 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. À partir du 28 mars 2022, les extensions basées sur des flux des clients qui utilisent des scripts pour mettre à jour les extensions d'annonces seront migrées vers de nouvelles extensions basées sur des composants. À compter du 13 mai 2022, les clients dont les scripts récupèrent des extensions d'annonce (et n'auront aucun script à mettre à jour des extensions d'annonce) migreront leurs extensions basées sur des flux vers de nouvelles extensions basées sur des composants.

Présentation

Remarque : Si vous n'avez aucun script qui accède aux extensions d'annonces ou les met à jour, aucune action n'est requise. Vous pouvez plutôt consulter le guide des extensions d'annonces.

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

À partir du 28 mars 2022, les extensions basées sur des flux seront migrées vers de nouvelles extensions basées sur des assets. Une fois migrées, les extensions basées sur des flux cesseront d'être diffusées. Ce guide décrit la migration, que vous disposiez à la fois d'extensions d'annonces basées sur des flux et sur des composants dans votre compte Google Ads, ou que vous n'ayez que des extensions d'annonces basées sur des flux dans votre compte.

Détails de la migration

Pour commencer à accéder ou à mettre à jour les extensions d'annonces basées sur des composants, vous devez utiliser la nouvelle interface 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) peut extraire des extensions d'annonces basées sur des flux ou des extensions d'annonces basées sur des composants. Par défaut, ces sélecteurs renvoient le type d'extension d'annonce actuellement diffusé. Le tableau suivant récapitule le type d'extension d'annonce actuellement diffusé (et qui sera donc renvoyé par défaut) :

Type d'extensions d'annonces du compte
Seules les extensions d'annonces basées sur les flux	Les extensions d'annonces basées sur un flux seront renvoyées par défaut
Seules les extensions d'annonce basées sur les composants	Les extensions d'annonces basées sur les composants seront renvoyées par défaut
Extensions d'annonces basées à la fois sur les flux et sur les composants	Les extensions d'annonces basées sur les composants seront renvoyées 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 renverront par défaut ce type d'extension. Vous pourrez toujours extraire les extensions d'annonces basées sur un 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 n'est nécessaire 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 un flux est migrée, l'extension d'annonce basée sur un composant correspondante aura un ID différent. Cela signifie que si votre script filtre actuellement les extensions d'annonces par ID, il ne pourra pas extraire les extensions d'annonces basées sur des composants.

// 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 filtrer par un attribut différent ou mettre à jour votre code pour utiliser les ID des extensions d'annonces basées sur les composants.

Filtrer les extensions d'annonces par statistiques

Lorsqu'une extension d'annonce basée sur des flux est migrée, ses statistiques sont réinitialisées. Vous devez en tenir compte lorsque vous filtrez les extensions d'annonce en fonction de statistiques. Par exemple, si vous demandez des extensions Lien annexe avec Clicks > 100 dans LAST_MONTH, vous verrez peut-être moins d'extensions d'annonces que d'habitude si vos extensions d'annonces basées sur un flux ont récemment été migrées.

Vous devez également en tenir compte lorsque vous générez des rapports sur les performances de vos extensions d'annonces. Vos rapports peuvent enregistrer des baisses ou des variations importantes lors de la migration de vos extensions d'annonce basées sur les flux.

Méthodes obsolètes

Plusieurs champs ne sont plus acceptés lors de 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 sera également consigné. Consultez le tableau suivant pour identifier les méthodes 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
Extrait	getEndDate getSchedules getStartDate

Modifier les extensions d'annonce

Plusieurs champs ne sont plus acceptés lors de 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 impact sur l'extension d'annonce. De plus, un message d'avertissement sera consigné. Consultez le tableau suivant pour comprendre quelles méthodes sont 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
Extrait	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

Créer des extensions d'annonce

L'ensemble existant d'outils de création d'extensions d'annonces (par exemple, SitelinkBuilder) permet de créer des extensions d'annonces basées sur des flux ou des extensions d'annonces basées sur des composants. Par défaut, ces outils de création 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 qui sera donc créé par défaut) :

Type d'extensions d'annonces du compte
Seules les extensions d'annonces basées sur les flux	Les extensions d'annonces basées sur les flux seront créées par défaut
Seules les extensions d'annonce basées sur les composants	Les extensions d'annonces basées sur les composants seront créées par défaut.
Extensions d'annonce basées sur les flux et sur les composants	Les extensions d'annonces basées sur les composants seront créées par défaut.

Une fois qu'un client aura migré ses extensions, tous les outils de création d'extensions d'annonce créeront par défaut des extensions d'annonce basées sur les composants. La création d'extensions d'annonces basées sur un flux ne sera plus possible, car elles ne seront plus diffusées.

Si vous souhaitez créer une extension basée sur un flux plutôt que de vous fier au comportement par défaut, vous pouvez le faire en appelant build(true) plutôt que 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 des composants et que votre compte ne comporte actuellement que des extensions basées sur des flux, vous pouvez attendre le 28 mars ou appeler 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'annonces, 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'ont aucun impact sur l'extension. Un message d'avertissement est plutôt enregistré. Consultez le tableau suivant pour identifier 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