Elenco di controllo iniziale per sviluppatori Google Ads

Questo elenco di controllo ti guiderà nella procedura per iniziare a utilizzare l'API Google Ads. I passaggi sono suddivisi in diverse categorie, alcune delle quali potresti decidere di saltare se non sono applicabili 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:i passaggi necessari per eseguire una determinata attività o configurare una parte specifica dello strumento.
	Informazioni: informazioni non fondamentali per la procedura, ma che ti aiuteranno a comprendere il contesto o a chiarire determinati passaggi.
	Avviso: aspetti da tenere presenti durante la procedura, in quanto potrebbero comportare un impegno aggiuntivo per l'implementazione o comportare determinati rischi.

Se stai stampando 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 riportate nella documentazione dell'API Google Ads.

Accesso e configurazione

	Ottieni il tuo token sviluppatore dall'API Center del tuo account amministratore di primo livello. Tutti i campi del modulo di accesso all'API devono essere compilati e i Termini e condizioni accettati. Assicurati che l'indirizzo email di contatto dell'API che fornisci indirizzi a una posta in arrivo monitorata regolarmente. Ti verrà emesso 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 account di test. Puoi utilizzare gli account di prova per creare campagne e annunci, ma nessuno dei tuoi annunci verrà effettivamente pubblicato (non verranno generati costi) e tutte le statistiche dei report saranno pari a 0. Per consentire al tuo token sviluppatore di accedere agli account di produzione, deve essere approvato dal nostro team di revisione dei token.
	Per ottenere l'approvazione del token 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. Puoi utilizzare il nostro modello per iniziare. Fornisci il maggior numero di dettagli possibile. Il nostro team di revisione dei token ti contatterà se ha bisogno di ulteriori informazioni, ma se non ricevi un feedback entro 2 giorni lavorativi, puoi anche contattarci tramite il nostro modulo di contatto.
	Una volta approvato il token sviluppatore, 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 get al giorno.
	Se la tua richiesta viene rifiutata, riceverai un'email con i motivi. Puoi apportare modifiche alla tua richiesta, fornire maggiori dettagli sulla tua soluzione e presentare nuovamente domanda.

Configurare una libreria client

	Utilizziamo OAuth 2.0 per autenticare le tue richieste all'API. Segui le istruzioni riportate nella nostra guida su 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 linguaggi di programmazione comuni. Scarica la libreria per la lingua che vuoi usare e configura il relativo file di configurazione con le credenziali ottenute in precedenza.

Token sviluppatore - Livelli di accesso

	Leggi informazioni sui livelli di accesso e decidi se il tuo strumento richiederà più di 15.000 operazioni al giorno in futuro. In questo caso, dovrai richiedere Accesso standard per operazioni mutate illimitate e richieste GoogleAdsService.Search e GoogleAdsService.SearchStream al giorno. Tuttavia, rimane soggetto al limite giornaliero di 1000 operazioni GET.
	Consulta la Tariff Sheet per comprendere come vengono calcolate le operazioni per il tuo livello di accesso. Tieni presente che le richieste GoogleAdsService.Search con il campo page_token impostato non vengono conteggiate ai fini del limite di operazioni.

Funzionalità minime obbligatorie

	Scopri di più sulle funzionalità minime obbligatorie, 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 dal RFM. Gli strumenti a cui gli inserzionisti non hanno accesso e che sono destinati solo all'uso interno sono esenti dal RMF. Se lo strumento genera solo report, verrà applicato solo il RMF per i report. Se il tuo strumento è molto limitato e specializzato, ad esempio solo Shopping o solo promozione di app, si applicherà 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 responsabile della conformità dell'API Google Ads.
	Leggi le informazioni sulle commissioni per mancata conformità per capire cosa succede quando i moduli di risposta ai rischi non vengono implementati correttamente.
	Se lo strumento è destinato a essere utilizzato al di fuori della tua organizzazione (in altre parole, non è uno strumento solo per uso interno), deve implementare i RMF applicabili prima di richiedere l'accesso standard. Ricorda che il RMF è soggetto a modifiche man mano che l'API cambia. Se decidi di richiedere l'accesso standard, dovrai mantenere aggiornato il tuo strumento con le funzionalità minime obbligatorie più recenti.
	Assicurati che lo strumento implementi i RMF applicabili.
	Richiedi accesso standard.

Inizia a utilizzare l'API

	Consulta la sezione Effettuare la prima chiamata all'API, che spiega come ottenere le campagne utilizzando l'API. Tutti gli oggetti sono raggiungibili in modo simile, quindi vale la pena memorizzare la struttura.
	Comprendi la struttura di base delle API di risorse e servizi.
	Consulta Modificare e ispezionare gli oggetti e Recuperare gli oggetti.
	Scopri di più sui metadati delle risorse per capire come richiederli in modo dinamico.
	Leggi la Panoramica delle campagne per creare e gestire vari tipi di campagne e annunci.

Esempi di codice

	Dai un'occhiata ed esegui il nostro codice di esempio per capire come utilizzare l'API. Ti consigliamo di eseguire almeno gli esempi riportati di seguito per capire come gestire gli oggetti Google Ads di base.
	Operazioni di base > Ricevi campagne
	Operazioni di base > Ottenere annunci di testo
	Operazioni di base > Aggiungi campagne
	Operazioni di base > Aggiungi parole chiave
	Operazioni di base > Aggiorna parola chiave
	Gestione campagna > Recupera tutti gli annunci non approvati
	Gestione campagna > Aggiungi modificatore di offerta della campagna
	Gestione account > Visualizza i dati dell'account
	Gestione dell'account > Crea cliente
	Gestione account > Ricevi modifiche all'account

Rapporti

	Per i report, devi utilizzare un account che abbia pubblicato annunci per un periodo di tempo sufficiente a generare metriche sul rendimento (consigliamo almeno 7 giorni).
	Dai un'occhiata a una breve panoramica sui report e a un esempio per riepilogare il rendimento di un account negli ultimi 30 giorni utilizzando GoogleAdsService come unica fonte attendibile per i report nei report Google Ads.
	Consulta Google Ads Query Language (GAQL) per comprendere la grammatica e la struttura delle query, nonché i concetti di risorsa, segmento e metriche.
	Consulta la sezione relativa alle metriche dei criteri per scoprire come recuperare i dati sul rendimento per diversi criteri con le risorse *_view, ad esempio KeywordView, TopicView e GenderView.

Query Builder di Google Ads interattivo

	Scopri le funzionalità disponibili nello strumento per sviluppatori Query Builder di Google Ads interattivo. Questo strumento basato su 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 del linguaggio di query di Google Ads per una determinata risorsa, ad esempio un gruppo di annunci. Copia e incolla l'istruzione GAQL generata nella tua applicazione.

Ricerca di parole chiave

Se non hai dimestichezza con il nostro strumento di pianificazione delle parole chiave, prova a utilizzarlo per scoprire come funziona la pianificazione delle parole chiave nell'interfaccia utente di Google Ads.

L'API Google Ads fornisce diversi servizi che rispecchiano la funzionalità dello Strumento di pianificazione delle parole chiave e ti aiutano nella ricerca delle parole chiave. KeywordPlanIdeaService propone idee per le parole chiave in base a determinati parametri, mentre KeywordPlanService fornisce statistiche stimate sul rendimento delle parole chiave e ti aiuta a valutarne la qualità. Ti consigliamo vivamente di utilizzare un account Google Ads con campagne attive per emettere queste richieste API per 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

Automatizzare i budget

	Consulta la sezione Metodi di pagamento e impostazioni per conoscere le opzioni di fatturazione disponibili in Google Ads, come pagamenti automatici, pagamenti manuali e fatturazione mensile (linea di credito).
	Se non utilizzi la fatturazione mensile e non prevedi di attivarla, puoi saltare questa sezione.
	Consulta la sezione Configurazione di fatturazione per scoprire come gestire i profili pagamenti e gli account pagamenti in modo programmatico.
	Leggi l'articolo sul budget dell'account per capire come i budget possono essere assegnati automaticamente agli account.
	L'utilizzo di AccountBudgetProposalService richiede che il tuo account amministratore Google Ads sia inserito nella lista consentita a questo scopo. Non potrai utilizzare questo servizio finché la procedura non sarà completata. Inoltre, dovrà essere configurata 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 Google.
	Contatta il rappresentante della tua attività in Google per richiedere l'iscrizione alla fatturazione mensile.
	Contatta il rappresentante della tua attività in Google per richiedere l'accesso a AccountBudgetProposalService.
	Crea un AccountBudgetProposal e assegnalo a un account. Prova a utilizzare il budget in combinazione con un budget della campagna.

Annunci Shopping

	Se vuoi utilizzare gli annunci Shopping, probabilmente dovrai utilizzare Google Merchant Center e la relativa API Content per Shopping per gestire i dati di prodotto. Questa sezione descrive i passaggi di base per iniziare a utilizzare questa API.
	Configura un account Merchant Center e ricevi un MerchantID.
	Ottieni una chiave dell'account di servizio se la tua applicazione ha bisogno solo di 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 sulle 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 l'elenco di prodotti utilizzando l'API Content.
	Consulta la guida Creare una campagna Shopping per informazioni sull'utilizzo dell'API Google Ads.

Consigli e modifica dello stato

	Se non hai familiarità con le funzionalità 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 consigli 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, semplici controlli e altro ancora.

RecommendationService

	Leggi la nostra guida su come utilizzare RecommendationService per recuperare e applicare i consigli di Google al tuo account e aumentare il rendimento complessivo degli annunci.
	Scopri le funzionalità di consiglio eseguendo questo esempio di codice: Esempi di consigli -> Ricevere consigli per gli 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.

Rimanere al passo con i tempi

Mantieni aggiornato il codice in base alle modifiche dell'API Google Ads.

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 rimanere al passo con l'API seguendo i passaggi riportati di seguito.
	Quando viene rilasciata una nuova API, scarica la versione più recente della nostra libreria client.
	Aggiungi un preferito alle ultime note di rilascio e controlla le modifiche principali di 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 consulta il forum per ricevere le ultime informazioni sull'API Google Ads.
	Assicurati che l'indirizzo email di contatto dell'API registrato nel Centro API del tuo account amministratore principale sia aggiornato, poiché è il metodo che utilizziamo per contattarti in caso di problemi tecnici relativi all'utilizzo dell'API.

Prodotti Google correlati agli annunci

	Google Merchant Center	Google Merchant Center ti consente di caricare su Google i dati del tuo negozio e dei tuoi prodotti e di 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 su Maps e nella Ricerca Google.
	Google Analytics	Google Analytics fornisce report dettagliati 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 dei tag che consente di aggiornare rapidamente i codici di monitoraggio e i relativi frammenti di codice, noti collettivamente come tag, sul tuo sito web o nella tua app mobile.
	Google Optimize	Google Optimize offre strumenti per i test A/B, i test del sito web e la personalizzazione per aiutare le piccole imprese a offrire esperienze coinvolgenti ai clienti.
	Google Data Studio	Data Studio trasforma i tuoi dati in dashboard e report informativi, facili da leggere e da condividere, nonché completamente personalizzabili.

Richiesta di aiuto

	Aggiungi un preferito alle guide all'API Google Ads. I concetti di base più importanti sono illustrati in modo approfondito.
	Aggiungi un preferito al riferimento all'API Google Ads. Tutte le funzionalità dell'API sono spiegate nel dettaglio.
	Aggiungi un preferito alla pagina di assistenza dell'API Google Ads, che spiega i canali di assistenza principali.
	Visita il canale YouTube Google Ads Developers.
	Contatta il rappresentante della tua attività / il tuo Partner Manager di Google per fissare un appuntamento per risolvere questioni strategiche più complesse relative all'API.