Elenco di controllo iniziale per sviluppatori Google Ads

Questo elenco di controllo ti guiderà attraverso la procedura per iniziare a utilizzare l'API Google Ads. I passaggi sono suddivisi in diverse categorie, alcune delle quali possono essere ignorate se non sono pertinenti alle tue esigenze. Per ottenere il massimo da questo documento, leggi ed esegui i passaggi in ordine.

L'elenco contiene tre tipi di elementi:

	Da fare: passaggi necessari per eseguire una determinata attività o per configurare una parte specifica dello strumento.
	Informazioni: informazioni che non sono fondamentali per la procedura, ma aiuteranno a comprendere il contesto o a chiarire determinati passaggi.
	Avviso: tieni presente questi aspetti durante la procedura, in quanto potrebbero comportare attività di implementazione aggiuntive o determinati rischi.

Se stampi l'elenco di controllo, puoi utilizzare le caselle di controllo a sinistra per contrassegnare i passaggi completati. Questo elenco di controllo fornisce un ordine di lettura consigliato per le informazioni che si trovano nei documenti dell'API Google Ads.

Accesso e configurazione

	Ottieni il token per sviluppatori dal Centro API del tuo account amministratore di primo livello. È necessario compilare tutti i campi del modulo di accesso all'API e accettare i Termini e condizioni. Assicurati che l'indirizzo email di contatto per l'API che fornisci rimandi a una Posta in arrivo monitorata regolarmente. Ti verrà inviato un token sviluppatore con il livello di accesso all'account di prova.
	Questo è tutto ciò che ti serve per provare l'API Google Ads con gli account di prova. Puoi utilizzare gli account di prova per creare campagne, annunci e così via, ma nessuno degli annunci verrà effettivamente pubblicato (costi di accumulazione) e tutte le statistiche dei report saranno pari a 0. Per consentire al tuo token sviluppatore di accedere agli account di produzione, il token deve essere approvato dal nostro team di revisione dei token.
	Per far sì che il token venga approvato per l'accesso in produzione, devi compilare il nostro modulo di richiesta di follow-up e spiegare come intendi utilizzare l'API. Dovrai anche fornire un documento di progettazione. Per iniziare, puoi utilizzare il nostro modello. Fornisci il maggior numero di dettagli possibile. Il nostro team di revisione dei token ti contatterà se avrà bisogno di ulteriori informazioni, ma puoi anche farlo tramite il nostro modulo di contatto se non riceviamo feedback entro 2 giorni lavorativi.
	Una volta approvato il token per sviluppatori, puoi utilizzarlo per effettuare chiamate API agli account di produzione. Inizialmente ti verrà concesso l'accesso di base, che consente 15.000 operazioni al giorno e un limite di 1000 operazioni di tipo get al giorno.
	Se la richiesta viene rifiutata, riceverai un'email in cui sono spiegati i motivi. Puoi apportare modifiche alla tua applicazione, fornire maggiori dettagli sulla soluzione e presentare nuovamente domanda.

Configurare una libreria client

	Utilizziamo OAuth 2.0 per autenticare le tue richieste tramite l'API. Segui le istruzioni nella nostra guida OAuth 2.0 per configurare le credenziali per OAuth 2.0. Per la risoluzione dei problemi, puoi utilizzare OAuth 2.0 Playground.
	Forniamo librerie client per alcuni dei linguaggi di programmazione più comuni. Scarica la libreria per la lingua che vuoi usare e imposta il file di configurazione con le credenziali ottenute in precedenza.

Token sviluppatore - Livelli di accesso

	Leggi ulteriori informazioni sui livelli di accesso e decidi se il tuo strumento richiederà più di 15.000 operazioni al giorno in futuro. Se sarà così, dovrai richiedere l'accesso standard per il numero illimitato di operazioni mutate e richieste GoogleAdsService.Search e GoogleAdsService.SearchStream al giorno. Tuttavia, è comunque soggetto al limite giornaliero di 1000 operazioni get.
	Consulta il tariffario per capire come vengono calcolate le operazioni per il tuo livello di accesso. Nota: le richieste GoogleAdsService.Search con il set di campi page_token non vengono conteggiate ai fini del limite delle operazioni.

Funzionalità minime obbligatorie

	Scopri di più sulla funzionalità minima obbligatoria (RMF), ovvero un insieme di funzioni che lo strumento deve implementare in base alla sua natura.
	Gli strumenti che possono funzionare con l'accesso di base, ovvero meno di 15.000 richieste al giorno, sono esenti da RMF. Gli strumenti a cui gli inserzionisti non hanno accesso e che sono destinati esclusivamente a uso interno sono esenti dalle funzionalità minime obbligatorie. Se il tuo strumento esegue solo la generazione di report, verrà applicato solo il RMF dei report. Se il tuo strumento è molto limitato e specializzato, ad esempio Solo Shopping o Promozione di app, verrà applicata solo la parte del RMF utilizzata dallo strumento. Se non sai con certezza se le norme relative alle funzionalità minime obbligatorie si applicano al tuo strumento, contatta il team per la conformità dell'API Google Ads.
	Leggi le Tariffe per la non conformità per capire cosa succede quando le funzionalità minime obbligatorie non vengono implementate correttamente.
	Se lo strumento è destinato all'utilizzo al di fuori della tua organizzazione (in altre parole, non è uno strumento esclusivamente interno), deve implementare le funzionalità minime obbligatorie applicabili prima di richiedere l'accesso standard. Ricorda che le funzionalità minime obbligatorie sono soggette a variazioni quando l'API cambia. Se decidi di richiedere l'accesso standard, dovrai mantenere il tuo strumento aggiornato con la versione più recente di RMF.
	Assicurati che il tuo strumento implementi le funzionalità minime obbligatorie applicabili.
	Richiedi l'accesso standard.

Iniziare a utilizzare l'API

	Leggi l'articolo Effettuare la prima chiamata API, in cui viene spiegato come ottenere campagne utilizzando l'API. Tutti gli oggetti sono raggiungibili in modo simile, quindi vale la pena memorizzarne la struttura.
	Conoscere la struttura API di risorse e servizi di base.
	Consulta le sezioni Modifica e ispezione degli oggetti e Recupero degli oggetti.
	Leggi ulteriori informazioni sui metadati delle risorse per capire come richiederli in modo dinamico.
	Per creare e gestire i vari tipi di campagne e annunci, consulta Panoramica delle campagne.

Esempi di codice

	Consulta ed esegui il nostro codice campione per capire come utilizzare l'API. Ti consigliamo di eseguire almeno i seguenti esempi per capire come gestire gli oggetti di base di Google Ads.
	Operazioni di base > Visualizza campagne
	Operazioni di base > Visualizza annunci di testo espansi
	Operazioni di base > Aggiungi campagne
	Operazioni di base > Aggiungi parole chiave
	Operazioni di base > Aggiorna parola chiave
	Gestione campagna > Ricevi tutti gli annunci non approvati
	Gestione campagna > Aggiungi modificatore di offerta a livello di campagna
	Gestione account > Informazioni sull'account
	Gestione account > Crea cliente
	Gestione dell'account > Scarica modifiche all'account

Report

	Per i report, devi utilizzare un account che ha pubblicato annunci per un periodo di tempo sufficiente per generare metriche sul rendimento (consigliamo almeno 7 giorni).
	Dai una rapida panoramica ai report e un esempio per riepilogare il rendimento di un account negli ultimi 30 giorni utilizzando GoogleAdsService come unica fonte attendibile per la generazione di report nei report Google Ads.
	Leggi attentamente il Google Ads Query Language (GAQL) per comprendere la grammatica e la struttura delle query, nonché i concetti di risorse, segmento e metriche.
	Scopri di più sulle Metriche dei criteri per capire come recuperare i dati sul rendimento per criteri diversi con le risorse *_view, ad esempio KeywordView, TopicView e GenderView.

Query Builder interattivo di Google Ads

	Scopri le funzionalità disponibili nello strumento per sviluppatori Query Builder interattivo di Google Ads. Questo strumento basato sul web trova tutti i campi e i filtri disponibili per la risorsa selezionata e genera le query in modo interattivo.
	Utilizza l'editor in questo strumento per creare un'istruzione Google Ads Query Language per una determinata risorsa, ad esempio un gruppo di annunci. Copia e incolla l'istruzione GAQL generata nell'applicazione.

Ricerca di parole chiave

Se non conosci il nostro Strumento di pianificazione delle parole chiave, provalo per scoprire come funziona la pianificazione delle parole chiave nell'interfaccia utente di Google Ads.

L'API Google Ads fornisce diversi servizi che rispecchiano le funzionalità dello Strumento di pianificazione delle parole chiave e facilitano la ricerca di parole chiave. Lo strumento KeywordPlanIdeaService propone idee per le parole chiave in base a determinati parametri, mentre lo strumento KeywordPlanService fornisce statistiche stimate sul rendimento delle parole chiave e consente di valutarne la qualità. Ti consigliamo vivamente di utilizzare un account Google Ads con campagne attive per inviare queste richieste API e ottenere metriche accurate.

Esempi di codice

	Scopri le funzionalità di pianificazione delle parole chiave eseguendo gli esempi di codice riportati di seguito.
	Esempi di pianificazione -> Genera metriche di previsione
	Esempi di pianificazione -> Genera idee per le parole chiave

Automatizza i budget

	Scopri di più su metodi e impostazioni di pagamento per comprendere le opzioni di fatturazione disponibili in Google Ads, come i pagamenti automatici, i pagamenti manuali, la fatturazione mensile (linea di credito).
	Se non utilizzi la fatturazione mensile e non prevedi di registrarti, puoi semplicemente saltare questo capitolo.
	Consulta la pagina Configurazione di fatturazione per capire come gestire i profili pagamenti e gli account pagamenti in modo programmatico.
	Leggi ulteriori informazioni sul budget dell'account per capire come assegnare automaticamente i budget agli account.
	L'utilizzo di AccountBudgetProposalService richiede l'inserimento del tuo account amministratore Google Ads nella lista consentita a questo scopo. Non potrai utilizzare questo servizio fino al completamento del processo. Dovrai inoltre configurare la fatturazione mensile con Google. Contatta il tuo Strategic Partner Manager (SPM) di Google per organizzare questa procedura. L'accesso è disponibile solo per i partner di Google.
	Contatta il tuo rappresentante aziendale di Google per richiedere la registrazione per la fatturazione mensile.
	Contatta il tuo rappresentante aziendale di Google per richiedere l'accesso a AccountBudgetProposalService.
	Crea una AccountBudgetProposal e assegnala a un account. Prova a utilizzare il budget insieme a un budget della campagna.

Annunci Shopping

	Se utilizzerai gli annunci Shopping, probabilmente dovrai utilizzare Google Merchant Center e la relativa API Content for Shopping per gestire i dati di prodotto. In questa sezione vengono descritti i passaggi di base per iniziare a utilizzare l'API.
	Crea un account Merchant Center e ottieni un MerchantID.
	Ricevi una chiave dell'account di servizio se la tua applicazione deve solo accedere al tuo account Merchant Center. Tuttavia, se stai scrivendo un'applicazione di terze parti che deve accedere agli account Merchant Center dei tuoi clienti, consulta la guida Richieste di autorizzazione con OAuth 2.0.
	Scarica una libreria client per la lingua che preferisci.
	Visualizza gli esempi di codice dell'API Content per Java, .NET, PHP, Python e così via.
	Scopri come collegare manualmente gli account Merchant Center e Google Ads.
	Scopri come configurare il tuo elenco di prodotti utilizzando l'API Content.
	Consulta la guida Creazione di una campagna Shopping con l'API Google Ads.

Consigli e stato delle modifiche

	Se non conosci le funzionalità di consigli e cronologia delle modifiche, provale nell'interfaccia utente di Google Ads.
	L'API Google Ads fornisce due servizi che rispecchiano queste funzionalità: RecommendationService propone suggerimenti di ottimizzazione con impatto stimato, mentre ChangeStatusService recupera la cronologia delle modifiche nel tuo account, che può essere utilizzata per diversi scopi, come la sincronizzazione delle copie locali, il controllo semplice e altro ancora.

RecommendationService

	Leggi la nostra guida su come utilizzare RecommendationService per recuperare e applicare i suggerimenti di Google al tuo account al fine di aumentare il rendimento complessivo degli annunci.
	Scopri le funzionalità per i suggerimenti eseguendo questo esempio di codice: Esempi di consigli -> Recupero di consigli per annunci di testo.

ChangeStatusService

	Leggi la nostra guida su come utilizzare ChangeStatusService per recuperare la cronologia delle modifiche e tenere traccia delle modifiche apportate al tuo account, ad esempio campagne e annunci.
	Scopri le funzionalità della cronologia delle modifiche eseguendo questo esempio di codice: ChangeStatus Samples -> Get Account changes (Scarica modifiche all'account).

Sempre al passo con i tempi

Controllo delle versioni

	Quando una versione principale precedente viene ritirata, non è più supportata e le chiamate API effettuate utilizzando una versione precedente dell'API non andranno a buon fine. Ricorda di restare al passo con l'API seguendo i passaggi riportati di seguito.
	Quando viene rilasciata una nuova API, ottieni la versione più recente della nostra libreria client.
	Aggiungi un preferito alle ultime Note di rilascio ed esamina le principali modifiche in ogni versione.
	Sostituisci le chiamate alla versione precedente della libreria client con chiamate alla nuova versione.
	Segui questo blog per iscriverti al nostro feed RSS e ricevere i post del blog via email e visita il forum per ricevere le ultime informazioni sull'API Google Ads.
	Assicurati che l'indirizzo email di contatto per l'API registrato nel Centro API del tuo account amministratore principale sia aggiornata, poiché è tramite questo metodo che ti contatteremo in caso di problemi tecnici relativi al tuo utilizzo dell'API.

Prodotti Google correlati agli annunci

	Google Merchant Center	Google Merchant Center ti aiuta a caricare i dati del tuo negozio e di prodotto su Google e a renderli disponibili per gli annunci Shopping e altri servizi Google.
	Profilo dell'attività	Il profilo della tua attività ti aiuta a raggiungere e coinvolgere i clienti locali sulla Ricerca Google e su Maps.
	Google Analytics	Google Analytics fornisce report approfonditi su come gli utenti utilizzano il tuo sito web. Puoi utilizzare Google Analytics per scoprire quali operazioni eseguono gli utenti dopo aver fatto clic sui tuoi annunci.
	Google Tag Manager	Google Tag Manager è un sistema di gestione tag (TMS) che consente di aggiornare rapidamente e facilmente i codici di monitoraggio e i relativi frammenti di codice, collettivamente chiamati tag, sul tuo sito web o nella tua app mobile.
	Google Optimize	Google Optimize offre strumenti di test A/B, di siti web e personalizzazione alle piccole imprese per offrire ai clienti esperienze coinvolgenti.
	Google Data Studio	Data Studio trasforma i tuoi dati in dashboard e report informativi, facili da leggere e condividere e completamente personalizzabili.

Richiesta di aiuto

	Aggiungi un segnalibro alle guide dell'API Google Ads. La maggior parte dei concetti di base vengono spiegati dettagliatamente.
	Aggiungi un preferito al riferimento dell'API Google Ads. Tutte le funzionalità dell'API sono spiegate in dettaglio nel documento.
	Aggiungi un segnalibro alla pagina di assistenza per l'API Google Ads, in cui vengono illustrati i principali canali di assistenza.
	Dai un'occhiata al canale YouTube degli sviluppatori Google Ads.
	Contatta il tuo rappresentante aziendale / partner manager di Google per fissare un incontro e risolvere problemi strategici più complessi relativi all'API.