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 tutto il possibile per garantire la massima compatibilità con le versioni precedenti, pertanto queste modifiche dovrebbero essere minime.

Report

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

A causa di questo overhead, ti consigliamo di esaminare i tuoi script e aggiornare le query AWQL a GAQL, ove possibile. Puoi utilizzare lo strumento di migrazione delle query, che usa la stessa logica degli script per determinare la query GAQL per una determinata query AWQL, oppure utilizzare il generatore di query interattivo per creare le query.

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

  • Non tutte le query AWQL si traducono in modo pulito in query GAQL. In questi casi, verrà registrato un messaggio di errore con alcuni dettagli sugli errori riscontrati, per aiutarti a risolverli manualmente.
  • Non tutti i tipi di report di AWQL sono supportati in GAQL.
  • GAQL non supporta le "righe con zero impressioni". Specificare che un report deve includere zero impressioni comporterà un errore.
  • Alcuni campi ambigui non possono essere utilizzati nei filtri. Ad esempio, "Titolo" potrebbe fare riferimento a un numero qualsiasi di campi annuncio diversi.
  • 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 tramite gli script, è abbastanza comune utilizzare le chiamate withCondition e orderBy per limitare o ordinare i risultati nell'iteratore. I campi in queste chiamate ora utilizzano i nuovi nomi dell'API Google Ads. Ad esempio, per filtrare in base al nome della campagna, in precedenza avresti usato:

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

Ora ti consigliamo di utilizzare i nuovi nomi dei campi per queste condizioni, se possibile:

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

Detto questo, ci siamo impegnati per includere una mappatura dei nomi precedenti a quelli nuovi. Pertanto, se lo script utilizza ancora CampaignName, verrà sostituito automaticamente con campaign.name in fase di runtime per garantire che lo script continui a funzionare. Se riscontri problemi con i nomi degli stili precedenti, aggiorna gli script in modo da utilizzare i nuovi nomi degli stili come primo passaggio per la risoluzione dei problemi.

Limiti

Molti limiti sono gli stessi dell'infrastruttura precedente e le modifiche apportate qui generalmente contribuiranno a migliorare le prestazioni.

  • 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 è possibile ignorarlo. 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 è possibile creare per ogni esecuzione. In precedenza,il limite era 250.000.
  • L'output del logging è stato troncato a 100 kB (invariato).
  • Le quote per i servizi Apps Script (Foglio di lavoro, 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 a limiti di frequenza API, ma ciò consente una maggiore flessibilità per accedere a più report o apportare più modifiche per ogni esecuzione.

Altre modifiche

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