Gli script Google Ads forniscono una piattaforma di automazione serverless che ti consente di gestire e interrogare i dati pubblicitari di Google Ads a livello di programmazione utilizzando JavaScript moderno (ES6+) in un IDE basato su browser. Con gli script Google Ads, puoi automatizzare i flussi di lavoro di gestione di routine degli account, generare report personalizzati e integrare Google Ads con origini dati esterne, in un account o in migliaia di account, senza eseguire il provisioning dei server o gestire le credenziali dello sviluppatore.
La maggior parte delle funzionalità di Google Ads è disponibile negli script Google Ads tramite chiamate di mutazione e ricerca. Puoi utilizzare gli script per:
- Gestire campagne, gruppi di annunci, parole chiave, e annunci.
- Modificare offerte, budget e stato in base al rendimento in tempo reale o ai dati esterni.
- Eseguire query utilizzando Google Ads Query Language (GAQL) per generare report personalizzati e dashboard.
- Pianificare esecuzioni automatiche da eseguire ogni ora, ogni giorno, ogni settimana, ogni mese o su richiesta.
- Coordinare le operazioni multi-account negli account secondari utilizzando gli script dell'account amministratore.
- Connetterti ai servizi Google Workspace (come Fogli e Drive), ai servizi Google Cloud services (come BigQuery), e 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 di un singolo account | Script dell'account amministratore |
|---|---|---|
| Timeout di esecuzione | Massimo 30 minuti |
Fino a 60 minuti con executeInParallel e un callback
(30 minuti standard)
|
| Motore di runtime | Runtime JavaScript V8 (ECMAScript 6+) | Runtime JavaScript V8 (ECMAScript 6+) |
| Limite dell'iteratore di entità | 50.000 entità per iteratore per impostazione predefinita (report e query di ricerca sono esclusi) | 50.000 entità per account secondario (report e query di ricerca sono esclusi) |
| Account paralleli | N/A (1 account) | Fino a 50 account in parallelo |
| Limite di caricamento collettivo | Dimensione file 50 MB, 1.000.000 di righe | Dimensione 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 ulteriori informazioni, vedi Limiti.
Gli script Google Ads sono il prodotto giusto per me?
Google offre più prodotti per automatizzare gli account Google Ads. La seguente tabella illustra gli scenari e i suggerimenti comuni per aiutarti a scegliere il prodotto giusto per le tue esigenze:
| Scenario | Suggerimento | Caratteristiche principali |
|---|---|---|
| Sono uno sviluppatore che vuole creare un proprio prodotto software o integrarsi con l'API Google Ads. Mi sento a mio agio a scrivere codice e a gestire l'infrastruttura software inclusi server e database. | Utilizza l'API Google Ads. | Controllo completo dell'API, maggiore velocità effettiva, hosting dedicato e gestione di OAuth. |
| Sono uno sviluppatore che si sente a suo agio a scrivere codice, ma preferisco non gestire la mia infrastruttura software. | Utilizza gli script Google Ads. | Esecuzione serverless all'interno di Google Ads, pianificazione automatica, browser-based IDE. |
| Non sono uno sviluppatore, ma sono disposto a investire un po' di tempo per imparare a programmare 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 a livello di programmazione. | Utilizza gli script Google Ads. |
Gestione diretta delle campagne video utilizzando
AdsApp.videoCampaigns().
|
| Voglio pianificare l'esecuzione delle 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 a livello di programmazione. | Utilizza gli script dell'account amministratore per accedere agli account secondari di pubblicazione da un singolo script. |
Iterazione sequenziale tra gli account secondari o esecuzione parallela su 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 management. | Utilizza Google API o API di terze parti con gli script Google Ads. |
Servizi Google Workspace integrati (Fogli, Drive, Gmail), API Google avanzate (BigQuery, Analytics, YouTube) e UrlFetchApp per
API REST esterne.
|
| Sono un analista di dati (o un ruolo simile) che vuole scaricare i report di Google Ads per ulteriori analisi. | Utilizza il BigQuery Data Transfer Service per Google Ads. | Pipeline automatica 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 di CSV o fogli di lavoro a livello di programmazione che supporta fino a 1.000.000 righe. |
| Voglio gestire Google Ads collettivamente, ma non voglio scrivere codice. | Utilizza regole automatizzate, caricamenti collettivi, o Google Ads Editor. | Strumenti desktop o UI no-code per aggiornamenti in blocco e regole pianificate. |
Prerequisiti
È necessaria 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 di rendimento, creare e modificare campagne, aggiornare offerte e budget e connettersi alle API esterne senza configurare server, gestire token OAuth o pagare per l'infrastruttura.
In che modo gli script Google Ads differiscono dall'API Google Ads?
Gli script Google Ads vengono eseguiti direttamente nel tuo account Google Ads utilizzando JavaScript, non richiedono alcuna infrastruttura server e gestiscono automaticamente l'autorizzazione 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 dedicati e credenziali OAuth.
Ho bisogno di 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 nei singoli account 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 (quando viene specificata una funzione di callback). Se uno script scade, Google Ads applica comunque le modifiche apportate prima dell'annullamento. Per tutti i dettagli su timeout, quote e limiti di caricamento collettivo, vedi Limiti.
Gli script Google Ads possono connettersi ad API esterne?
Sì. Gli script Google Ads includono servizi integrati come SpreadsheetApp per leggere e scrivere Fogli Google, UrlFetchApp per inviare richieste HTTP alle API REST esterne e API di Google avanzate per l'integrazione con servizi come BigQuery e YouTube. Per maggiori dettagli, vedi
API di terze parti
e API di Google avanzate.
Feedback
Se hai commenti sugli script Google Ads, non esitare a contattarci. Contattaci su Discord.
Se hai bisogno di assistenza, contatta l'assistenza tecnica per gli script.