Percorso guidato · Costruisci, non solo studiare

Dai alla tua AI il controllo delle campagne Google Ads

Segui i 5 passaggi: al termine sblocchi due file reali e funzionanti, pronti da collegare a Claude o a un'altra AI a tua scelta.

🎯

Cosa otterrai alla fine: un file SKILL.md da caricare in Claude (Progetto o Skill personalizzata) e un file istruzioni-universali-ai-google-ads.md da incollare in ChatGPT o altre AI — entrambi permettono di creare, leggere, modificare e mettere in pausa campagne Google Ads reali direttamente dalla conversazione.

01

Progetto Google Cloud e API abilitata

Google Ads richiede un progetto tecnico su Google Cloud, distinto dall'account pubblicitario vero e proprio.

01Crea un progetto Google Cloud e abilita Google Ads API

Su console.cloud.google.com crea un nuovo progetto, poi cerca e abilita "Google Ads API" dalla libreria API. Crea anche un OAuth2 Client ID (tipo "Desktop App").

02

Le tre chiavi che servono alla tua AI

A differenza di Meta, Google Ads richiede tre elementi insieme: developer token, client OAuth2 e un refresh token.

02Ottieni Developer Token e Refresh Token

Il Developer Token si trova in Google Ads → Strumenti → Centro API. Il Refresh Token si genera una tantum tramite il flusso OAuth2 del tuo Client ID (rimane valido se usato almeno una volta ogni 6 mesi).

Conserva questi valori con cura: insieme permettono di operare realmente sull'account Google Ads collegato. Non condividerli mai in chat pubbliche.
03

Primo contatto reale (sola lettura, sicuro)

Prima otteniamo un access token dal refresh token, poi facciamo una lettura che non modifica nulla.

03Scambia il refresh token e leggi le tue campagne

cURL — ottieni l'access token
curl -X POST https://oauth2.googleapis.com/token \
  -d "client_id={CLIENT_ID}" \
  -d "client_secret={CLIENT_SECRET}" \
  -d "refresh_token={REFRESH_TOKEN}" \
  -d "grant_type=refresh_token"
cURL — elenca le campagne (GAQL, sola lettura)
curl -X POST "https://googleads.googleapis.com/v18/customers/{CUSTOMER_ID}/googleAds:search" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "developer-token: {DEVELOPER_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT campaign.id, campaign.name, campaign.status FROM campaign"}'

Se ricevi un elenco di campagne (anche vuoto), l'accesso funziona correttamente.

04

Capire le operazioni che l'AI potrà svolgere

In Google Ads una campagna ha bisogno di un budget associato: per questo "creare" è in realtà un'operazione in due passaggi.

04Le operazioni core sulla Google Ads API

Creare un budget e poi una campagna collegata (sempre in stato PAUSED) · Leggere metriche via GAQL · Modificare il budget giornaliero · Mettere in pausa/riattivare una campagna. Come per Meta, ogni operazione diversa dalla sola lettura richiederà sempre conferma esplicita.

05

Le regole di sicurezza che l'AI dovrà rispettare

Le stesse identiche regole viste per Meta, scritte nei file finali.

05Conferma le regole non negoziabili

1. Ogni campagna nasce sempre in stato PAUSED. 2. Nessuna modifica reale senza tua conferma esplicita. 3. Nessun budget viene superato senza che tu lo sappia. 4. In caso di errore, l'AI si ferma e ti avvisa, non ritenta da sola.

🎓

I tuoi file, pronti all'uso

🔒
Non ancora disponibili
Completa tutti e 5 i passaggi qui sopra per sbloccare il download.

Complimenti — hai completato il percorso. Scarica i due file: contengono già tutte le istruzioni, i comandi e le regole di sicurezza viste sopra.

🧩

SKILL.md — per Claude

Carica questo file in un Progetto Claude (o nella cartella skill di Claude Code/Desktop): Claude riconoscerà automaticamente quando usarlo, ogni volta che gli chiederai di gestire una campagna Google Ads.

🌐

Istruzioni universali — per altre AI

Scritto in modo che qualunque assistente AI con accesso a internet o esecuzione di codice (ChatGPT, Gemini, ecc.) possa seguirlo: incollalo tra le istruzioni personalizzate o nel prompt di sistema.

Come usarli da subito

  1. Con Claude: vai in Impostazioni del Progetto → Skill personalizzate → carica SKILL.md. Da quel momento, scrivere "crea una campagna Search su Google Ads" attiverà automaticamente la skill.
  2. Con ChatGPT: crea un Custom GPT → Istruzioni → incolla il contenuto di istruzioni-universali-ai-google-ads.md. Assicurati che il GPT possa eseguire richieste HTTP, oppure usalo come guida mentre esegui tu i comandi proposti.
  3. In entrambi i casi, tieni a portata di mano developer token, client ID/secret e refresh token: nessun file li contiene già, vanno sempre forniti da te al momento.