Report segmentati

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API fornisce Maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni di generazione dei report e processi. Scopri di più sulla migrazione e sull'utilizzo dei nuovi report di Search Ads 360 tramite Google Cloud.

L'API Search Ads 360 restituisce solo dati aggregati, a meno che non vengano richiesti segmenti più dettagliati e i dati di Google Cloud. Ad esempio, la colonna Clic in una parola chiave report riporta il numero totale di clic su una parola chiave durante l'intervallo di tempo specificato.

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

Ma se richiedi un report sulle parole chiave che segmenta per trimestre, per ogni parola chiave verrà vedrai una riga per ogni trimestre e nella colonna Clic saranno elencati 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 sono disponibili dati per un segmento. Ad esempio, in un report sulle parole chiave con la colonna floodlightActivity, una parola chiave e La coppia attività Floodlight non viene visualizzata nel report se non sono attribuite metriche per l'intervallo di date del report.

Alcuni segmenti non sono compatibili con colonne specifiche

Alcuni segmenti possono causare la restituzione di dati non validi per colonne specifiche. Ad esempio, la segmentazione per floodlightActivity è significativo solo se includi colonne che segnalano Floodlight di dati, ad esempio dfaActions, dfaRevenue, dfaTransactions, e dfaWeightedActions. Altri tipi di colonne delle conversioni, ad esempio adWordsConversions) oppure colonne che segnalano metriche del motore (come clic e impressioni), non contengono dati riportati da Floodlight; pertanto restituiscono valori non validi se segmentare un report per floodlightActivity.

Come richiedere un report segmentato

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

La seguente richiesta asincrona è relativa a un report sulle parole chiave segmentato per trimestre. La nella colonna dei clic di ogni riga conterrà il numero totale di clic relativi al 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 timeRange del report include l'intero trimestre. In caso contrario, riceverai solo risultati parziali, il che potrebbe persone pensano che ci sia stata una drastica riduzione dei clic, delle 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 entrambi i campi le colonne di inizio e fine nella richiesta. Ad esempio, in un report trimestrale, includi sia le colonne quarterStart e quarterEnd. L'inclusione di entrambi colonne restituiranno le date di inizio e fine del periodo, per confermare che inclusi i dati relativi a ogni periodo completo.

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

  • Il numero di righe può aumentare in modo esponenziale con ogni segmento aggiuntivo.