เมตริกเกณฑ์

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

ไคลเอ็นต์ Google Ads API ต้องระบุฟิลด์ ad_group_criterion หรือ 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