L'API AdSense Management offre chiamate per generare report nuovi e salvati. Possono contenere semplici analisi come gli utili giornalieri o tabelle molto complesse di percentuali di clic per canale personalizzato e paese. Questa guida presenta un elenco di casi limite che devono essere gestiti correttamente per un'integrazione solida con le API.
Struttura del report
I risultati del report vengono restituiti come oggetto ReportResult. Consulta il riferimento alla risposta alla segnalazione per i dettagli completi.
Utilizzo delle dimensioni cronologiche: DATE, WEEK e MONTH
I report possono essere vuoti o avere intervalli vuoti
Se non si è verificata alcuna attività durante il periodo di tempo specificato nella richiesta, non vengono generate richieste di annunci e il servizio di report non mostrerà righe per tali periodi di tempo. Questo è importante, ad esempio, se stai tracciando un grafico.
Per ulteriori informazioni, consulta la guida relativa alla compilazione delle date.
Richiesta delle dimensioni MONTH e WEEK nello stesso report
Questo report può avere conseguenze negative o impreviste. Se una settimana appartiene a due mesi diversi, mostrerà due righe per la stessa settimana, una per ogni mese.
Esempio
| Dimensioni | Metriche | Data di inizio | Data di fine |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Resi:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* primo giorno della settimana
Soluzione
Rimuovi MONTH dal report.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Compressione dei valori delle dimensioni
Quando richiedi dimensioni come, ad esempio, quelle relative alle piattaforme (desktop, dispositivi mobili di fascia alta e così via), verranno mostrate solo le piattaforme che hanno eseguito l'attività. Se per un determinato giorno, settimana o mese non sono presenti visite da dispositivi mobili di fascia alta, non saranno disponibili informazioni su quella categoria.
Esempio
| Dimensioni | Metriche | Data di inizio | Data di fine |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Resi:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computer | 100 |
| 2014-03 | Dispositivi mobili di fascia alta | 5 |
| 2014-04 | Computer | 75 |
Soluzione
Durante l'elaborazione dei risultati del report, assumi un valore pari a zero per tutti i valori di dimensione che non vengono visualizzati nei risultati:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computer | 100 |
| 2014-03 | Dispositivi mobili di fascia alta | 5 |
| 2014-04 | Computer | 75 |
| 2014-04 | Dispositivi mobili di fascia alta | 0 |
Combinazione di più report contigui
A volte un report è troppo grande per essere generato tutto in una volta e deve essere in batch. In questo caso, prendi in considerazione i seguenti casi:
- Se utilizzi le dimensioni
WEEKoMONTHe dividi il report a metà settimana o un mese, ogni report avrà voci duplicate con dati diversi. - Assicurati che tutti i report abbiano le stesse metriche e dimensioni, poiché i dati potrebbero non essere combinabili utilizzando dimensioni diverse.
Conti speciali
Alcuni utenti potrebbero avere account AdSense con attributi che non prevedi o di cui non conosci. Tieni presente quanto segue:
- Publisher con migliaia di domini o siti
- Publisher con migliaia di unità pubblicitarie o canali personalizzati
- Publisher che desiderano generare rapporti su più client pubblicitari (AdSense per la ricerca, AdSense per i video e così via).
Più account
Gli utenti possono avere accesso a più di un account AdSense. Per questo motivo, è necessario specificare un ID account per ogni chiamata all'API. Una chiamata a accounts.list recupera un elenco di account e all'utente dovrebbe essere visualizzata una finestra di dialogo del selettore di account. Può essere ignorato se il numero di
account recuperati è uno.
Modifiche al fuso orario
I publisher AdSense possono modificare il fuso orario in qualsiasi momento, il che può generare picchi o cali nei report. Per ulteriori informazioni, consulta la guida sui report sui fusi orari locali.