Panoramica dei report

L'API Campaign Manager 360 offre diversi modi per recuperare i dati degli annunci gestiti tramite Campaign Manager 360.

Servizio di report

La generazione di report utilizzando il servizio Reports comporta un flusso di lavoro in più passaggi per configurare, generare e recuperare i file di report (ad esempio in formato CSV o Excel). Questo è il percorso di generazione dei report standard per l'API Campaign Manager 360 ed è adatto a set di dati di grandi dimensioni, script pianificati automatizzati o applicazioni downstream che utilizzano i file.

Il flusso di lavoro in genere prevede i seguenti passaggi:

  1. Definisci o individua una risorsa Report (specificando dimensioni, metriche, intervalli di date e filtri) salvata con un ID report univoco. Consulta l'articolo Creare e aggiornare i report.
  2. Esegui la generazione del report chiamando il metodo reports.run. In questo modo, l'esecuzione del report viene messa in coda e viene restituita una risorsa File segnaposto. Consulta l'articolo Individua ed esegui report.
  3. Controlla periodicamente lo stato della risorsa File. Poiché questo processo viene eseguito in modo asincrono, lo stato di un file inizierà con PROCESSING e passerà a REPORT_AVAILABLE al termine. Consulta l'articolo Individua ed esegui report.
  4. Recupera i contenuti del file (CSV o Excel) una volta completata la generazione del report. Vedi Scaricare i report.

Esegui report in modo sincrono

Se devi generare un file di report (CSV o Excel) per una piccola quantità di dati, puoi eseguire il report in modo sincrono chiamando il metodo reports.run con il parametro synchronous impostato su true. L'API tenta di generare il report entro un breve periodo di timeout. Se l'esecuzione richiede più tempo, l'esecuzione del report torna automaticamente alla coda asincrona.

Per maggiori dettagli, vedi Report sincroni.

Dati dei report sulle query

Utilizza il metodo reportData.query per eseguire query direttamente sui dati dei report anziché generare un file di report.

  • Invece di creare e salvare una risorsa Report, specifica dimensioni, metriche e altri criteri di filtro o ordinamento direttamente nella richiesta.
  • La risposta contiene dati strutturati del report, eliminando la necessità di eseguire il polling e scaricare un file generato.
  • La richiesta viene eseguita in modo sincrono con un limite di 60 secondi.

Per maggiori dettagli, consulta Eseguire query sui dati dei report JSON.