Migrazione

La nuova infrastruttura degli script Google Ads si basa sull'API Google Ads. A causa della diversa architettura dell'API, potrebbe essere necessario aggiornare gli script esistenti. Abbiamo fatto il possibile per garantire la massima compatibilità con le versioni precedenti, pertanto queste modifiche dovrebbero essere di entità lieve.

Report

Molti report AWQL continueranno a funzionare. Dietro le quinte, quando utilizzi la nuova infrastruttura, gli script convertono la query AWQL in GAQL (il nuovo linguaggio di query per l'API Google Ads), la eseguono sul nuovo backend e poi convertono nuovamente i risultati nel formato utilizzato originariamente dai report AWQL. Le query con GAQL verranno trasmesse così come sono.

A causa di questo overhead, ti consigliamo di esaminare gli script e di aggiornare le query AWQL in GAQL, ove possibile. Puoi utilizzare lo strumento di migrazione delle query, che utilizza la stessa logica degli script per determinare la query GAQL per una determinata query AWQL, oppure puoi utilizzare lo strumento Query Builder interattivo per facilitare la creazione delle query.

Di seguito sono riportate alcune limitazioni della traduzione automatica da AWQL a GAQL:

  • Non tutte le query AWQL vengono tradotte in modo pulito in query GAQL. In questi casi, verrà registrato un messaggio di errore con alcuni dettagli su cosa è andato storto per aiutarti a correggere manualmente il problema.
  • Non tutti i tipi di report di AWQL sono supportati in GAQL.
  • GAQL non supporta le "righe con zero impressioni". Se specifichi che un report deve includere zero impressioni, verrà generato un errore.
  • Alcuni campi ambigui non possono essere utilizzati nei filtri. Ad esempio, "Titolo" potrebbe fare riferimento a un numero qualsiasi di campi dell'annuncio.
  • Alcuni campi potrebbero restituire risultati in un formato diverso, ad esempio suddividendo un risultato in più colonne.

Organizzazione dei selettori

Durante il recupero delle risorse mediante gli script, è piuttosto comune utilizzare chiamate withCondition e orderBy per limitare o ordinare i risultati nell'iteratore. I campi di queste chiamate ora utilizzano i nuovi nomi dell'API Google Ads. Ad esempio, per filtrare in base al nome della campagna, in precedenza avresti utilizzato:

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

Ora, se possibile, devi utilizzare i nuovi nomi di campo per queste condizioni:

.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')

Abbiamo fatto uno sforzo per includere una mappatura dei vecchi nomi a nuovi nomi, quindi se lo script utilizza ancora CampaignName, verrebbe automaticamente sostituito con campaign.name in fase di runtime per garantire che lo script continui a funzionare. Se hai riscontrato problemi con i nomi dello stile precedente, aggiorna gli script in modo da utilizzare i nomi dello stile nuovo come primo passaggio per la risoluzione dei problemi.

Limiti

Molti limiti sono gli stessi della vecchia infrastruttura e le modifiche apportate contribuiranno in genere ad aumentare il rendimento.

  • I limiti di tempo sono gli stessi. Uno script può essere eseguito per 30 minuti.
  • Un singolo iteratore restituisce 50.000 entità per impostazione predefinita, ma questo valore può essere override. In precedenza, questo limite di 50.000 non era personalizzabile.
  • Un singolo selettore può gestire al massimo 10.000 ID (invariati).
  • La nuova infrastruttura non ha limiti al numero di entità che possono essere elaborate in un singolo script. In precedenza, il limite era 250.000.
  • La nuova infrastruttura non ha limiti al numero di parole chiave o annunci che possono essere creati per esecuzione. In precedenza,il limite era di 250.000.
  • L'output dei log viene troncato a 100 KB (invariato).
  • Le quote per i servizi Apps Script (SpreadsheetApp, MailApp e così via) rimangono invariate.
  • Le quote per Google Ads verranno applicate come se stessi utilizzando l'API. In altre parole, lo script sarà soggetto ai limiti di frequenza dell'API, ma questo consente una maggiore flessibilità per accedere a più report o apportare più modifiche per esecuzione.

Altre modifiche

ExecutionInfo non espone più getRemainingCreateQuota() o getRemainingGetQuota(), poiché queste quote non si applicano più nella nuova esperienza.