Video: Check out the best practices talk from the 2019 workshop
Questa guida illustra alcune best practice che puoi implementare per ottimizzare l'efficienza e il rendimento delle tue app.
Manutenzione continua
Per assicurarti che la tua app funzioni senza interruzioni:
Mantieni aggiornato l'indirizzo email di contatto dello sviluppatore nel Centro API. Questo è l'alias che utilizziamo per contattarti. Se non riusciamo a contattarti in merito alla conformità ai Termini e condizioni dell'API, il tuo accesso all'API potrebbe essere revocato senza che tu ne sia a conoscenza. Evita di utilizzare un indirizzo email personale collegato a un account individuale o non monitorato. Per visualizzare il Centro API, devi aver eseguito l'accesso al tuo account amministratore.
Per ricevere informazioni su problemi come modifiche ai prodotti, tempi di inattività per la manutenzione, date di ritiro e così via, abbonati al nostro
Assicurati che la tua app sia conforme ai Termini e condizioni dell'API Google Ads (T&C). Se necessario, il team di revisione e conformità dei token ti contatterà utilizzando l'indirizzo email di contatto. Se hai domande o dubbi in merito ai Termini e condizioni, puoi contattare il team di revisione rispondendo all'email che ti ha inviato durante la revisione della tua richiesta di token sviluppatore.
Ottimizzazione
Puoi ottimizzare la tua app eseguendo operazioni batch e, se appropriato, inviando oggetti sparsi.
Operazioni batch
L'invio di una richiesta all'API comporta una serie di costi fissi, come la latenza di rete di andata e ritorno, l'elaborazione di serializzazione e deserializzazione e le chiamate ai sistemi di backend. Per ridurre l'impatto di questi costi fissi e aumentare il rendimento complessivo, la maggior parte dei metodi di modifica dell'API è progettata per accettare un array di operazioni. Raggruppando più operazioni in ogni richiesta, puoi ridurre il numero di richieste che invii e i costi fissi associati. Se possibile, evita di inviare richieste con una sola operazione.
Supponiamo, ad esempio,di voler aggiungere 50.000 parole chiave a una campagna in più gruppi di annunci. Anziché inviare 50.000 richieste con una parola chiave ciascuna, invia 100 richieste con 500 parole chiave ciascuna o anche 10 richieste con 5000 parole chiave ciascuna. Esistono limiti al numero di operazioni consentite in una richiesta, pertanto potrebbe essere necessario modificare le dimensioni del batch per ottenere un rendimento ottimale.
Invia oggetti sparsi
Quando gli oggetti vengono inviati all'API, i campi devono essere deserializzati, convalidati e archiviati nel database. L'invio di oggetti completi quando vuoi aggiornare solo alcuni campi può comportare un tempo di elaborazione aggiuntivo e una riduzione del rendimento.
Per risolvere questo problema, l'API Google Ads supporta gli aggiornamenti sparsi, che ti consentono di compilare solo i campi di un oggetto che devi modificare o che sono obbligatori. Gli aggiornamenti sparsi vengono elaborati più rapidamente e hanno meno probabilità di generare errori.
I campi non presenti in update_mask (noto anche come FieldMask) rimangono invariati.
Ad esempio, un'app che aggiorna le offerte a livello di parola chiave può trarre vantaggio dall'utilizzo di aggiornamenti sparsi, poiché è necessario compilare solo i campi ID gruppo di annunci, ID criterio e offerte.
Gestione degli errori
Durante lo sviluppo, è probabile che si verifichino errori. Questa sezione descrive le considerazioni e le strategie per integrare la gestione degli errori nella tua app. Oltre a questa sezione, consulta la guida alla risoluzione dei problemi per ulteriori informazioni sulla gestione degli errori.
Distinguere le origini delle richieste
Alcune app sono principalmente interattive e inviano chiamate API direttamente in risposta alle azioni avviate dall'utente in un'interfaccia utente. Altre funzionano principalmente offline, inviando chiamate API nell'ambito di un processo di backend periodico. Molte app combinano le due. Quando pensi alla gestione degli errori, può essere utile distinguere questi diversi tipi di richieste.
Per le richieste avviate dall'utente, la tua preoccupazione principale dovrebbe essere quella di offrire una buona esperienza ai tuoi utenti. Utilizza l'errore specifico che si è verificato per fornire all'utente il maggior contesto possibile nell'interfaccia utente. Offri passaggi semplici che possono eseguire per risolvere l'errore (consulta i suggerimenti di seguito).
Per le richieste avviate sul backend, implementa i gestori per i diversi tipi di errori che la tua app potrebbe riscontrare. Includi sempre un gestore predefinito per risolvere errori rari o non riscontrati in precedenza. Un buon approccio per un gestore predefinito è aggiungere l'operazione e l'errore non riusciti a una coda in modo che un operatore umano possa esaminarli e determinare una risoluzione appropriata.
Distinguere i tipi di errore
Conoscere le differenze tra i tipi di errore nell'API Google Ads è fondamentale per creare una gestione degli errori efficace. Di seguito sono riportati alcuni dei tipi di errore più comuni:
- Errori di autenticazione
- Errori ripetibili
- Errori di convalida
- Errori relativi alla sincronizzazione
Per maggiori dettagli, consulta la sezione Tipi di errore e Errori comuni.
Sincronizzare i backend
Se gli utenti della tua app hanno accesso manuale agli account Google Ads, potrebbero apportare modifiche di cui la tua app non è a conoscenza, causando la mancata sincronizzazione del database locale dell'app. Come indicato nella nostra guida Tipi di errore, puoi risolvere gli errori relativi alla sincronizzazione in modo reattivo quando si verificano, ma puoi anche provare a prevenirli in modo proattivo. Una strategia proattiva consiste nell'eseguire un job di sincronizzazione notturno su tutti i tuoi account, recuperando gli oggetti Google Ads nei tuoi account e confrontandoli con il database locale.
Errori nei log
Tutti gli errori devono essere registrati per facilitare il debug e il monitoraggio. Come minimo, registra l'ID richiesta, le operazioni che hanno causato l'errore e l'errore stesso. Altre informazioni da registrare includono l'ID cliente, il servizio API, la latenza della richiesta di andata e ritorno, il numero di tentativi e la richiesta e la risposta non elaborate.
Monitora le tendenze
Assicurati di monitorare le tendenze degli errori dell'API in modo da poter rilevare e risolvere i problemi della tua app. Valuta la possibilità di creare una tua soluzione o di utilizzare uno dei tanti strumenti commerciali disponibili che possono utilizzare i tuoi log per generare dashboard interattive e inviare avvisi automatici.
Sviluppo
Utilizza account di prova durante lo sviluppo.
Utilizza account di prova
Gli account di prova sono account Google Ads che non pubblicano effettivamente annunci. Puoi utilizzare un account di prova per sperimentare l'API Google Ads e verificare che la connettività, la logica di gestione delle campagne o altre elaborazioni della tua app funzionino come previsto. Non è necessario approvare il token sviluppatore per utilizzarlo in un account di prova, quindi puoi iniziare a sviluppare con l'API Google Ads subito dopo aver richiesto un token sviluppatore, anche prima che la tua app venga esaminata.