ใน 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_criterionad_groupcampaigncustomer
หากต้องการดูทรัพยากรที่ขอได้ด้วยวิธีนี้สำหรับทรัพยากรหนึ่งๆ ให้ดูแถวทรัพยากรแอตทริบิวต์ในหน้าอ้างอิงของทรัพยากรนั้น เช่น สำหรับ keyword_view คุณจะดูทรัพยากรได้ในหน้าอ้างอิง
การแมปกับ UI
รายงานเกณฑ์แต่ละรายการสอดคล้องกับมุมมองที่เฉพาะเจาะจงใน UI ของ Google Ads การแมป ข้อมูลเหล่านี้จะช่วยให้คุณกระทบยอดข้อมูล API กับสิ่งที่คุณเห็นในอินเทอร์เฟซได้ ดูรายการการแมปที่ ใหญ่ขึ้นได้ที่รายงานใน UI
ต่อไปนี้คือรายงานที่อิงตามเกณฑ์ทั่วไปบางส่วนและตำแหน่ง UI โดยทั่วไป
- แคมเปญ > กลุ่มเป้าหมาย คีย์เวิร์ด และเนื้อหา > คีย์เวิร์ดสำหรับโฆษณา Search: แสดง
ข้อมูลที่เทียบเท่ากับ
keyword_view - แคมเปญ > กลุ่มเป้าหมาย คีย์เวิร์ด และเนื้อหา > กลุ่มเป้าหมาย > ข้อมูลประชากร:
แสดงข้อมูลที่เทียบเท่ากับ
age_range_viewและgender_view - แคมเปญ > สถานที่: แสดงข้อมูลที่เทียบเท่ากับ
location_view