Colunas salvas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A nova API Search Ads 360 Reporting já está disponível. A nova API oferece
mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos de geração de relatórios
e processos. Saiba mais sobre como migrar e usar os
novos relatórios do Search Ads 360
API.
Para gerar relatórios sobre atividades do Floodlight, metas do Google Analytics ou
um anunciante pode fazer login na interface do Search Ads 360 e criar um ou
mais colunas salvas, como colunas de atividade do Floodlight, colunas de atividades do Google Analytics ou
colunas de fórmula. Você
pode incluir uma coluna salva em uma solicitação de relatório para fazer o download dos dados ou
filtrar um relatório.
Acessar uma lista de colunas salvas
Para ver todas as colunas salvas que um anunciante criou, envie uma
SavedColumns.list()
solicitação. A resposta inclui
savedColumnName
para cada uma das colunas do anunciante.
Solicitar relatórios das colunas salvas
Para incluir uma coluna salva em uma solicitação de relatório, adicione uma coluna com o
Atributo savedColumnName definido como o nome da coluna:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
Ao usar colunas salvas, lembre-se de que:
As colunas salvas são definidas no nível do anunciante. Se você for
incluir uma coluna salva em uma solicitação,
request.reportScope deve especificar um anunciante ou um nível inferior
do projeto. Consequentemente, cada relatório pode incluir colunas salvas somente para um
um único anunciante.
Os nomes das colunas salvos diferenciam maiúsculas de minúsculas, espaços em branco e
sensíveis à pontuação. A
O atributo savedColumnName precisa corresponder ao nome da coluna salva
exatamente. Se o nome de uma coluna salva for idêntico ao nome da
outra coluna na mesma solicitação, o Search Ads 360 exige que você especifique um
headerText alternativo e exclusivo para uma ou ambas as colunas.
As colunas salvas podem ser modificadas ou removidas no gerenciamento de campanhas do Search Ads 360
interface a qualquer momento. se uma solicitação que especifica colunas salvas falhar, tente
removendo as colunas salvas da solicitação e enviando-a novamente.
Os relatórios incrementais não podem conter métricas que não sejam explicitamente
suportados pela API (por exemplo, colunas de atividade do Google Analytics). Em
adição, já que os usuários do Search Ads 360 podem redefinir as colunas salvas,
os relatórios que contêm colunas salvas podem não ser precisos.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 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"]]
