Migrazione degli script delle estensioni annuncio

Importante: puoi continuare a utilizzare le attuali estensioni basate su feed mediante la precedente esperienza per gli script Google Ads. Tuttavia, a breve le estensioni basate su feed non saranno più disponibili e le estensioni basate sugli asset saranno disponibili solo nella nuova esperienza per gli script di Google Ads. Ti consigliamo di eseguire la migrazione degli script Google Ads precedenti alla nuova esperienza per gli script Google Ads il prima possibile.

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

Panoramica

Nota: se non hai script che accedono o aggiornano le estensioni annuncio, non è richiesta alcuna operazione e puoi fare riferimento alla guida alle estensioni annuncio.

Il paradigma esistente delle estensioni basate su feed è deprecato a favore delle estensioni basate su asset. Le estensioni basate su feed sono indicate come estensioni "legacy" nell'interfaccia utente di Google Ads, mentre le estensioni basate sugli asset sono indicate come estensioni "upgrade" 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 smetteranno di essere pubblicate. Questa guida illustra la migrazione sia se nel tuo account Google Ads sono presenti estensioni annuncio basate su feed e su asset sia se sono presenti solo estensioni annuncio basate su feed.

Dettagli migrazione

Per iniziare ad accedere o aggiornare le estensioni annuncio basate sugli asset, devi utilizzare la nuova esperienza per gli script Google Ads. Per informazioni sulla nuova esperienza degli script Google Ads, consulta la Guida introduttiva.

Recupero delle estensioni annuncio

L'insieme esistente di selettori di estensioni annuncio (ad es. SitelinkSelector) è in grado di recuperare estensioni annuncio basate su feed o su asset. Per impostazione predefinita, questi selettori restituiranno qualsiasi tipo di estensione annuncio attualmente pubblicata. La tabella seguente riassume il tipo di estensione dell'annuncio attualmente pubblicato (che verrà quindi restituito per impostazione predefinita):

Tipo di estensioni annuncio nell'account
Solo estensioni degli annunci basate su feed	Per impostazione predefinita, verranno restituite le estensioni degli annunci basate su feed
Solo estensioni annuncio basate su asset	Per impostazione predefinita, verranno restituite le estensioni degli annunci basate sugli asset
Estensioni degli annunci sia basate su feed sia basate su asset	Per impostazione predefinita, verranno restituite le estensioni degli annunci basate sugli asset

Dopo la migrazione di tutte le estensioni degli annunci basate su feed, tutti i selettori di estensioni degli annunci restituiranno per impostazione predefinita le estensioni degli annunci basate sugli asset. Sarà comunque possibile recuperare le estensioni annuncio basate su feed tramite il metodo withOnlyLegacy. Questo è utile per raccogliere le 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 dovrebbero essere necessarie modifiche al codice prima o dopo la migrazione delle estensioni degli annunci basate su feed. Tuttavia, in alcuni scenari potrebbero essere necessarie modifiche al codice.

Filtrare le estensioni annuncio per ID

Quando viene eseguita la migrazione di un'estensione annuncio basata su feed, l'estensione annuncio basata su asset corrispondente avrà un ID diverso. Ciò significa che se al momento lo script filtra le estensioni annuncio in base all'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 per utilizzare gli ID delle estensioni annuncio basate su asset.

Filtrare le estensioni degli annunci per statistiche

Quando viene eseguita la migrazione di un'estensione annuncio basata su feed, le statistiche dell'estensione annuncio basata su asset corrispondente verranno reimpostate. Tieni presente questo aspetto quando filtra le estensioni annuncio in base alle statistiche. Ad esempio, se richiedi estensioni sitelink con Clicks > 100 in LAST_MONTH, potresti notare un numero inferiore di estensioni annuncio rispetto al normale se le estensioni annuncio basate su feed sono state migrate di recente.

Tieni presente questo aspetto anche quando generi report sul rendimento per le estensioni annuncio. I report potrebbero registrare variazioni o cali significativi durante la migrazione delle estensioni degli annunci basate su feed.

Metodi ritirati

Nell'ambito della migrazione, diversi campi non sono più supportati. Ad esempio, le date di inizio e di fine non sono più disponibili nelle estensioni snippet. Le chiamate a getStartDate() restituiranno null. Inoltre, verrà registrato un messaggio di avviso. Consulta la seguente tabella per capire quali metodi sono deprecati:

Classe	Metodi ritirati
Callout	Nessun metodo ritirato
MobileApp	getSchedules
Numero di telefono	getEndDate getStartDate
Prezzo	getEndDate getSchedules getStartDate
Sitelink	Nessun metodo ritirato
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 non sono più disponibili nelle estensioni snippet. Le chiamate a setStartDate non influiscono sull'estensione dell'annuncio. Inoltre, verrà registrato un messaggio di avviso. Consulta la seguente tabella per capire quali metodi sono stati ritirati:

Classe	Metodi ritirati
Callout	Nessun metodo ritirato
MobileApp	setSchedules
Numero di telefono	clearEndDate clearStartDatesetEndDate setStartDate
Prezzo	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Sitelink	Nessun metodo ritirato
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 generatori creano il tipo di estensione dell'annuncio attualmente pubblicato. La tabella seguente riassume il tipo di estensione dell'annuncio attualmente pubblicato (e quindi verrà creato per impostazione predefinita):

Tipo di estensioni annuncio nell'account
Solo estensioni annuncio basate su feed	Per impostazione predefinita, verranno create estensioni degli annunci basate su feed
Solo estensioni annuncio basate su asset	Per impostazione predefinita, verranno create estensioni degli annunci basate sugli asset
Estensioni degli annunci sia basate su feed sia basate su asset	Per impostazione predefinita, verranno create estensioni degli annunci basate sugli asset

Dopo che un cliente ha eseguito la migrazione delle estensioni, tutti gli strumenti per la creazione di estensioni annuncio creeranno estensioni annuncio basate sugli asset per impostazione predefinita. La creazione di estensioni degli annunci basate su feed non sarà più supportata poiché queste estensioni non verranno più pubblicate.

Se vuoi creare un'estensione basata su feed anziché fare affidamento sul 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 il tuo account al momento ha solo estensioni basate su feed, puoi attendere fino al 28 marzo o chiamare 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 degli annunci, alcuni campi sono stati ritirati. Ad esempio, le date di inizio e di fine non sono più disponibili nelle estensioni snippet. Le chiamate a withEndDate o withStartDate non influiscono sull'estensione, ma verrà registrato un messaggio di avviso. Consulta la tabella riportata di seguito per capire quali metodi sono deprecati per ogni classe:

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