เมตริกเกณฑ์

ใน 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