Question 1

Come connettere OrbiAds a Google Ad Manager?

Accepted Answer

La connessione si effettua in meno di 5 minuti tramite lo standard Google OAuth2. Dalla tua dashboard OrbiAds, clicca su "Connetti GAM", quindi autorizza l'accesso alla tua rete Google Ad Manager. OrbiAds riceve un token di accesso sicuro, crittografato immediatamente con Google Cloud KMS e memorizzato in Secret Manager — mai in chiaro. Nessuna password viene mai richiesta o memorizzata. OrbiAds accede solo alle reti GAM che autorizzi esplicitamente durante questo flusso OAuth, e puoi revocare questo accesso in qualsiasi momento dal tuo account Google o da OrbiAds.

Question 2

Quanto tempo occorre per distribuire la mia prima campagna?

Accepted Answer

Con OrbiAds, la distribuzione di una prima campagna richiede generalmente meno di 5 minuti una volta stabilita la connessione GAM. In pratica: la connessione OAuth richiede 2 minuti e l'esecuzione di uno Skill di distribuzione completo (creazione di ordine, line items, targeting, creatività) richiede 2-3 minuti aggiuntivi tramite un agente IA. Rispetto alla manipolazione manuale nell'interfaccia GAM che può richiedere da 30 a 90 minuti a seconda della complessità, OrbiAds riduce il tempo di distribuzione di oltre il 90%. Per le campagne ricorrenti, gli Skill salvano i parametri e consentono di riprodurre una distribuzione completa con un solo comando.

Question 3

Devo saper programmare per usare OrbiAds?

Accepted Answer

No, non è richiesta alcuna competenza di programmazione. OrbiAds è progettato per i team AdOps: interagisci con il tuo agente IA (Claude, ChatGPT, Cursor) in linguaggio naturale, proprio come faresti con un collega. Ad esempio: "Crea una campagna Display per l'inserzionista Acme Corp, budget 5000€, date dal 1° al 30 aprile, CPM 3,50€." L'agente traduce le tue istruzioni in chiamate GAM tramite i 173 strumenti MCP. Per gli utenti avanzati, la CLI orbiads è disponibile per l'automazione da terminale. Gli Skill, invece, sono semplici file Markdown — leggibili e modificabili senza codice.

Question 4

Quali agenti IA sono compatibili con OrbiAds?

Accepted Answer

OrbiAds implementa il Model Context Protocol (MCP), uno standard aperto pubblicato da Anthropic. Qualsiasi client MCP compatibile può connettersi: Claude Desktop e Claude.ai (Anthropic), Cursor (IDE IA), Windsurf, GitHub Copilot (tramite estensioni MCP) e qualsiasi altro agente o IDE che supporti il protocollo MCP streamable-http. L'elenco dei client compatibili si allarga ogni mese con la crescente adozione dello standard. Per gli ambienti senza MCP, la CLI orbiads offre le stesse funzionalità da terminale o in script di automazione.

Question 5

Cos'è uno strumento MCP e come funziona con GAM?

Accepted Answer

Uno strumento MCP (Model Context Protocol) è una funzione esposta da OrbiAds che il tuo agente IA può chiamare direttamente. Ciascun strumento corrisponde a una specifica operazione GAM: creare un ordine, modificare un line item, recuperare un report, ecc. Quando fornisci un'istruzione al tuo agente IA, questo seleziona automaticamente lo strumento MCP corretto, gli passa i parametri necessari e OrbiAds esegue l'operazione tramite l'API Google Ad Manager. Il risultato viene restituito all'agente, che può concatenare diversi strumenti per eseguire un flusso complesso. OrbiAds espone 173 strumenti che coprono tutte le operazioni GAM: inventario, ordini, line items, creatività, targeting, report e altro.

Question 6

Quante operazioni GAM può automatizzare OrbiAds?

Accepted Answer

OrbiAds espone 173 strumenti MCP che coprono l'intero ambito di Google Ad Manager: gestione di ordini e line items, configurazione del targeting (geografia, dati demografici, contesto, dispositivo), caricamento e gestione delle creatività, lettura dell'inventario (ad unit, placement, segmenti di pubblico), generazione di report sulle prestazioni, gestione di reti e utenti, configurazione di regole di yield e price floor. Le operazioni di lettura (report, recupero dati) sono sempre gratuite (0 crediti). Le operazioni di scrittura (creazione, modifica, eliminazione) consumano crediti e includono un meccanismo di rollback automatico per le azioni distruttive.

Question 7

Cos'è uno "Skill" OrbiAds e perché è utile?

Accepted Answer

Uno Skill OrbiAds è una procedura AdOps codificata in un file Markdown strutturato, ospitato su GitHub (OrbiAds/Orbiads-GAM-MCP). Descrive passo dopo passo come eseguire un'operazione complessa — ad esempio: distribuire una campagna video completa, verificare line item in conflitto o generare un report settimanale. L'agente IA legge lo Skill ed esegue ogni passaggio tramite gli strumenti MCP. Il vantaggio: gli Skill sono versionati, condivisibili tra i team, personalizzabili per la tua rete specifica e riproducibili in modo identico. Si installano con un solo comando: ./install.sh skills.

Question 8

OrbiAds può gestire più reti GAM contemporaneamente?

Accepted Answer

Sì. OrbiAds supporta la gestione multirete all'interno di un singolo account utente. Puoi connettere più reti Google Ad Manager (ad esempio una rete publisher principale e una rete di test) e passare dall'una all'altra durante le sessioni con l'agente IA. Ciascuna rete ha i propri token OAuth, crittografati e memorizzati in modo isolato in GCP Secret Manager. L'agente può interrogare l'inventario di una rete, confrontare le configurazioni tra le reti o eseguire operazioni batch su più reti in sequenza. Questa funzionalità è particolarmente utile per le concessionarie che gestiscono un portafoglio di publisher o per i responsabili ad ops che supervisionano più entità.

Question 9

Come funziona il rollback automatico in caso di errore?

Accepted Answer

Per ogni azione distruttiva (eliminazione di riga, modifica massiva del targeting, archiviazione delle creatività), OrbiAds acquisisce lo stato precedente prima di eseguire l'operazione. Se si verifica un errore durante l'esecuzione — errore API GAM, timeout di rete, incongruenza dei dati — OrbiAds attiva automaticamente il rollback e ripristina lo stato iniziale. È disponibile anche il rollback manuale: puoi chiedere al tuo agente IA di annullare l'ultima operazione. Ciascun rollback viene registrato con l'identificatore dell'operazione, la data e lo stato prima/dopo per un audit completo. Ciò elimina il rischio di modifiche accidentali irreversibili nelle campagne in produzione.

Question 10

Come funziona il sistema di crediti?

Accepted Answer

Il sistema di crediti OrbiAds è granulare e prevedibile. I costi variano a seconda del tipo di operazione: 0 crediti per tutte le letture (elenchi, audit, inventario, consultazioni); 0.5 crediti per creazioni leggere (ordine, inserzionista, creatività, report); 1 credito per line item; 5 crediti per una distribuzione completa della campagna (deploy_campaign). Le operazioni di gestione (pausa, archiviazione, rollback) sono gratuite. Al momento della registrazione, ricevi 5 crediti gratuiti senza carta di credito richiesta. L'abbonamento Early Access a 29€/mese include 50 crediti mensili. Sono disponibili pacchetti aggiuntivi: Pacchetto S (50 crediti, 29€) e Pacchetto L (100 crediti, 45€). I crediti mensili non si accumulano. Consulta la pagina dei prezzi per i dettagli completi.

Question 11

Quali operazioni consumano crediti?

Accepted Answer

I costi sono granulari: 5 crediti per una distribuzione completa (deploy_campaign), 1 credito per line item (create_line_items, duplicate_line_item), 0.5 crediti per operazioni unitarie (create_order, create_advertiser, create_image_creative, run_custom_report, export_report_csv), 0.25 crediti per avvisi automatizzati (underdelivery, budget). Le operazioni gratuite (0 crediti) sono numerose: tutte le letture (elencare, consultare, verificare), azioni di gestione (pausa, archiviazione, rollback, attivazione), consultazioni di catalogo e storico. In pratica, i flussi di lavoro di consultazione e verifica — che spesso rappresentano il 60-70% delle attività AdOps — rimangono completamente gratuiti.

Question 12

Posso provare OrbiAds senza carta di credito?

Accepted Answer

Sì, assolutamente. La registrazione a OrbiAds non richiede una carta di credito. Inizi automaticamente con 5 crediti gratuiti sul piano Trial, che ti consente di eseguire 5 operazioni di scrittura reali nella tua rete GAM — sufficienti per distribuire una campagna completa e verificare che OrbiAds funzioni nel tuo ambiente. Il piano Trial include anche l'accesso illimitato alle operazioni di lettura (0 crediti). Nessun impegno, nessuna prova che si converte automaticamente in abbonamento a pagamento. Passi all'offerta a pagamento solo quando decidi di farlo, dalla tua dashboard.

Question 13

Qual è la differenza tra l'offerta Early Access e l'offerta standard?

Accepted Answer

L'offerta Early Access è disponibile a 29€/mese per i primi utenti, contro i 39€/mese dell'offerta standard in arrivo. La tariffa Early Access è garantita a vita: finché mantieni attivo l'abbonamento, benefici del prezzo bloccato, anche quando la tariffa standard passerà a 39€. Entrambe le offerte includono le stesse funzionalità: 50 crediti mensili, accesso a 173 strumenti MCP, accesso agli Skill, supporto prioritario. L'offerta Early Access è a numero limitato. Per confrontare le offerte in dettaglio, consulta la pagina dei prezzi.

Question 14

OrbiAds ha accesso ai miei dati pubblicitari?

Accepted Answer

OrbiAds accede solo ai dati delle reti GAM autorizzate esplicitamente tramite OAuth2. L'accesso è limitato all'ambito GAM — nessun accesso ai tuoi dati di Analytics, DV360 o altre piattaforme. OrbiAds accede alla tua rete solo quando tu (o il tuo agente IA) attivi un'operazione: non c'è sincronizzazione in background né raccolta passiva di dati. I dati transitano esclusivamente tra la tua rete GAM e l'infrastruttura OrbiAds su GCP (europe-west1) e non vengono mai rivenduti né utilizzati per addestrare modelli. OrbiAds è soggetto al GDPR come responsabile del trattamento dei tuoi dati.

Question 15

Come vengono memorizzati i token OAuth del mio account GAM?

Accepted Answer

La sicurezza dei token OAuth è garantita da tre livelli tecnici: (1) Google Cloud KMS — ciascun token di accesso GAM viene crittografato con una chiave asimmetrica gestita da Cloud Key Management Service prima di qualsiasi memorizzazione. (2) GCP Secret Manager — i blob crittografati vengono memorizzati in Secret Manager, mai in un database standard. (3) Isolamento tramite UID Firebase — ciascun token è collegato al tuo ID utente univoco e inaccessibile ad altri account. OrbiAds non può leggere i tuoi token in chiaro — è possibile solo la decrittografia tramite KMS al momento di una chiamata API GAM autorizzata. Questo design segue le migliori pratiche GCP per i segreti sensibili.

Question 16

OrbiAds può modificare le mie campagne senza la mia convalida?

Accepted Answer

OrbiAds esegue un'azione in GAM solo quando tu (o il tuo agente IA con il tuo accordo) attivi esplicitamente uno strumento MCP o un comando CLI. Non esiste alcun meccanismo di esecuzione autonomo, scheduler interno o modifiche automatiche in background. Ogni operazione di scrittura è avviata da un'istruzione umana trasmessa all'agente IA, che chiama lo strumento OrbiAds corrispondente. Per i flussi di lavoro automatizzati (script, cron job), sei tu a configurare e controllare i trigger. OrbiAds è uno strumento di esecuzione, non un sistema di automazione autonomo — la convalida aziendale rimane sempre sotto la tua responsabilità.

Question 17

Posso revocare l'accesso di OrbiAds a GAM in qualsiasi momento?

Accepted Answer

Sì, la revoca è immediata e totale. Sono disponibili due metodi: (1) Dalla dashboard di OrbiAds, sezione Impostazioni > Connessioni GAM > Revoca. OrbiAds elimina immediatamente il token da Secret Manager e Cloud KMS. (2) Dal tuo account Google, nelle impostazioni di gestione delle app di terze parti autorizzate (myaccount.google.com > Sicurezza > App di terze parti). Una volta revocato, OrbiAds non può più eseguire alcuna operazione sulla tua rete GAM — anche se un agente IA tenta una chiamata, riceverà un errore di autenticazione. La revoca non comporta la cancellazione del tuo account OrbiAds o della tua cronologia.

Question 18

Quali funzionalità di reporting offre OrbiAds?

Accepted Answer

OrbiAds integra un motore di reporting completo collegato all'API Google Ad Manager. Disponi di 68 metriche (impression, clic, CTR, fill rate, viewability, entrate, metriche video...) e 79 dimensioni (tempo, line item, inserzionisti, creatività, inventario, geografia, dispositivo, targeting, programmatico...). Tre modalità di accesso: (1) il Reporting Hub nella tua dashboard, con modulo rapido ed esportazione CSV, (2) gli strumenti MCP per interrogare i tuoi dati in linguaggio naturale da Claude o qualsiasi agente IA, (3) la CLI orbiads reporting run per l'automazione da terminale. I report vengono eseguiti tramite l'API REST GAM v1, con un meccanismo di polling LRO (Long Running Operation) e una cache Firestore di 30 giorni.

Question 19

Come funzionano i modelli di report?

Accepted Answer

I modelli sono configurazioni di report salvate e riutilizzabili. Ciascun modello definisce una sorgente (GAM o GA4), dimensioni, metriche, un intervallo di date e filtri opzionali. OrbiAds offre modelli integrati (sola lettura) per i report più comuni — prestazioni per inserzionista, fill rate per ad unit, erogazione per line item. Puoi anche creare i tuoi modelli personalizzati, modificarli, duplicarli e condividerli. L'esecuzione di un modello viene eseguita in un clic dal Reporting Hub o tramite lo strumento MCP run_template_report dal tuo agente IA.

Question 20

Posso sincronizzare i miei report GAM esistenti con OrbiAds?

Accepted Answer

Sì, grazie al sistema Bridge Links. Puoi collegare un report esistente nella tua interfaccia Google Ad Manager a un modello OrbiAds. Il bridge rileva automaticamente gli scostamenti di configurazione tra i due lati (dimensioni aggiunte, metriche modificate) e mostra uno stato: Synced, Drift Detected o Conflict. Puoi sincronizzare in entrambe le direzioni: importare un report GAM come modello OrbiAds (clone-to-template) o pubblicare un modello OrbiAds su GAM (publish-to-gam). Ciò ti consente di mantenere i tuoi report abituali beneficiando dell'automazione OrbiAds.

Question 21

Il reporting è gratuito?

Accepted Answer

L'esecuzione di un report (run_custom_report, fetch_inventory_report, run_report_from_template, export_report_csv) costa 0.5 crediti per esecuzione. Tuttavia, tutte le operazioni di consultazione sono gratuite al 100% (0 crediti): recuperare un risultato già memorizzato nella cache (get_report_result), elencare i modelli, consultare il catalogo di metriche/dimensioni e la cronologia delle esecuzioni. Con 5 crediti di prova, puoi eseguire 10 report. L'abbonamento da 50 crediti/mese consente 100 esecuzioni di report, oltre alle operazioni di scrittura GAM.

Question 22

Quali intervalli di date sono disponibili per i report?

Accepted Answer

OrbiAds supporta sia intervalli relativi (oggi, ieri, ultimi 7 giorni, ultimi 30 giorni, mese corrente, mese scorso, ultimi 3 mesi, anno corrente, ultimi 12 mesi) sia intervalli fissi con date di inizio e fine personalizzate. Gli intervalli relativi vengono ricalcolati automaticamente ad ogni esecuzione — ideale per report ricorrenti. I risultati vengono memorizzati nella cache di Firestore per 30 giorni con un identificatore univoco, consentendo ai tuoi agenti IA di recuperare i risultati in seguito senza eseguire nuovamente il report.

Question 23

OrbiAds supporta Google Analytics 4 (GA4) oltre a GAM?

Accepted Answer

Sì, OrbiAds offre modelli GA4 (traffico mensile, prestazioni per paese) oltre ai report GAM. Tuttavia, il reporting GA4 richiede un prerequisito tecnico: il tuo account Google deve aver autorizzato lo scope analytics.readonly durante la connessione OAuth. Per impostazione predefinita, la connessione OrbiAds richiede solo lo scope GAM (dfp). Se desideri utilizzare i report GA4, dovrai riautorizzare il tuo account con lo scope di analisi aggiuntivo. Un messaggio di errore chiaro ti guiderà se lo scope è mancante. Per la maggior parte degli utenti AdOps, i report GAM nativi (68 metriche, 79 dimensioni) coprono tutte le esigenze.

Question 24

OrbiAds sostituisce la mia interfaccia Google Ad Manager?

Accepted Answer

No, OrbiAds non sostituisce l'interfaccia GAM — la completa e la accelera. L'interfaccia Google Ad Manager rimane lo strumento di riferimento per la visualizzazione dettagliata, la convalida manuale e le attività complesse una tantum. OrbiAds eccelle nell'automazione di operazioni ripetitive, distribuzioni in grandi volumi, audit su larga scala e flussi di lavoro guidati dall'IA. I due strumenti coesistono: continui a utilizzare l'interfaccia GAM per la supervisione e utilizzi OrbiAds tramite il tuo agente IA per le attività di esecuzione. Molti team AdOps utilizzano OrbiAds per eliminare le lunghe attività manuali mantenendo una supervisione umana sulle configurazioni finali.

Question 25

Possiamo utilizzare OrbiAds per gestire campagne Display E Video?

Accepted Answer

Sì. OrbiAds gestisce tutti i formati pubblicitari supportati da Google Ad Manager: Display (banner, rich media, HTML5), Video (VAST instream, outstream, bumper), Native (contenuto nativo) e Audio. I 173 strumenti MCP coprono operazioni specifiche per ciascun formato — ad esempio la configurazione di modelli creativi video, la gestione di companion ad o il targeting contestuale per categoria di contenuto. Per le campagne video programmatiche (Open Auction, PMP, PD), OrbiAds gestisce anche le regole di yield e i price floor. Gli Skill disponibili includono procedure dedicate ai flussi di lavoro Display e Video più comuni nel settore.

Question 26

OrbiAds funziona con tutti i tipi di GAM (Small Business, 360)?

Accepted Answer

OrbiAds è compatibile con Google Ad Manager Small Business (precedentemente DFP Small Business) e Google Ad Manager 360 (precedentemente DoubleClick for Publishers Premium). Le funzionalità disponibili dipendono dal tipo di account GAM: alcune API avanzate (segmenti di pubblico proprietari, gruppi di yield avanzati, determinati tipi di report) sono esclusive di GAM 360. OrbiAds utilizza l'API SOAP ufficiale di Google Ad Manager, garantendo la totale compatibilità con tutte le versioni e i tipi di rete supportati da Google. Se non sei sicuro del tipo di account, il tuo Account Manager Google può confermartelo.

Questions fréquentes

Primi passi

Funzionalità e MCP

Prezzi e Crediti

Sicurezza e Dati

Report e Analisi

Casi d'uso e Limitazioni

Pas trouvé votre réponse ?