เมตริกเกณฑ์

ใน Google Ads API รายงานเกณฑ์แต่ละรายการจะแสดงด้วยแหล่งข้อมูลแยกต่างหาก ทรัพยากร *_view จะมีเฉพาะช่อง resource_name เว้นแต่จะจำเป็นต้องมีช่องอื่น

ไคลเอ็นต์ Google Ads API ต้องระบุช่อง ad_group_criterion หรือ campaign_criterion ที่เกี่ยวข้องหากจำเป็นต้องดึงข้อมูลเฉพาะเกณฑ์ แต่ละมุมมองจะรวมเข้ากับแหล่งข้อมูลเกณฑ์ที่ตรงกับระดับการกำหนดเป้าหมาย (เช่น keyword_view รวมเข้ากับ ad_group_criterion ขณะที่ location_view รวมเข้ากับ campaign_criterion) ซึ่งช่วยให้ไคลเอ็นต์ Google Ads API ขอช่อง ad_group_criterion หรือ campaign_criterion และแหล่งข้อมูล *_view ในคำขอเดียวกันไปยังเมธอด GoogleAdsService.SearchStream ได้

ตัวอย่างคำขอการค้นหา

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

หากต้องการดึงข้อมูลประสิทธิภาพ (เมตริก) สำหรับประเภทเกณฑ์ที่เฉพาะเจาะจง ให้ระบุทรัพยากรข้อมูลพร็อพเพอร์ตี้ที่เกี่ยวข้องในส่วนคำสั่ง FROM เช่น ใช้ keyword_view ในส่วนคำสั่ง FROM และฟิลด์ metrics ในส่วนคำสั่ง SELECT เพื่อดึงข้อมูลเมตริกคีย์เวิร์ด

คุณสามารถเลือกช่องจากแหล่งข้อมูลหลักไปจนถึง customer จากมุมมองเกณฑ์ เช่น เมื่อเลือก FROM keyword_view คุณจะขอฟิลด์จากแหล่งข้อมูลต่อไปนี้ทั้งหมดได้

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

หากต้องการค้นหาทรัพยากรที่สามารถขอได้ด้วยวิธีนี้สำหรับทรัพยากรหนึ่งๆ ให้ดูแถวทรัพยากรที่ระบุแหล่งที่มาในหน้าข้อมูลอ้างอิง เช่น คุณสามารถดูแหล่งข้อมูลของ keyword_view ได้ในหน้าข้อมูลอ้างอิง

การแมปกับ UI

รายงานเกณฑ์แต่ละรายการจะสอดคล้องกับมุมมองที่เฉพาะเจาะจงใน UI ของ Google Ads การแมปข้อมูลเหล่านี้จะช่วยให้คุณตรวจสอบความสอดคล้องกันระหว่างข้อมูล API กับข้อมูลที่เห็นในอินเทอร์เฟซได้ ดูรายการการจับคู่ที่ใหญ่ขึ้นได้ที่รายงานใน UI

ต่อไปนี้คือรายงานตามเกณฑ์ที่พบบ่อยและตำแหน่ง UI ทั่วไป

  • แคมเปญ > กลุ่มเป้าหมาย คีย์เวิร์ด และเนื้อหา > คีย์เวิร์ดสำหรับโฆษณา Search: แสดงผลข้อมูลที่เทียบเท่ากับ keyword_view
  • แคมเปญ > กลุ่มเป้าหมาย คีย์เวิร์ด และเนื้อหา > กลุ่มเป้าหมาย > ข้อมูลประชากร: แสดงผลข้อมูลที่เทียบเท่ากับ age_range_view และ gender_view
  • แคมเปญ > สถานที่ตั้ง: แสดงผลข้อมูลที่เทียบเท่ากับ location_view