Questa pagina è stata tradotta dall'API Cloud Translation.

Migrazione degli script delle estensioni annuncio

Questo documento descrive il processo di migrazione per gli script che accedono o gestiscono le estensioni annuncio. A partire dal 28 marzo 2022, per i clienti con script che aggiornano le estensioni annuncio verrà eseguita la migrazione delle estensioni basate su feed alle nuove estensioni basate su asset. A partire dal 13 maggio 2022, per i clienti che utilizzano script che recuperano le estensioni annuncio (e nessuno script aggiorna le estensioni annuncio) verrà eseguita la migrazione delle estensioni basate su feed alle nuove estensioni basate su asset.

Panoramica

L'attuale paradigma delle estensioni basate su feed è stato ritirato e sostituito con le estensioni basate su asset. Le estensioni basate su feed sono definite estensioni "legacy" nell'interfaccia utente di Google Ads, mentre quelle basate su asset sono definite estensioni "Upgrade eseguito" nell'interfaccia utente di Google Ads.

A partire dal 28 marzo 2022 verrà eseguita la migrazione delle estensioni basate su feed alle nuove estensioni basate su asset. Una volta eseguita la migrazione, le estensioni basate su feed non verranno più pubblicate. Questa guida illustra la migrazione, indipendentemente dal fatto che nel tuo account Google Ads siano presenti sia estensioni annuncio basate su feed sia basate su asset o solo estensioni annuncio basate sui feed.

Dettagli migrazione

Per iniziare ad accedere alle estensioni annuncio basate su asset o ad aggiornarle, devi utilizzare la nuova esperienza con gli script Google Ads. Per informazioni sulla nuova esperienza relativa agli script di Google Ads, consulta la Guida introduttiva.

Recupero estensioni annuncio

L'insieme esistente di selettori delle estensioni annuncio, ad esempio SitelinkSelector, è in grado di recuperare le estensioni annuncio basate su feed o le estensioni annuncio basate su asset. Per impostazione predefinita, questi selettori restituiscono il tipo di estensione annuncio attualmente pubblicato. La seguente tabella riassume il tipo di estensione annuncio attualmente pubblicata (e che verrà quindi restituita per impostazione predefinita):

Tipo di estensioni annuncio nell'account
Solo le estensioni annuncio basate su feed	Per impostazione predefinita, verranno restituite le estensioni annuncio basate sui feed
Solo estensioni annuncio basate su asset	Per impostazione predefinita, verranno restituite le estensioni annuncio basate su asset
Estensioni annuncio basate su feed e basate su asset	Per impostazione predefinita, verranno restituite le estensioni annuncio basate su asset

Una volta eseguita la migrazione di tutte le estensioni annuncio basate su feed, tutti i selettori delle estensioni annuncio restituiranno estensioni annuncio basate su asset per impostazione predefinita. Sarà comunque possibile recuperare le estensioni annuncio basate su feed utilizzando il metodo withOnlyLegacy. È utile per raccogliere metriche storiche.

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

Nella maggior parte dei casi, non è necessario apportare modifiche al codice prima o dopo la migrazione delle estensioni annuncio basate su feed. Tuttavia, esistono alcuni scenari in cui potrebbe essere necessario modificare il codice.

Filtrare le estensioni annuncio per ID

Quando viene eseguita la migrazione di un'estensione annuncio basata su feed, la corrispondente estensione annuncio basata su asset avrà un ID diverso. Ciò significa che, se al momento lo script filtra le estensioni annuncio per ID, non sarà in grado di recuperare le estensioni annuncio basate su asset.

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

Per risolvere questo problema, devi filtrare in base a un attributo diverso o aggiornare il codice in modo da utilizzare gli ID delle estensioni annuncio basate su asset.

Filtrare le estensioni annuncio in base alle statistiche

Quando viene eseguita la migrazione di un'estensione annuncio basata su feed, le statistiche dell'estensione annuncio basata su asset corrispondente vengono reimpostate. Tieni presente questo aspetto quando filtri le estensioni annuncio in base alle statistiche. Ad esempio, se richiedi estensioni sitelink con Clicks > 100 in LAST_MONTH, potresti vedere meno estensioni annuncio del normale se hai eseguito di recente la migrazione delle estensioni annuncio basate su feed.

Tieni presente questo aspetto anche quando generi report sul rendimento per le estensioni annuncio. I report potrebbero registrare variazioni o diminuzioni significative quando viene eseguita la migrazione delle estensioni annuncio basate su feed.

Metodi deprecati

Nell'ambito della migrazione, diversi campi non sono più supportati. Ad esempio, le date di inizio e di fine sono state ritirate dalle estensioni snippet. Le chiamate al numero getStartDate() restituiranno null. Verrà inoltre registrato un messaggio di avviso. Consulta la seguente tabella per capire quali metodi sono stati ritirati:

Classe	Metodi deprecati
Callout	Nessun metodo obsoleto
MobileApp	`getSchedules`
PhoneNumber	`getEndDate` `getStartDate`
Prezzo	`getEndDate` `getSchedules` `getStartDate`
Sitelink	Nessun metodo obsoleto
Snippet	`getEndDate` `getSchedules` `getStartDate`

Aggiornamento delle estensioni annuncio

Nell'ambito della migrazione, diversi campi non sono più supportati. Ad esempio, le date di inizio e di fine sono state ritirate dalle estensioni snippet. Le chiamate a setStartDate non avranno effetto sull'estensione annuncio. Verrà inoltre registrato un messaggio di avviso. Consulta la seguente tabella per capire quali metodi vengono deprecati:

Classe	Metodi deprecati
Callout	Nessun metodo obsoleto
MobileApp	`setSchedules`
PhoneNumber	`clearEndDate` `clearStartDatesetEndDate` `setStartDate`
Prezzo	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`
Sitelink	Nessun metodo obsoleto
Snippet	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`

Creazione di estensioni annuncio

L'insieme esistente di strumenti per la creazione di estensioni annuncio (ad esempio, SitelinkBuilder) è in grado di creare estensioni annuncio basate su feed o estensioni annuncio basate su asset. Per impostazione predefinita, questi strumenti per la creazione creano qualsiasi tipo di estensione annuncio attualmente pubblicato. La seguente tabella riassume il tipo di estensione annuncio attualmente pubblicata (e che verrà creata per impostazione predefinita):

Tipo di estensioni annuncio nell'account
Solo le estensioni annuncio basate su feed	Le estensioni annuncio basate sui feed verranno create per impostazione predefinita
Solo estensioni annuncio basate su asset	Per impostazione predefinita, verranno create estensioni annuncio basate su asset
Estensioni annuncio basate su feed e basate su asset	Per impostazione predefinita, verranno create estensioni annuncio basate su asset

Una volta eseguita la migrazione delle estensioni per un cliente, tutti gli strumenti per la creazione di estensioni annuncio creeranno estensioni annuncio basate su asset per impostazione predefinita. La creazione di estensioni annuncio basate su feed non sarà più supportata perché quelle basate su feed non verranno più pubblicate.

Se vuoi creare un'estensione basata sul feed anziché affidarti al comportamento predefinito, puoi farlo chiamando build(true) anziché build(), ad esempio:

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 vuoi creare un'estensione basata sugli asset e al momento il tuo account dispone solo di estensioni basate su feed, puoi attendere il 28 marzo o chiamare il numero 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();

Campi non supportati

Nell'ambito della migrazione delle estensioni annuncio, alcuni campi sono stati ritirati. Ad esempio, le date di inizio e di fine sono state ritirate dalle estensioni snippet. Le chiamate a withEndDate o withStartDate non avranno alcun effetto sull'estensione, verrà invece registrato un messaggio di avviso. Consulta la seguente tabella per capire quali metodi sono deprecati per ogni classe:

Classe	Metodi deprecati
CalloutBuilder	`withMobilePreferred`
MobileAppBuilder	`withMobilePreferred` `withSchedules`
PhoneNumberBuilder	`withEndDate` `withMobilePreferred` `withStartDate`
PriceBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`
SitelinkBuilder	`withMobilePreferred`
SnippetBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`