Best practice

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

Gestisci l'app

Per assicurarti che l'app venga eseguita senza interruzioni, segui questi passaggi:

  • Assicurati che l'elenco dei proprietari e degli editor del tuo progetto Google Cloud sia aggiornato. Contatteremo questi utenti in caso di emergenze o argomenti relativi alla conformità ai Termini e condizioni dell'API. Se non riusciamo a contattarti in merito alla conformità ai Termini e condizioni dell'API, il tuo accesso all'API potrebbe essere ridotto o revocato.

  • Per ricevere informazioni su problemi quali modifiche ai prodotti, tempi di inattività per manutenzione e date di ritiro, iscriviti al nostro blog sulle API e al blog sui prodotti.

  • Mantieni la tua app conforme ai Termini e condizioni dell'API Google Ads. Se necessario, il team di conformità alle API contatterà i proprietari e gli editor del tuo progetto Google Cloud con accesso all'API. Se hai domande o dubbi sui Termini e condizioni, puoi contattare il team di conformità rispondendo all'email che ti ha inviato durante la revisione della tua richiesta di accesso all'API.

Ottimizzazione

Puoi ottimizzare la tua app eseguendo operazioni batch e, se opportuno, 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 mutate nell'API è progettata per accettare un array di operazioni. Raggruppando più operazioni in ogni richiesta, puoi ridurre il numero di richieste effettuate e i costi fissi associati. Se possibile, 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. Anziché effettuare 50.000 richieste con una parola chiave ciascuna, effettua 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 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 vuoi aggiornare solo alcuni campi può comportare un tempo di elaborazione aggiuntivo e una riduzione delle prestazioni. Per mitigare questo problema, l'API Google Ads supporta gli aggiornamenti sparsi, consentendoti di compilare solo i campi di un oggetto che devi modificare o che sono obbligatori. Gli aggiornamenti sparsi vengono elaborati più velocemente e hanno meno probabilità di generare errori. I campi che non sono 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 parziali, 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 ed eseguono 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 i due approcci. Quando si pensa 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 fornire una buona esperienza agli utenti. Utilizza l'errore specifico che si è verificato per fornire all'utente il maggior contesto possibile nella UI. Offri passaggi chiari che possono seguire per risolvere l'errore (vedi 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 consiste nell'aggiungere l'operazione non riuscita e l'errore a una coda per consentire a un operatore umano di 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 elencati alcuni dei tipi di errore più comuni:

Per saperne di più, consulta Tipi di errori ed Errori comuni.

Sincronizza 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 errori, 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 periodico per riconciliare il database locale con gli oggetti Google Ads nei tuoi account. Per gerarchie di account di grandi dimensioni, evita di estrarre tutti gli oggetti di ogni account ogni notte per non esaurire le quote giornaliere. Esegui invece query su ChangeStatus o filtra le entità modificate di recente per sincronizzare le modifiche in modo incrementale.

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 delle richieste di andata e ritorno, il numero di nuovi tentativi e la richiesta e la risposta non elaborate sottoposte a sanitizzazione (assicurandosi di oscurare le credenziali sensibili come i token OAuth e qualsiasi PII).

Assicurati di monitorare le tendenze degli errori 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 produrre dashboard interattive e inviare avvisi automatici.

Sviluppo

Utilizza account di prova durante lo sviluppo.

Utilizza gli account di prova

Gli account di prova sono account Google Ads che non pubblicano annunci. Puoi utilizzare un account di prova per sperimentare con l'API Google Ads e verificare che la connettività, la logica di gestione delle campagne o altre elaborazioni della tua app funzionino come previsto. Il tuo progetto Google Cloud deve avere solo l'accesso di test per essere utilizzato su un account di test, in modo da poter iniziare subito a sviluppare con l'API Google Ads, in attesa che Google esamini la tua richiesta di livelli di accesso all'API più elevati.

Avanti
Quote e limiti delle API