คอลัมน์ที่บันทึกไว้
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมใช้งานแล้ว โดย API ใหม่จะมี
ความยืดหยุ่นที่เพิ่มขึ้นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลไว้ในแอปพลิเคชันการรายงานของคุณ
และกระบวนการต่างๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลไปยังและการใช้
การรายงาน Search Ads 360 เวอร์ชันใหม่
API
รายงานเกี่ยวกับกิจกรรม Floodlight, เป้าหมาย Google Analytics หรือที่กำหนดเอง
KPI ผู้ลงโฆษณาสามารถลงชื่อเข้าใช้ UI ของ 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
UI ได้ตลอดเวลา หากคำขอที่ระบุคอลัมน์ที่บันทึกไว้ล้มเหลว ให้ลอง
นำคอลัมน์ที่บันทึกไว้ออกจากคำขอและส่งอีกครั้ง
รายงานที่เพิ่มขึ้นต้องไม่มีเมตริกที่ไม่มี
ที่ API รองรับ (เช่น คอลัมน์กิจกรรม Google Analytics) ใน
นอกจากนี้ เนื่องจากผู้ใช้ Search Ads 360 จะกำหนดคอลัมน์ที่บันทึกไว้ใหม่ได้ ส่วนเพิ่ม
รายงานที่มีคอลัมน์ที่บันทึกไว้อาจไม่ถูกต้อง
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 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"]]
