已儲存的資料欄
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
新版 Search Ads 360 Reporting API 現已上線。新版 API 提供
更有彈性,可用來建立自訂報表,以及將資料整合至報表應用程式
和處理程序進一步瞭解如何遷移至及使用
新版 Search Ads 360 報表
API。
如何製作 Floodlight 活動、Google Analytics 目標或自訂報表
主要成效指標,廣告客戶可以登入 Search Ads 360 UI,
更多儲存的資料欄,例如 Floodlight 活動欄、Google Analytics 活動欄或
公式欄:個人中心
可以在報表請求中納入已儲存的欄,以便下載資料,或是
篩選報表。
取得已儲存的資料欄清單
如要查看廣告客戶建立的所有已儲存資料欄,請傳送
SavedColumns.list()
請求。回應會包含
savedColumnName
。
要求提供已儲存資料欄的報表
如要在報表要求中加入已儲存的欄,請新增含有
savedColumnName
屬性已設為資料欄名稱:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
使用已儲存的資料欄時,請注意以下幾點:
已儲存的資料欄是在廣告客戶層級定義。如果您是
在要求中加入已儲存的資料欄
「request.reportScope
」必須指定廣告主或較低層級
範圍。因此,每份報表只能納入
單一廣告客戶。
已儲存的資料欄名稱會區分大小寫、空格敏感,以及
標點符號要區分大小寫。
savedColumnName
屬性必須與已儲存的資料欄名稱相符
當然,如果已儲存的資料欄名稱與
Search Ads 360 會要求您指定
備用和/或資料欄的專屬 headerText
。
您可以在 Search Ads 360 廣告活動管理頁面中修改或移除已儲存的資料欄
隨時調整使用者介面如果指定已儲存資料欄的要求失敗,請嘗試
請從要求中移除已儲存的欄,然後再次傳送。
漸進式報表不得包含未明確列出的指標
支援的 API (例如 Google Analytics 活動欄)。於
此外,由於 Search Ads 360 使用者可重新定義已儲存的資料欄,
包含已儲存資料欄的報表可能並不準確。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-29 (世界標準時間)。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[[["\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"]]