Colonnes enregistrées
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour générer des rapports sur les activités Floodlight, les objectifs Google Analytics ou les rapports personnalisés
KPI (indicateurs clés de performance), un annonceur peut se connecter à l'interface utilisateur de Search Ads 360 et créer un ou
d'autres colonnes enregistrées, telles que les colonnes d'activité Floodlight, les colonnes d'activités Google Analytics, ou ;
colonnes de formules. Toi
Vous pouvez inclure une colonne enregistrée dans une demande de rapport, soit pour télécharger ses données,
filtrer un rapport.
Obtenir la liste des colonnes enregistrées
Pour voir toutes les colonnes enregistrées qu'un annonceur a créées, envoyez une
SavedColumns.list()
requête. La réponse inclut
savedColumnName
pour chacune des colonnes de l'annonceur.
Demander des rapports pour les colonnes enregistrées
Pour inclure une colonne enregistrée dans une demande de rapport, ajoutez une colonne avec l'attribut
L'attribut savedColumnName est défini sur le nom de la colonne:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
Gardez à l'esprit les points suivants lorsque vous utilisez les colonnes enregistrées:
Les colonnes enregistrées sont définies au niveau de l'annonceur. Si vous utilisez
inclure une colonne enregistrée
dans une requête,
request.reportScope doit spécifier un annonceur ou un niveau inférieur
le champ d'application. Chaque rapport ne peut donc inclure des colonnes enregistrées que pour une
un seul annonceur.
Les noms de colonne enregistrés sont sensibles à la casse, aux espaces blancs
sensibles à la ponctuation. La
L'attribut savedColumnName doit correspondre au nom de la colonne enregistrée
exactement. Si le nom d'une colonne enregistrée est identique à celui d'une
une autre colonne de la même demande, Search Ads 360 vous oblige à spécifier une
alternative et unique headerText pour l'une des colonnes ou les deux.
Vous pouvez modifier ou supprimer les colonnes enregistrées dans la gestion des campagnes Search Ads 360
UI à tout moment ; Si une requête spécifiant des colonnes enregistrées échoue, essayez
en supprimant les colonnes enregistrées
de la demande et en la renvoyant.
Les rapports incrémentiels ne peuvent pas contenir de métriques qui ne sont pas explicitement
prises en charge par l'API (par exemple, les colonnes d'activité Google Analytics). Dans
car les utilisateurs de Search Ads 360 peuvent redéfinir les colonnes enregistrées, les données
les rapports contenant des colonnes enregistrées peuvent ne pas être exacts.
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 increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eLeverage saved columns in the API to report on Floodlight activities, Google Analytics goals, or custom KPIs.\u003c/p\u003e\n"],["\u003cp\u003eRetrieve a list of saved columns using the \u003ccode\u003eSavedColumns.list()\u003c/code\u003e request and include them in report requests by referencing their \u003ccode\u003esavedColumnName\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSaved columns are advertiser-specific and their names are case-sensitive, whitespace-sensitive, and punctuation-sensitive.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports have limitations with certain metrics and saved columns due to their dynamic nature.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows custom report building and data integration. Advertisers can create saved columns (Floodlight, Google Analytics, or formula) in the Search Ads 360 UI to report custom KPIs. To use these, send a `SavedColumns.list()` request to get a list of saved columns and their names. Include saved columns in report requests via the `savedColumnName` attribute. Saved columns are advertiser-specific, case-sensitive, and can be modified or removed. Incremental reports cannot contain unsupported metrics or saved columns.\n"],null,["# Saved Columns\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\nTo report on Floodlight activities, Google Analytics goals, or custom\nKPIs, an advertiser can sign into Search Ads 360 UI and create one or\nmore **saved columns** , such as [Floodlight activity columns](https://support.google.com/searchads/answer/6051170), [Google Analytics activity columns](https://support.google.com/searchads/answer/6073934), or\n[formula columns](https://support.google.com/searchads/answer/6008636). You\ncan include a saved column in a report request either to download its data or to\n[filter a report](/search-ads/v2/how-tos/reporting/filtered-reports).\n\n### Get a list of saved columns\n\n\nTo see all of the saved columns that an advertiser has created, send a\n`\n`[SavedColumns.list()](/search-ads/v2/reference/savedColumns/list)`\n`\nrequest. The response includes the\n`\n`[savedColumnName](/search-ads/v2/reference/reports#request.columns.savedColumnName)`\n` for each of the advertiser's columns.\n\n### Request reports for saved columns\n\n\nTo include a saved column in a report request, add a column with the\n`savedColumnName` attribute set to the name of the column: \n\n```\n{\n \"reportType\": \"advertiser\",\n \"columns\": [\n {\n \"savedColumnName\": string,\n \"headerText\": string,\n }\n ],\n \"filters\": [\n {\n \"column\": {\n \"savedColumnName\": string,\n },\n ...\n },\n ...\n ],\n ...\n}\n```\n\n\nWhen using saved columns, keep in mind that:\n\n-\n Saved columns are defined at the advertiser level. If you are\n including a saved column in a request,\n [request.reportScope](/search-ads/v2/reference/reports#request.reportScope) must specify an advertiser or lower\n scope. Consequently, each report can include saved columns only for a\n single advertiser.\n\n-\n Saved column names are case sensitive, whitespace sensitive and\n punctuation sensitive. The\n [savedColumnName](/search-ads/v2/reference/reports#request.columns.savedColumnName) attribute needs to match the saved column name\n exactly. If the name of a saved column is identical to the name of\n another column in the same request, Search Ads 360 requires you to specify an\n alternate, unique [headerText](/search-ads/v2/reference/reports#request.columns.headerText) for one or both of the columns.\n\n-\n Saved columns can be modified or removed in the Search Ads 360 campaign management\n UI at any time; if a request that specifies saved columns fails, try\n removing the saved columns from the request and sending it again.\n\n-\n [Incremental reports](/search-ads/v2/how-tos/reporting/incremental-reports) cannot contain metrics that are not explicitly\n supported by the API (for example, Google Analytics activity columns). In\n addition, because Search Ads 360 users can redefine saved columns, incremental\n reports containing saved columns might not be accurate.\n\n\u003cbr /\u003e"]]
