Report incrementali

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API offre maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni e nei processi per la generazione di report. Scopri di più sulla migrazione alla nuova API Search Ads 360 Reporting e su come utilizzarla.

Anziché ricevere un dump di tutti i dati ogni volta che richiedi un report, puoi richiedere periodicamente solo i dati che sono stati modificati dall'ultimo report. Questi report incrementali saranno probabilmente significativamente più piccoli di un report completo.

Se richiedi report incrementali, tieni presente quanto segue:

  • È comunque una buona idea richiedere di tanto in tanto un report completo, nel caso in cui alcune modifiche incrementali vadano perse. Ad esempio, se richiedi report incrementali settimanali nel mese di gennaio, alla fine di febbraio devi richiedere un report completo per gennaio per assicurarti di ottenere tutti i dati di gennaio.
  • Poiché non è sempre possibile determinare se alcune entità sono cambiate, un report incrementale conterrà un'entità se Search Ads 360 sospetta che l'entità sia cambiata. Ciò significa che i report incrementali potrebbero contenere dati che non sono cambiati.

Per richiedere un report incrementale, specifica una delle seguenti proprietà Reports.request.timeRange :

changedMetricsSinceTimestamp=timestamp

Richiede metriche che sono cambiate rispetto al timestamp specificato. Poiché le metriche vengono archiviate con una granularità giornaliera e potrebbero cambiare per un giorno ma non per un altro, queste richieste devono essere segmentate per giorno (la colonna date deve essere presente). Ad esempio, un report keyword con le colonne clicks, actions e date restituirà una riga per ogni parola chiave e data in cui il numero registrato di clic o azioni è cambiato dal timestamp specificato.

Il timestamp non deve risalire a otto giorni prima dell'ora della richiesta. Per acquisire tutte le metriche in evoluzione, assicurati di inviare una richiesta changedMetricsSinceTimestamp almeno una volta ogni 7 giorni e di creare un report completo per ogni data una volta che le metriche sono state liquidate (è più sicuro attendere almeno 7 giorni). Un pattern di esempio è la creazione di due report ogni giorno: un report incrementale per le metriche che sono cambiate nelle ultime 36 ore e un report completo per le metriche che si sono verificate 8 giorni prima.

changedAttributesSinceTimestamp=timestamp

Attributi delle richieste che sono cambiati dopo il timestamp specificato. Una richiesta changedAttributesSinceTimestamp può includere solo colonne di attributi (nessuna colonna di metrica o segmento) e non funziona per i report sugli eventi non elaborati, ad esempio i report conversion. Ad esempio, un report campaign con le colonne dailyBudget e campaignStartDate restituirebbe una riga per ogni campagna il cui budget giornaliero o la data di inizio sono cambiati rispetto al timestamp specificato.

Tieni presente che le modifiche agli attributi principali non vengono acquisite nei report changedAttributesSinceTimestamp. Ad esempio, una parola chiave può ereditare la strategia di offerta dal gruppo di annunci principale. Anche se al gruppo di annunci è assegnata una nuova strategia di offerta, la parola chiave in questione potrebbe non essere visualizzata nel report. Le colonne degli attributi il cui valore dipende dalle entità padre (e pertanto potrebbero cambiare senza essere rilevate dai report changedAttributesSinceTimestamp) hanno in genere il prefisso "effective", come effectiveLabelIds o effectiveBidStartegy.