Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
มุมมอง_กลุ่มโฆษณา_กลุ่มโฆษณา
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา รวมถึงข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสําหรับโฆษณาเครือข่าย Display และเครือข่าย YouTube รวมถึงรายการรีมาร์เก็ตติ้งสําหรับโฆษณา Search (RLSA) ที่รวบรวมในระดับกลุ่มเป้าหมาย
คุณอาจเลือกช่องจากแหล่งข้อมูลข้างต้นพร้อมกับแหล่งข้อมูลนี้ในคำสั่ง SELECT และ WHERE ช่องเหล่านี้จะไม่แบ่งกลุ่ม เมตริกในประโยค SELECT
ฟิลด์จากแหล่งข้อมูลข้างต้นจะแบ่งกลุ่ม เมตริกเมื่อเลือกพร้อมกับแหล่งข้อมูลนี้ในคำสั่ง SELECT และ WHERE
ฟิลด์/กลุ่ม/เมตริก
หน้านี้แสดงเมตริกและกลุ่มทั้งหมดที่สามารถใส่ในวลี SELECT เดียวกับช่องของ ad_group_audience_view
อย่างไรก็ตาม เมื่อคุณระบุ ad_group_audience_view
ในคำสั่ง FROM เมตริกและกลุ่มบางอย่างจะใช้ไม่ได้
ใช้ตัวกรองต่อไปนี้เพื่อแสดงเฉพาะช่องที่ใช้ได้เมื่อระบุ ad_group_audience_view
ในอนุประโยค FROM
มีการระบุ ad_group_audience_view
ในอนุประโยค FROM ของคําค้นหาไหม
ไม่
ใช่แล้ว
ad_group_audience_view.resource_name
คำอธิบายช่อง ชื่อทรัพยากรของมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา ชื่อทรัพยากรมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณามีรูปแบบดังนี้ customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}
หมวดหมู่ ATTRIBUTE
ประเภทข้อมูล RESOURCE_NAME
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
เรียงลำดับได้ เท็จ
ซ้ำ เท็จ
segments.ad_network_type
คำอธิบายช่อง ประเภทเครือข่ายโฆษณา
หมวดหมู่ SEGMENT
ประเภทข้อมูล
ENUM
CONTENT
MIXED
SEARCH
SEARCH_PARTNERS
UNKNOWN
UNSPECIFIED
YOUTUBE_SEARCH
YOUTUBE_WATCH
พิมพ์ URL google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.conversion_action_name
คำอธิบายช่อง ชื่อการกระทำที่ถือเป็น Conversion
หมวดหมู่ SEGMENT
ประเภทข้อมูล STRING
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.date
คำอธิบายช่อง วันที่ที่ใช้เมตริก รูปแบบ ปปปป-ดด-วว เช่น 2018-04-17
หมวดหมู่ SEGMENT
ประเภทข้อมูล DATE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.device
คำอธิบายช่อง อุปกรณ์ที่ใช้เมตริก
หมวดหมู่ SEGMENT
ประเภทข้อมูล
ENUM
CONNECTED_TV
DESKTOP
MOBILE
OTHER
TABLET
UNKNOWN
UNSPECIFIED
พิมพ์ URL google.ads.searchads360.v0.enums.DeviceEnum.Device
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.month
คำอธิบายช่อง เดือนที่แสดงโดยวันที่ของวันแรกของเดือน มีรูปแบบเป็น yyyy-MM-dd
หมวดหมู่ SEGMENT
ประเภทข้อมูล DATE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.quarter
คำอธิบายช่อง ไตรมาสที่แสดงโดยวันที่แรกของไตรมาส ใช้ปีปฏิทินสำหรับไตรมาส เช่น ไตรมาสที่ 2 ของปี 2018 จะเริ่มในวันที่ 01-04-2018 โดยจัดรูปแบบเป็น yyyy-MM-dd
หมวดหมู่ SEGMENT
ประเภทข้อมูล DATE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.week
คำอธิบายช่อง สัปดาห์ที่กำหนดไว้เป็นวันจันทร์ถึงวันอาทิตย์และแสดงตามวันที่ของวันจันทร์ โดยจัดรูปแบบเป็น yyyy-MM-dd
หมวดหมู่ SEGMENT
ประเภทข้อมูล DATE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
segments.year
คำอธิบายช่อง ปีในรูปแบบ yyyy
หมวดหมู่ SEGMENT
ประเภทข้อมูล INT32
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.all_conversions
คำอธิบายช่อง จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมด ไม่ว่าค่าของ include_in_conversions_metric จะเป็นอย่างไร
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.all_conversions_by_conversion_date
คำอธิบายช่อง จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมดโดยไม่คำนึงถึงค่า include_in_conversions_metric เมื่อเลือกคอลัมน์นี้ด้วยวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.all_conversions_value
คำอธิบายช่อง มูลค่าของ Conversion ทั้งหมด
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.all_conversions_value_by_conversion_date
คำอธิบายช่อง มูลค่าของ Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้ด้วยวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.clicks
คำอธิบายช่อง จํานวนคลิก
หมวดหมู่ METRIC
ประเภทข้อมูล INT64
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.client_account_conversions
คำอธิบายช่อง จํานวน Conversion ของบัญชีลูกค้า โดยจะรวมเฉพาะการกระทําที่ถือเป็น Conversion ที่มีแอตทริบิวต์_in_client_account_conversions_metric ที่ตั้งค่าเป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.client_account_conversions_value
คำอธิบายช่อง มูลค่า Conversion ของบัญชีลูกค้า รวมเฉพาะการกระทําที่ถือเป็น Conversion ซึ่งมีการกําหนดแอตทริบิวต์ include_in_client_account_conversions_metric เป็น "จริง" หากคุณใช้การเสนอราคาตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.client_account_view_through_conversions
คำอธิบายช่อง จํานวน Conversion การดูผ่านทั้งหมด ประเภทนี้เกิดขึ้นเมื่อลูกค้าเห็นโฆษณาแบบรูปภาพหรือริชมีเดีย จากนั้นจึงเกิด Conversion เสร็จสมบูรณ์บนเว็บไซต์ในภายหลังโดยไม่ได้โต้ตอบกับ (เช่น คลิก) โฆษณาอื่น
หมวดหมู่ METRIC
ประเภทข้อมูล INT64
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.cross_device_conversions
คำอธิบายช่อง Conversion ที่เกิดขึ้นเมื่อลูกค้าคลิกโฆษณาในอุปกรณ์หนึ่ง แล้วทํา Conversion ในอุปกรณ์หรือเบราว์เซอร์อื่น Conversion จากหลายอุปกรณ์รวมอยู่ใน all_conversions อยู่แล้ว
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.cross_device_conversions_by_conversion_date
คำอธิบายช่อง จํานวน Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.cross_device_conversions_value
คำอธิบายช่อง ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.cross_device_conversions_value_by_conversion_date
คำอธิบายช่อง ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.ctr
คำอธิบายช่อง จำนวนคลิกที่โฆษณาของคุณได้รับ (จำนวนคลิก) หารด้วยจำนวนครั้งที่โฆษณาแสดง (การแสดงผล)
หมวดหมู่ METRIC
ประเภทข้อมูล DOUBLE
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
metrics.impressions
คำอธิบายช่อง จํานวนความถี่ที่โฆษณาปรากฏในหน้าผลการค้นหาหรือเว็บไซต์ในเครือข่ายของ Google
หมวดหมู่ METRIC
ประเภทข้อมูล INT64
พิมพ์ URL N/A
กรองได้ จริง
เลือกได้ จริง
จัดเรียงได้ จริง
ซ้ำ เท็จ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eThe Ad Group Audience View provides performance data for Display, YouTube, and RLSA campaigns, focusing on audience insights from interests and remarketing lists.\u003c/p\u003e\n"],["\u003cp\u003eData is segmented by \u003ccode\u003ebidding_strategy\u003c/code\u003e and \u003ccode\u003euser_list\u003c/code\u003e, allowing for deeper performance analysis.\u003c/p\u003e\n"],["\u003cp\u003eAvailable metrics include conversions, cost, click-through rate (CTR), impressions, and more, with options for segmentation by device, date, and conversion action.\u003c/p\u003e\n"],["\u003cp\u003eMetrics can be filtered, sorted, and segmented for customized reporting and analysis.\u003c/p\u003e\n"],["\u003cp\u003eMonetary metrics are typically in the customer's currency but can be adjusted using the \u003ccode\u003emetrics_currency\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],["The Ad Group Audience View aggregates performance data for ad audiences across Display, YouTube, and search. Key actions include filtering and selecting data using resource names, segments, and metrics. Metrics, such as `clicks`, `impressions`, and `conversions`, can be segmented by `date`, `device`, `ad_network_type` or other attributes. The view uses attributed resources (`ad_group`, `campaign`), and segmenting resources (`bidding_strategy`, `user_list`). Data includes conversion counts and values, click-through rate, and costs. It will show compatible fields when being queried.\n"],null,[]]