Các cột đã lưu
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới cung cấp
linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng báo cáo
và quy trình. Tìm hiểu thêm về cách di chuyển sang và sử dụng
Báo cáo Search Ads 360 mới
.
Để báo cáo về hoạt động Floodlight, mục tiêu Google Analytics hoặc báo cáo tuỳ chỉnh
KPI này, nhà quảng cáo có thể đăng nhập vào giao diện người dùng Search Ads 360 rồi tạo một hoặc
cột đã lưu khác, chẳng hạn như cột hoạt động Floodlight, cột hoạt động Google Analytics hoặc
cột công thức. Bạn
có thể bao gồm một cột đã lưu trong yêu cầu báo cáo để tải dữ liệu của báo cáo xuống hoặc
lọc báo cáo.
Xem danh sách các cột đã lưu
Để xem tất cả các cột đã lưu mà nhà quảng cáo đã tạo, hãy gửi
SavedColumns.list()
của bạn. Phản hồi bao gồm
savedColumnName
cho mỗi cột của nhà quảng cáo.
Yêu cầu báo cáo cho các cột đã lưu
Để đưa một cột đã lưu vào yêu cầu báo cáo, hãy thêm một cột có phương thức
Đã đặt thuộc tính savedColumnName thành tên của cột:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
Khi sử dụng cột đã lưu, xin lưu ý rằng:
Các cột đã lưu được xác định ở cấp nhà quảng cáo. Nếu bạn
bao gồm một cột đã lưu trong yêu cầu,
request.reportScope phải chỉ định một nhà quảng cáo hoặc thấp hơn
phạm vi. Do đó, mỗi báo cáo chỉ có thể bao gồm các cột đã lưu cho một
một nhà quảng cáo duy nhất.
Tên cột đã lưu có phân biệt chữ hoa chữ thường, phân biệt khoảng trắng và
phân biệt dấu câu. Chiến lược phát hành đĩa đơn
Thuộc tính savedColumnName cần phải khớp với tên cột đã lưu
. Nếu tên của cột đã lưu giống với tên của
một cột khác trong cùng yêu cầu, thì Search Ads 360 đều yêu cầu bạn chỉ định một
headerText thay thế, duy nhất cho một hoặc cả hai cột.
Bạn có thể sửa đổi hoặc xoá các cột đã lưu trong phần quản lý chiến dịch trên Search Ads 360
Giao diện người dùng mọi lúc; nếu yêu cầu chỉ định các cột đã lưu không thành công, hãy thử
xoá các cột đã lưu khỏi yêu cầu rồi gửi lại yêu cầu.
Báo cáo gia tăng không được chứa chỉ số không rõ ràng
mà API này hỗ trợ (ví dụ: cột hoạt động Google Analytics). Trong
vì người dùng Search Ads 360 có thể xác định lại các cột đã lưu,
báo cáo chứa các cột đã lưu có thể không chính xác.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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"]]
