Elenco di controllo iniziale per sviluppatori Google Ads

Questo elenco di controllo ti guiderà nella procedura per iniziare a utilizzare 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 leggere ed eseguire i passaggi in ordine.

L'elenco contiene tre tipi di elementi:

	Da fare: passaggi necessari per eseguire un determinato compito o configurare una parte specifica dello strumento.
	Informazioni: informazioni non fondamentali per la procedura, ma ti aiuterà a comprendere il contesto o a chiarire alcuni passaggi.
	Avviso:aspetti da tenere presenti durante la perché potrebbero comportare ulteriori sforzi di implementazione o incorrere e rischi potenziali.

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 una lettura consigliata per le informazioni presenti nella documentazione dell'API Google Ads.

Accesso e configurazione

	Chiedi allo sviluppatore dal Centro API dell'account amministratore di livello superiore. Tutti del modulo Accesso API devono essere compilati e i Termini e condizioni accettato. 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, annunci e così via, ma nessuno dei tuoi annunci verrà effettivamente pubblicato (non verranno accumulati costi) e tutte le statistiche dei report saranno pari a 0. A 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 la modalità nostro modello per iniziare. Fornisci il maggior numero di dettagli possibile. Il nostro team di revisione dei token ti contatterà se ha bisogno di maggiori informazioni, ma puoi anche contattarci tramite il nostro modulo di contatto se non ricevi un feedback entro 2 giorni lavorativi.
	Una volta approvato il token sviluppatore, puoi utilizzarlo per effettuare chiamate API agli account di produzione. Inizialmente ti verrà concesso l'abbonamento Basic Accesso, che consente 15.000 operazioni al giorno e un limite di 1000 operazioni di operazioni al giorno.
	Se la domanda viene rifiutata, riceverai un un'email in cui vengono spiegati i motivi. Puoi apportare modifiche alla tua applicazione, ulteriori dettagli sulla tua soluzione e presenta nuovamente la domanda.

Configura una libreria client

	Utilizziamo OAuth 2.0 per autenticare le tue richieste all'API. Segui le istruzioni nel nostro Guida di 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 più comuni. Scarica la raccolta per la lingua che vuoi utilizza e imposta il relativo file di configurazione con le credenziali ottenute in precedenza.

Token sviluppatore - Livelli di accesso

	Leggi le informazioni sui livelli di accesso e decidi se lo strumento richiederà più di 15.000 operazioni per giorno lavorativo in futuro. In caso affermativo, dovrai richiedere Accesso standard per operazioni mutate illimitate e GoogleAdsService.Search e GoogleAdsService.SearchStream richieste al giorno. Tuttavia, rimane soggetto al limite giornaliero di 1000 operazioni GET.
	Consulta il tariffario 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 (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 dal RFM. Gli strumenti a cui gli inserzionisti non hanno accesso e che sono destinati solo all'uso interno sono esenti dal RFM. 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 modello RMF è soggetto a modifiche man mano che l'API cambia. Se decidi per richiedere l'accesso standard, dovrete mantenere il vostro strumento aggiornato le ultime funzionalità minime obbligatorie.
	Assicurati che lo strumento implementi le funzionalità minime obbligatorie.
	Richiedi accesso standard.

Iniziare 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.
	Comprendere le nozioni di base Struttura API delle risorse e Servizi.
	Consulta Modificare e ispezionare gli oggetti e Recuperare gli oggetti.
	Leggi l'articolo sui metadati delle risorse per capire come richiederli in modo dinamico.
	Leggi l'articolo Panoramica delle campagne. per creare e gestire vari tipi di campagne e annunci.

Esempi di codice

	Dai un'occhiata al nostro esempio codice 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 > Scarica le 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 delle campagne > Visualizza 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 usare un account che ha pubblichi annunci da un periodo di tempo sufficiente a generare metriche sul rendimento (consigliamo almeno 7 giorni).
	Fai una rapida panoramica di report e un esempio per riassumere il rendimento di un account negli ultimi 30 giorni utilizzando GoogleAdsService come unica fonte attendibile per la generazione di report di Google Ads.
	Leggi Linguaggio di query Google Ads (GAQL) per comprendere la grammatica, la struttura e i concetti di risorsa, il segmento di pubblico e le metriche.
	Informazioni Metriche dei criteri da comprendere come recuperare i dati sul rendimento per criteri diversi con *_view ad esempio, KeywordView, TopicView e GenderView.

Query Builder interattivo di Google Ads

	Scopri le funzionalità disponibili nello strumento per sviluppatori Query Builder di Google Ads interattivo. Questo strumento basato sul web trova tutti i campi e i filtri disponibile per la risorsa selezionata e genera le query in una in modo adeguato.
	Utilizza l'editor di questo strumento per creare un'istruzione Linguaggio di query Google Ads per una particolare 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, 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 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 attività campagne per emettere queste richieste API in modo da ottenere metriche accurate.

Esempi di codice

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

Automatizza 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 questo capitolo.
	Consulta le Configurazione della fatturazione per capire come gestire i profili e gli account pagamenti in modo programmatico.
	Scopri di più sulle Budget dell'account su comprendere in che modo 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. Tu non sarà in grado di utilizzare questo servizio fino al completamento del processo. Potrai inoltre devono essere impostati per la fatturazione mensile con Google. Contatta il tuo team strategico 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 la registrazione alla fatturazione mensile.
	Contatta il tuo rappresentante aziendale di Google per richiedere l'accesso ai AccountBudgetProposalService di Google.
	Crea una AccountBudgetProposal e assegnarlo a un account. Prova a utilizzare il budget insieme a budget della campagna.

Annunci Shopping

	Se utilizzi Annunci Shopping, dovrai probabilmente usare Google Merchant Center e la relativa API Content for Shopping per gestire 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.
	Recuperare una chiave dell'account di servizio se la tua applicazione deve solo accedere al tuo account Merchant Center. Ma se stai scrivendo un'applicazione di terze parti che deve accedere ai dati Account Merchant Center, consulta le Autorizza richieste 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 Merchant Center e Google Ads.
	Scopri come configurare l'elenco dei prodotti utilizzando l'API Content.
	Consulta la guida Creazione di una campagna Shopping utilizzando l'API Google Ads.

Consigli e modifica dello stato

	Se non hai familiarità con Consigli e Cronologia delle modifiche di Google, provale nell'UI 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à per i suggerimenti eseguendo questo esempio di codice: Consiglio Esempi -> Visualizzazione di consigli sugli 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

Controllo delle versioni

	Quando una versione principale precedente viene ritirata, non è più supportata e le chiamate API effettuate con una versione precedente dell'API non riusciranno. Ricordati di aggiornare seguendo i passaggi riportati sotto.
	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 vecchia versione della libreria client con le 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 per l'API registrato nell' Centro API del tuo computer l'account amministratore sia aggiornato, perché tramite questo metodo ti contatteremo qualora dovessimo per problemi tecnici relativi all'utilizzo dell'API.

Prodotti Google correlati agli annunci

	Google Merchant Center	Google Merchant Center ti consente di caricare i dati del tuo negozio e dei tuoi prodotti su Google e renderlo disponibile per gli annunci Shopping e altri servizi Google.
	Profilo dell'attività	Il profilo della tua attività ti consente di raggiungere e coinvolgere i clienti locali su Ricerca Google e Maps.
	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 e con facilità i codici di monitoraggio e i relativi frammenti di codice, noti collettivamente come tag, sul tuo sito web o nell'app mobile.
	Google Optimize	Google Optimize offre strumenti di test A/B, test del sito web e 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 alla Guide dell'API Google Ads. I concetti di base più importanti sono illustrati in modo approfondito.
	Aggiungi un preferito alla Riferimento 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.
	Consulta gli sviluppatori di Google Ads Canale YouTube.
	Per la configurazione, contatta il tuo rappresentante aziendale / partner manager di Google una riunione per affrontare questioni strategiche più complesse correlati all'API.