Best practice

Video: guarda la discussione sulle best practice del workshop del 2019

Questa guida illustra alcune best practice che puoi implementare per ottimizzare l'efficienza e le prestazioni delle tue app.

Manutenzione costante

Per assicurarti che l'app venga eseguita senza interruzioni:

  • Mantieni aggiornata l'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 delle API, l'accesso all'API potrebbe essere revocato a tua insaputa. Evita di utilizzare un indirizzo email personale associato a un account individuale o non monitorato.

  • Per ricevere informazioni su problemi quali modifiche ai prodotti, tempi di inattività per manutenzione, date di ritiro e così via, iscriviti al nostro

Il forum è monitorato regolarmente dal team dell'API Google Ads, pertanto è il luogo ideale per pubblicare domande sulle API.

  • Assicurati che la tua app sia conforme ai Termini e condizioni dell'API Google Ads. Se necessario, il team di revisione e conformità dei token ti contatterà utilizzando il tuo indirizzo email di contatto. In caso di domande o dubbi su Termini e condizioni, puoi contattare il team di revisione rispondendo all'email che ti è stata inviata durante l'esame della richiesta del token sviluppatore.

Ottimizzazione

Operazioni batch

L'invio di una richiesta all'API comporta una serie di costi fissi, come la latenza di rete round-trip, l'elaborazione di serializzazione e la deserializzazione e le chiamate ai sistemi di backend. Per ridurre l'impatto di questi costi fissi e aumentare le prestazioni complessive, la maggior parte dei metodi di modifica nell'API è progettata per accettare una serie di operazioni. Raggruppando più operazioni in ogni richiesta, puoi ridurre il numero di richieste effettuate e i costi fissi associati. Se puoi, evita di effettuare richieste con una sola operazione.

Ad esempio, supponiamo che tu stia aggiungendo 50.000 parole chiave a una campagna in più gruppi di annunci. Invece di effettuare 50.000 richieste con una parola chiave ciascuna, effettua 100 richieste con 500 parole chiave ciascuna o persino 10 richieste con 5000 parole chiave ciascuna. Esistono limiti al numero di operazioni consentite in una richiesta, quindi potrebbe essere necessario regolare la dimensione del batch per ottenere prestazioni ottimali.

Invia oggetti sparsi

Quando gli oggetti vengono inviati all'API, i campi devono essere deserializzati, convalidati e archiviati nel database. Il passaggio di oggetti completi quando si desidera aggiornare solo alcuni campi può comportare tempi di elaborazione aggiuntivi e una riduzione delle prestazioni. Per mitigare questo problema, l'API Google Ads supporta aggiornamenti sparsi, che consentono di compilare solo i campi di un oggetto che devi modificare o che sono obbligatori. Gli aggiornamenti sparsi elaborano più velocemente e hanno meno probabilità di generare errori. I campi che non sono inclusi in update_mask (noto anche come FieldMask) non vengono modificati.

Ad esempio, un'app che aggiorna le offerte a livello di parola chiave può trarre vantaggio dall'utilizzo di aggiornamenti sparsi, poiché devono essere compilati solo i campi dell'ID gruppo di annunci, dell'ID criterio e delle offerte.

Gestione e gestione degli errori

Durante lo sviluppo, potresti riscontrare errori. In questa sezione vengono descritte le considerazioni e le strategie per sviluppare 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 una UI. Altre funzionano principalmente offline, l'invio di chiamate API nell'ambito di un processo periodico di backend. Molte app le combinano. Quando si pensa alla gestione degli errori, può essere utile distinguere questi diversi tipi di richieste.

Per le richieste avviate dagli utenti, il tuo problema principale dovrebbe essere garantire una buona esperienza agli utenti. Utilizza l'errore specifico che si è verificato per fornire all'utente il maggior contesto possibile nella UI. Offrite semplici passaggi per risolvere l'errore (dai un'occhiata ai suggerimenti qui sotto).

Per le richieste avviate sul backend, implementa 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 consiste nell'aggiungere l'operazione non riuscita e l'errore a una coda per consentire a un operatore umano di esaminarla e determinare una risoluzione appropriata.

Distinguere i tipi di errori

Conoscere le differenze tra i tipi di errore nell'API Google Ads è fondamentale per creare una solida gestione degli errori. Alcuni dei tipi di errore più comuni sono:

  1. Errori di autenticazione
  2. Errori ripetibili
  3. Errori di convalida
  4. Errori relativi alla sincronizzazione

Per ulteriori dettagli, consulta le sezioni Tipi di errore ed 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 in modo reattivo gli errori di sincronizzazione quando si verificano, ma puoi anche provare a evitarli in modo proattivo. Una strategia proattiva consiste nell'eseguire un job di sincronizzazione notturno su tutti gli account, recuperando gli oggetti Google Ads al loro interno e confrontandoli con il database locale.

Errori di log

Per facilitare il debug e il monitoraggio, è necessario registrare tutti gli errori. Registra almeno l'ID richiesta, le operazioni che hanno causato l'errore e l'errore stesso. Altre informazioni da registrare includono ID cliente, servizio API, latenza delle richieste andata e ritorno, numero di nuovi tentativi e richiesta e risposta non elaborate.

Assicurati di monitorare le tendenze negli errori delle API, in modo da poter rilevare e risolvere i problemi della tua app. Valuta la possibilità di creare la tua soluzione o utilizzare uno dei tanti strumenti commerciali disponibili che possono utilizzare i tuoi log per generare dashboard interattive e inviare avvisi automatici.

Sviluppo

Utilizzare account di prova

Gli account di prova sono account Google Ads che non pubblicano effettivamente annunci. Puoi utilizzare un account di prova per sperimentare con l'API Google Ads e verificare che la connettività dell'app, la logica di gestione delle campagne o altre elaborazioni funzionino come previsto. Non è necessario approvare il token sviluppatore per essere utilizzato su un account di prova, quindi puoi iniziare a sviluppare con l'API Google Ads subito dopo aver richiesto un token sviluppatore, anche prima che l'app venga esaminata.