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 }
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
equarterEnd
. 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.