Gli script Google Ads forniscono una piattaforma di automazione serverless che ti consente di gestire ed eseguire query sui dati pubblicitari Google Ads in modo programmatico utilizzando JavaScript moderno (ES6+) in un IDE basato su browser. Con gli script Google Ads, puoi automatizzare i flussi di lavoro di gestione degli account di routine, generare report personalizzati e integrare Google Ads con origini dati esterne, in un singolo account o in migliaia di account, senza eseguire il provisioning dei server o gestire le credenziali degli sviluppatori.
La maggior parte delle funzionalità di Google Ads è disponibile negli script Google Ads tramite le chiamate mutate e search. Puoi utilizzare gli script per:
- Gestire campagne, gruppi di annunci, parole chiave e annunci.
- Modifica offerte, budget e stato in base al rendimento in tempo reale o ai dati esterni.
- Esegui query utilizzando Google Ads Query Language (GAQL) per generare report personalizzati e dashboard.
- Pianifica le esecuzioni automatiche in modo che vengano eseguite ogni ora, ogni giorno, ogni settimana, ogni mese o on demand.
- Coordinare le operazioni su più account secondari utilizzando gli script amministratore.
- Connettiti ai servizi Google Workspace (come Fogli e Drive), ai servizi Google Cloud (come BigQuery) e alle API di terze parti.
Gli script includono anche selettori di entità e report integrati.
Specifiche tecniche principali
Le seguenti specifiche tecniche definiscono l'ambiente di esecuzione e i limiti operativi degli script Google Ads:
| Specifica | Script per un singolo account | Script dell'account amministratore |
|---|---|---|
| Timeout di esecuzione | Massimo 30 minuti |
Fino a 60 minuti con executeInParallel e un richiamo (30 minuti standard)
|
| Motore di runtime | Runtime JavaScript V8 (ECMAScript 6+) | Runtime JavaScript V8 (ECMAScript 6+) |
| Limite dell'iteratore di entità | 50.000 entità predefinite per iteratore (i report e le query di ricerca sono esenti) | 50.000 entità per account secondario (report e query di ricerca sono esenti) |
| Account paralleli | N/A (1 account) | Fino a 50 account in parallelo |
| Limite di caricamento collettivo | Dimensioni del file: 50 MB, 1.000.000 di righe | Dimensioni del file: 50 MB, 1.000.000 di righe |
| Script autorizzati | Fino a 250 script autorizzati per utente | Fino a 250 script autorizzati per utente |
| Hosting e infrastruttura | Completamente gestito da Google (serverless) | Completamente gestito da Google (serverless) |
Per saperne di più, consulta Limiti.
Gli script Google Ads sono il prodotto giusto per me?
Google fornisce diversi prodotti per automatizzare gli account Google Ads. La tabella seguente illustra gli scenari e i consigli più comuni per aiutarti a scegliere il prodotto più adatto alle tue esigenze:
| Scenario | Suggerimento | Caratteristiche principali |
|---|---|---|
| Sono uno sviluppatore che vuole creare un proprio prodotto software o eseguire l'integrazione con l'API Google Ads. Mi sento a mio agio nello scrivere codice e nel gestire l'infrastruttura software, inclusi server e database. | Utilizza l'API Google Ads. | Controllo completo delle API, velocità effettiva più elevata, hosting dedicato e gestione di OAuth. |
| Sono uno sviluppatore che non ha problemi a scrivere codice, ma preferisco non gestire la mia infrastruttura software. | Utilizza gli script Google Ads. | Ambiente di esecuzione serverless all'interno di Google Ads, pianificazione automatizzata, IDE basato su browser. |
| Non sono uno sviluppatore, ma voglio dedicare un po' di tempo a imparare la programmazione per automatizzare Google Ads. | Utilizza gli script Google Ads. | Sintassi JavaScript semplice, modelli di script predefiniti, completamento automatico dell'IDE ed evidenziazione della sintassi. |
| Voglio gestire le campagne video in modo programmatico. | Utilizza gli script Google Ads. |
Gestione diretta delle campagne video utilizzando AdsApp.videoCampaigns().
|
| Voglio pianificare l'esecuzione di attività senza bisogno di una sessione utente attiva. | Utilizza gli script Google Ads. | Autorizzazione in background OAuth2 con pianificazione automatica oraria, giornaliera, settimanale o mensile. |
| Voglio accedere ai miei account Google Ads nidificati in modo programmatico. | Utilizza gli script amministratore per accedere agli account secondari di pubblicazione da un singolo script. |
Iterazione sequenziale tra gli account secondari o esecuzione parallela tra un massimo di 50 account secondari utilizzando executeInParallel.
|
| Voglio integrare le API di proprietà di Google o di terze parti nella mia gestione di Google Ads. | Utilizza le API di Google o le API di terze parti con gli script Google Ads. |
Servizi Google Workspace integrati (Fogli, Drive, Mail), API di Google avanzate (BigQuery, Analytics, YouTube) e UrlFetchApp per le API REST esterne.
|
| Sono un data analyst (o un ruolo simile) che vuole scaricare i report di Google Ads per ulteriori analisi. | Utilizza BigQuery Data Transfer Service per Google Ads. | Pipeline automatizzata pianificata per i dati pubblicitari di Google Ads in BigQuery senza codice. |
| Voglio gestire Google Ads collettivamente e non mi dispiace scrivere codice. | Utilizza i caricamenti collettivi con gli script Google Ads. | Caricamento programmatico di file CSV o fogli di lavoro che supporta fino a 1.000.000 di righe. |
| Voglio gestire Google Ads collettivamente, ma non voglio scrivere codice. | Utilizza le regole automatizzate, i caricamenti collettivi o Google Ads Editor. | Strumenti desktop o UI no-code per aggiornamenti in blocco e regole pianificate. |
Prerequisiti
È richiesta solo una conoscenza di base di JavaScript: l'IDE aiuta con l'evidenziazione della sintassi, il completamento automatico e l'anteprima. Per iniziare a scrivere il tuo primo script, ti basta un account Google Ads.
Domande frequenti
Trova le risposte alle domande più comuni sull'architettura, sui limiti di esecuzione e sulle integrazioni degli script Google Ads.
Che cosa sono gli script Google Ads?
Gli script Google Ads forniscono un ambiente di automazione serverless all'interno di Google Ads. Consentono agli inserzionisti e agli sviluppatori di scrivere codice JavaScript per eseguire query sulle metriche sul rendimento, creare e modificare campagne, aggiornare offerte e budget e connettersi con API esterne senza configurare server, gestire token OAuth o pagare per l'infrastruttura.
Quali sono le differenze tra gli script Google Ads e l'API Google Ads?
Gli script Google Ads vengono eseguiti direttamente nel tuo account Google Ads utilizzando JavaScript, non richiedono un'infrastruttura server e gestiscono l'autorizzazione automaticamente nel browser. L'API Google Ads è un'API REST e gRPC progettata per applicazioni aziendali su larga scala, strumenti di terze parti e pipeline di dati ad alto volume che vengono eseguite sui tuoi server e richiedono token sviluppatore e credenziali OAuth dedicati.
È necessario un server per eseguire gli script Google Ads?
No. Gli script Google Ads vengono eseguiti interamente sull'infrastruttura cloud di Google senza costi aggiuntivi. Puoi creare script, testarli con la modalità di anteprima e pianificarli direttamente nell'interfaccia web di Google Ads.
Quali sono i limiti di esecuzione per gli script Google Ads?
Gli script standard negli account individuali possono essere eseguiti per un massimo di 30 minuti per esecuzione. Gli script dell'account amministratore che utilizzano executeInParallel possono essere eseguiti per un massimo di 60 minuti su un massimo di 50 account secondari (se è specificata una funzione di callback). Se uno script scade, Google Ads applica comunque le modifiche apportate prima dell'annullamento. Consulta Limiti per informazioni dettagliate su timeout, quote e limiti di caricamento collettivo.
Gli script Google Ads possono connettersi ad API esterne?
Sì. Gli script Google Ads includono servizi integrati come SpreadsheetApp per la lettura e la scrittura di Fogli Google, UrlFetchApp per l'invio di richieste HTTP ad API REST esterne e API di Google avanzate per l'integrazione con servizi come BigQuery e YouTube. Per maggiori dettagli, consulta API di terze parti e API di Google avanzate.
Feedback
Se hai feedback sugli script Google Ads, saremo felici di riceverli. Contattaci su Discord.
Se hai bisogno di assistenza, contatta l'assistenza tecnica per gli script.