Zapisane kolumny
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Nowy interfejs Search Ads 360 Reporting API jest już dostępny. Nowy interfejs API zapewnia
większa elastyczność tworzenia raportów niestandardowych i integrowania danych z aplikacjami służącymi do raportowania.
i procesach. Więcej informacji o przechodzeniu do
nowej wersji Search Ads 360 Raportowanie i korzystaniu z niej
API.
Aby tworzyć raporty o aktywnościach Floodlight, celach Google Analytics lub niestandardowych
wskaźnikami KPI, reklamodawca może zalogować się w interfejsie Search Ads 360 i utworzyć
więcej zapisanych kolumn, takich jak kolumny aktywności Floodlight, kolumny aktywności Google Analytics lub
kolumn z formułami. Ty
może uwzględnić zapisaną kolumnę w żądaniu raportu, aby pobrać jego dane lub
filtrować raport.
Pobierz listę zapisanych kolumn
Aby zobaczyć wszystkie zapisane kolumny utworzone przez reklamodawcę, wyślij
SavedColumns.list()
użytkownika. Odpowiedź zawiera parametr
savedColumnName
dla każdej kolumny reklamodawcy.
Żądanie raportów dotyczących zapisanych kolumn
Aby uwzględnić zapisaną kolumnę w żądaniu raportu, dodaj kolumnę z
Atrybut savedColumnName ma nazwę kolumny:
{
"reportType": "advertiser",
"columns": [
{
"savedColumnName": string,
"headerText": string,
}
],
"filters": [
{
"column": {
"savedColumnName": string,
},
...
},
...
],
...
}
Podczas korzystania z zapisanych kolumn pamiętaj, że:
Zapisane kolumny definiuje się na poziomie reklamodawcy. Jeśli jesteś
uwzględnianie w żądaniu zapisanej kolumny,
request.reportScope musi określić reklamodawcę lub mniejszą liczbę
zakresu. Każdy raport może zawierać zapisane kolumny tylko dla
jednego reklamodawcy.
W nazwach zapisanych kolumn uwzględniana jest wielkość liter, spacje i
czy interpunkcja.
Atrybut savedColumnName musi pasować do nazwy zapisanej kolumny
dokładnie. Jeśli nazwa zapisanej kolumny jest taka sama jak nazwa
innej kolumny w tym samym żądaniu, Search Ads 360 wymaga określenia
alternatywne, niepowtarzalne headerText w jednej lub obu kolumnach.
Zapisane kolumny można zmieniać i usuwać w sekcji zarządzania kampanią w Search Ads 360
interfejs w dowolnym momencie; jeśli nie uda się zrealizować żądania, które wskazuje zapisane kolumny, spróbuj
usuniesz z żądania zapisane kolumny i wyślesz je ponownie.
Raporty przyrostowe nie mogą zawierać danych, które nie są wyraźnie określone
obsługiwane przez interfejs API (np. kolumny aktywności Google Analytics). W
Użytkownicy Search Ads 360 mogą zmieniać
zapisane kolumny,
raporty zawierające zapisane kolumny mogą być niedokładne.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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"]]
