Demander des rapports
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La nouvelle API Search Ads 360 Reporting est désormais disponible. La nouvelle API vous offre davantage de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications et processus de reporting. En savoir plus sur la migration vers et l'utilisation de la
nouvelle API Search Ads 360 Reporting
Après avoir configuré votre application cliente comme décrit dans Ma première application, vous pouvez demander et télécharger des rapports à l'aide de l'API Search Ads 360. Vous pouvez envoyer l'un des types de requêtes suivants:
- Synchrone
Il suffit d'une seule requête et renvoie le rapport dans une réponse au format JSON. Requêtes synchrones:
- Peut uniquement afficher les rapports sur les annonceurs et les comptes de moteur
- Bloquer votre client jusqu'à ce que Search Ads 360 génère le rapport
Si vous demandez des rapports volumineux sur les annonceurs ou les comptes associés à un moteur, nous vous recommandons d'opter pour l'approche asynchrone.
- Asynchrone
Vous devez envoyer une requête initiale spécifiant les données que vous souhaitez inclure dans le rapport. Vous envoyez ensuite des demandes supplémentaires pour interroger Search Ads 360. Une fois le rapport généré dans Search Ads 360, vous envoyez des demandes de téléchargement de celui-ci sous la forme d'un ou de plusieurs fichiers. Requêtes asynchrones:
- Peut renvoyer n'importe quel type de rapport
- Divise les rapports très volumineux dans plusieurs fichiers
- Mettre en forme les rapports au format CSV ou TSV
Modèle de données: lignes et colonnes
Search Ads 360 organise les données d'un rapport en lignes et en colonnes.
Le type de rapport que vous demandez détermine les lignes qui sont renvoyées.
Par exemple, si vous demandez un rapport sur les mots clés, chaque ligne contient des données sur un seul mot clé. Consultez la documentation de référence sur les types de rapports pour obtenir la liste de tous les types de rapports.
Vous spécifiez les colonnes que vous souhaitez inclure dans le rapport en nommant chaque colonne dans votre demande de rapport. Consultez la documentation de référence Types de rapports pour obtenir la liste des colonnes pouvant être renvoyées pour chaque type de rapport.
Comportements des colonnes
Le comportement d'une colonne dépend du type de données qu'elle contient (la documentation de référence Types de rapports affiche le comportement de chaque colonne):
Colonnes d'attributs : Une colonne d'attributs contient des données qui configurent ou identifient une entité dans une campagne, telles que le nom de la campagne ou une enchère de mot clé. L'API Search Ads 360 renvoie toujours la valeur actuelle d'une colonne d'attribut, quelles que soient la date ou la plage de dates spécifiées dans une requête. Par exemple, si vous avez fait passer l'enchère d'un mot clé de 2,00 à 1,50 hier, et que vous demandez un rapport présentant les données du mois dernier, celui-ci renvoie la valeur 1,50 pour l'enchère de mot clé.
Colonnes de métriques Une colonne de métriques contient des données sur les performances de votre campagne, telles que le nombre de clics sur une annonce, le nombre de visites enregistrées par une balise Floodlight ou les revenus. Sauf si vous spécifiez une période correspondant à un seul jour, l'API renvoie une valeur agrégée pour les colonnes de métriques. Par exemple, si vous demandez un rapport sur les données du mois dernier, l'API affiche le nombre total de clics du mois dernier.
Colonnes de segment : Une colonne de segment divise les données en lignes distinctes.
Par exemple, date est une colonne de segments que vous pouvez spécifier pour de nombreux types de rapports. Si vous spécifiez la colonne date dans un rapport sur les mots clés avec une période du 01/01/2013 au 07/01/2013, l'API affiche sept lignes pour chaque mot clé, chacune correspondant à un jour, et affichant les métriques de ce jour. Consultez Rapports segmentés.
Devises
Votre demande de rapport doit spécifier la devise des données monétaires (attributs tels que dailyBudget et métriques comme cost). Vous pouvez spécifier l'une des valeurs suivantes:
- La devise de l'agence, si le rapport est limité à une agence, à un annonceur ou à un compte associé à un moteur.
- La devise de l'annonceur, si le rapport est limité à un annonceur ou à un compte de moteur.
- La devise du compte de moteur, si le rapport est limité à un compte de moteur
- USD
Utilisez la propriété de requête Reports.request.statisticsCurrency pour spécifier une devise.
Le rapport lui-même indiquera la devise dans la propriété Reports.statisticsCurrencyCode.
Fuseau horaire
Les métriques Search Ads 360 sont stockées à des dates sans fuseau horaire. Ces dates correspondent au fuseau horaire du compte de moteur pour les métriques de moteur (clics, impressions et visites, par exemple) et au fuseau horaire du réseau Campaign Manager pour les statistiques de conversion (actions, transactions et revenus, par exemple). Lorsque chaque métrique d'un rapport provient du même fuseau horaire, celui-ci est renvoyé dans la requête. Sinon, aucun fuseau horaire n'est renvoyé.
Vos requêtes peuvent définir Reports.request.verifySingleTimeZone: true pour que les rapports qui présentent des métriques provenant de plusieurs fuseaux horaires échouent.
Si toutes les métriques présentes dans un rapport proviennent d'un même fuseau horaire, celui-ci est renvoyé dans Reports.statisticsTimeZoneReports.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
