L'API Search Ads 360 Reporting precedente è stata ritirata. Ora puoi creare i report utilizzando la nuova API Search Ads 360 Reporting.
Tieni presente che i metodi get e getByCustomerId nell'API Search Ads 360 Conversion verranno ritirati nel terzo trimestre del 2025. Per continuare ad accedere ai dati sulle conversioni, devi creare un report utilizzando la risorsa conversion con la nuova API Search Ads 360 Reporting. Scopri di più qui.
Le restanti funzioni dell'API Search Ads 360 Conversion continueranno a essere supportate.
Richiedi report
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Dopo aver configurato l'app client come descritto in La mia prima app, puoi utilizzare l'API Search Ads 360 per richiedere e scaricare i report. Puoi effettuare uno dei seguenti tipi di
richieste:
- Sincrono
Richiede una sola richiesta e restituisce il report in una risposta in formato JSON. Richieste sincrone:
Se richiedi report su inserzionisti o account motore di grandi dimensioni, ti consigliamo
l'approccio asincrono.
- Asincrono
Richiede l'invio di una richiesta iniziale in cui sono specificati i dati che vuoi inserire nel report. Dopodiché, invia richieste aggiuntive per eseguire il sondaggio in Search Ads 360. Quando Search Ads 360 termina di generare il report,
invii le richieste per scaricare il report come uno o più file. Richieste asincrone:
- Può restituire qualsiasi tipo di report
- Esegue lo sharding dei report di grandi dimensioni in più file
- Report sui formati come CSV o TSV
Modello dei dati: righe e colonne
Search Ads 360 organizza i dati in un report in righe e colonne.
Il tipo di report richiesto determina le righe che vengono restituite.
Ad esempio, se richiedi un report sulle parole chiave, ogni riga conterrà dati relativi a una singola parola chiave. Consulta il riferimento Tipi di report per un elenco di tutti i tipi di report.
Specifica le colonne da inserire nel report assegnando un nome a ciascuna
colonna nella richiesta di report. Consulta il riferimento Tipi di report per visualizzare l'elenco delle colonne che è possibile restituire per ogni tipo di report.
Comportamenti delle colonne
Il comportamento di una colonna dipende dal tipo di dati contenuti nella colonna (il riferimento Tipi di report mostra il comportamento di ciascuna colonna):
Colonne degli attributi: Una colonna di attributi contiene dati che configurano o identificano un'entità in una campagna, ad esempio il nome della campagna o un'offerta per parola chiave. L'API Search Ads 360 restituisce sempre il valore corrente per una colonna degli attributi, indipendentemente dalla data o dall'intervallo di date specificato in una richiesta. Ad esempio, se ieri hai modificato l'offerta per una parola chiave da 2,00 a 1,50 e poi richiedi un report con i dati del mese scorso, il report restituirà un valore pari a 1,50 per l'offerta per parola chiave.
Colonne delle metriche. Una colonna di metriche contiene dati sul rendimento della tua campagna, come il numero di clic su un annuncio, il numero di visite registrate da un tag Floodlight o le entrate. A meno che non specifichi un intervallo di tempo di un singolo giorno, l'API restituisce un valore aggregato per le colonne delle metriche. Ad esempio, se richiedi un report con i dati del mese scorso, l'API restituirà il numero totale di clic per l'ultimo mese.
Segmenta le colonne: Una colonna di segmenti suddivide i dati in righe separate.
Ad esempio, date è una colonna di segmento che puoi specificare per molti tipi di report. Se specifichi la colonna date in un report sulle parole chiave con un intervallo di date compreso tra il 2013-01-01 e il 2013-01-07, l'API restituirebbe sette righe per ogni parola chiave, ciascuna corrispondente a un giorno e mostrerà le metriche per quel giorno. Consulta Report segmentati.
Valute
La tua richiesta di report deve specificare la valuta dei dati monetari (entrambi gli attributi come dailyBudget e metriche come
cost). Puoi specificare una delle seguenti opzioni:
- La valuta dell'agenzia, se il report ha come ambito un'agenzia, un inserzionista o un account motore.
- La valuta dell'inserzionista, se l'ambito del report è un inserzionista o un account motore.
- La valuta dell'account motore, se l'ambito del report è un account motore.
- €
Utilizza la proprietà della richiesta Reports.request.statisticsCurrency per specificare una valuta.
Il report indicherà la valuta nella proprietà Reports.statisticsCurrencyCode.
Fuso orario
Le metriche di Search Ads 360 vengono memorizzate in date senza fusi orari. Queste date corrispondono al fuso orario dell'account motore per le metriche del motore (come clic, impressioni e visite) e al fuso orario della rete Campaign Manager per le metriche di conversione (come azioni, transazioni ed entrate). Se ogni metrica di un report proviene dallo stesso fuso orario,
tale fuso orario verrà restituito nella richiesta. In caso contrario, non verrà restituito alcun fuso orario.
Le tue richieste possono impostare Reports.request.verifySingleTimeZone: true
in modo che non vengano generati report in cui sono presenti metriche relative a più fusi orari.
Se tutte le metriche presenti in un report provengono da un fuso orario, questo
viene restituito in Reports.statisticsTimeZoneReports.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers enhanced flexibility for building custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eYou can make synchronous requests for quick advertiser and engine account reports, or asynchronous requests for larger reports and various report types.\u003c/p\u003e\n"],["\u003cp\u003eReports are organized into rows based on the report type and columns that you specify in your request, with attribute, metric, and segment columns behaving differently.\u003c/p\u003e\n"],["\u003cp\u003eWhen requesting reports, you need to specify the currency for monetary data, and Search Ads 360 handles time zones based on engine and conversion metric sources.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API allows custom report building and data integration. Reports can be requested synchronously (limited to advertiser/engine account reports, JSON format, blocking) or asynchronously (all report types, CSV/TSV format, multiple files). Data is organized in rows and columns; column behavior varies by type (attribute, metric, segment). Currency for monetary data must be specified and can be the agency's, advertiser's, or engine account's or USD. Time zones are relevant to metric dates.\n"],null,["# Request Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app), you can use the Search Ads 360 API\nto request and download reports. You can make either of the following types of\nrequests:\n\n**[Synchronous](/search-ads/v2/how-tos/reporting/synchronous-requests)**\n\n: Requires just a single request and returns the report in a JSON-formatted response. Synchronous requests:\n\n - Can return only [advertiser](/search-ads/v2/report-types/advertiser) and [engine account](/search-ads/v2/report-types/account) reports\n - Block your client until Search Ads 360 generates the report\n\n\n If you're requesting large advertiser or engine-account reports, we recommend the\n asynchronous approach.\n\n**[Asynchronous](/search-ads/v2/how-tos/reporting/asynchronous-requests)**\n\n: Requires you to send an initial request that specifies the data you want in the\n report. Then you send additional requests to poll Search Ads 360. When Search Ads 360 finishes generating the report,\n you send requests to download the report as one or more files. Asynchronous requests:\n\n - Can return any [report type](/search-ads/v2/report-types)\n - Shards very large reports into multiple files\n - Formats reports as CSV or TSV\n\n### Data model: rows and columns\n\nSearch Ads 360 organizes data in a report into rows and columns.\nThe type of report you request determines the **rows** that are returned.\nFor example, if your request a keyword report, each row will contain data about a single\nkeyword. See the [Report Types](/search-ads/v2/report-types)\nreference for a list of all report types.\nYou specify which **columns** you want in the report by naming each column\nin your report request. See the [Report\nTypes](/search-ads/v2/report-types) reference for the list of columns that can be returned for each report type.\n\n### Column behaviors\n\n\nThe behavior of a column depends on the type of data that the column\ncontains (the [Report Types](/search-ads/v2/report-types) reference\ndisplays each column's behavior):\n\n-\n **Attribute columns**. An attribute column contains data that configures\n or identifies an entity in a campaign, such as the campaign name or a keyword bid. The Search Ads 360 API\n always returns the current value for an attribute column, regardless of any date or\n date range specified in a request. For example, if you changed a keyword's bid from\n 2.00 to 1.50 yesterday and then request a report for last month's data, the report\n will return a value of 1.50 for the keyword bid.\n\n-\n **Metric columns** . A metric column contains data about your campaign's\n performance, such as the number of clicks on an ad, the number of visits as recorded\n by a Floodlight tag, or revenue. Unless you [specify a\n time range](/search-ads/v2/reference/reports#request.timeRange) of a single day, the API returns an aggregate value for metric columns. For\n example, if you request a report for last month's data, the API will return the total\n number of clicks for last month.\n\n-\n **Segment columns** . A segment column splits data into separate rows.\n For example, `date` is a segment column that you can specify for many\n types of reports. If you specify the `date` column in a keyword report\n with a date range 2013-01-01 to 2013-01-07, the API would return seven rows for each\n keyword, each corresponding to one day and displaying metrics for that day. See [Segmented\n Reports](/search-ads/v2/how-tos/reporting/segmented-reports).\n\n### Currencies\n\n\nYour report request is required to specify the currency of monetary data (both attributes like `dailyBudget` and metrics like\n`cost`). You can specify one of the following:\n\n- The agency's currency, if the report is [scoped](/search-ads/v2/reference/reports#request.reportScope) to an agency, advertiser, or engine account.\n- The advertiser's currency, if the report is scoped to an advertiser or engine account.\n- The engine account's currency, if the report is scoped to an engine account.\n- USD\n\n\nUse the [Reports.request.statisticsCurrency](/search-ads/v2/reference/reports#request.statisticsCurrency)\nrequest property to specify a currency.\n\n\nThe report itself will indicate the currency in the ` `[Reports.statisticsCurrencyCode](/search-ads/v2/reference/reports#statisticsCurrencyCode) property.\n\n### Time zone\n\n\nSearch Ads 360 metrics are stored in dates without time zones. These dates correspond to the engine\naccount time zone for engine metrics (such as clicks, impressions, and visits), and\nCampaign Manager network time zone for conversion metrics (such as actions,\ntransactions and revenue). When every metric in a report comes from the same time zone,\nthat time zone will be returned in the request. Otherwise, no time zone will be returned.\nYour requests can set [Reports.request.verifySingleTimeZone](/search-ads/v2/reference/reports#request.verifySingleTimeZone)`: true`\nto fail reports that present metric from more than one time zone.\n\n\nIf all metrics present in a report are from one time zone, that time zone is\nreturned in [Reports.statisticsTimeZoneReports](/search-ads/v2/reference/reports#statisticsTimeZone)."]]
