Report segmentati

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.

L'API Search Ads 360 restituisce solo dati aggregati, a meno che tu non richieda dati segmentati più dettagliati. Ad esempio, nella colonna Clic in un report sulle parole chiave viene indicato il numero totale di clic effettuati su una parola chiave durante l'intervallo di tempo specificato.

keywordText	keywordLandingPage	clicks
widget	http://www.example.com	6000

Tuttavia, se richiedi un report sulle parole chiave che segmenti per trimestre, per ogni parola chiave vedrai una riga per ogni trimestre e la colonna dei clic riporterà i totali trimestrali.

keywordText	keywordLandingPage	quarterStart	quarterEnd	clicks
widget	http://www.example.com	2012-01-01	2012-03-31	1000
widget	http://www.example.com	2012-04-01	2012-06-30	1000
widget	http://www.example.com	2012-07-01	2012-09-30	1000
widget	http://www.example.com	2012-10-01	2012-12-31	3000

Tieni presente che un report segmentato restituisce una riga solo se i dati relativi a un segmento sono disponibili. Ad esempio, in un report sulle parole chiave con la colonna floodlightActivity, la coppia di parole chiave e attività Floodlight non verrà visualizzata nel report se non sono presenti metriche attribuite per l'intervallo di date del report.

Alcuni segmenti non sono compatibili con colonne specifiche

A causa di alcuni segmenti, colonne specifiche potrebbero restituire dati non validi. Ad esempio, la segmentazione per floodlightActivity è significativa solo se includi colonne che segnalano dati Floodlight, come dfaActions, dfaRevenue, dfaTransactions e dfaWeightedActions. Altri tipi di colonne di conversione (ad esempio adWordsConversions) o di colonne che segnalano le metriche del motore (come clic e impressioni) non contengono dati riportati da Floodlight, pertanto restituiscono valori non validi se segmenti un report in base a floodlightActivity.

Come richiedere un report segmentato

Per richiedere un report segmentato, includi una colonna che indichi il suo comportamento segment nel riferimento Tipi di report.

La seguente richiesta asincrona riguarda un report sulle parole chiave segmentato per trimestre. La colonna Clic in ogni riga conterrà il numero totale di clic per il trimestre:

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  

Nota: fai attenzione alle date. Se richiedi un report trimestrale, assicurati che il valore timeRange del report includa l'intero trimestre. In caso contrario, otterrai solo risultati parziali che potrebbero far credere agli utenti che ci sia stata una riduzione drastica in termini di clic, entrate e così via.

Richiesta di più segmenti

In una richiesta puoi includere più di una colonna di segmenti. Tieni presente quanto segue:

• Se esegui la segmentazione per settimana, mese o trimestre, ti consigliamo di includere nella richiesta entrambe le colonne di inizio e fine. Ad esempio, in un report trimestrale includi entrambe le colonne quarterStart e quarterEnd. L'inclusione di entrambe queste colonne genererà le date di inizio e di fine del periodo, confermando così di aver incluso i dati per ogni periodo completo.

• Nella stessa richiesta non puoi includere tipi diversi di segmenti relativi al tempo. Ad esempio, non puoi segmentare per trimestre e mese nella stessa richiesta.

• Il numero di righe potrebbe aumentare in modo esponenziale a ogni segmento aggiuntivo.