ستون های ذخیره شده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
API جدید Search Ads 360 Reporting اکنون در دسترس است. API جدید انعطاف‌پذیری بیشتری برای ایجاد گزارش‌های سفارشی و ادغام داده‌ها در برنامه‌ها و فرآیندهای گزارش‌دهی شما فراهم می‌کند. درباره انتقال و استفاده از
Search Ads 360 Reporting API جدید بیشتر بیاموزید.
برای گزارش فعالیت‌های Floodlight، اهداف Google Analytics یا KPIهای سفارشی، یک تبلیغ‌کننده می‌تواند وارد رابط کاربری Search Ads 360 شود و یک یا چند ستون ذخیره‌شده مانند ستون‌های فعالیت 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 می‌توانند ستون‌های ذخیره‌شده را دوباره تعریف کنند، گزارش‌های افزایشی حاوی ستون‌های ذخیره‌شده ممکن است دقیق نباشند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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"]]
