คู่มือนี้จะเชื่อมโยงแนวคิดและแบบแผนการตั้งชื่อสำหรับรายงานใน UI ของ Google Ads กับรายงานที่คุณสร้างได้โดยใช้ภาษาการค้นหาของ Google Ads (GAQL) และ Google Ads API
คำศัพท์ UI ทั่วไป
ตารางต่อไปนี้สรุปคำศัพท์ทั่วไปบางคำที่ใช้ใน UI และการแมปกับ Google Ads Query Language (GAQL)
| UI | GAQL |
|---|---|
| คอลัมน์ | แหล่งข้อมูล ฟิลด์กลุ่ม หรือเมตริกใดๆ ในอนุประโยค SELECT ของการค้นหา GAQL |
| ช่วงวันที่ | ช่วงวันที่จะแมปกับคําสั่ง WHERE ที่กรองตาม segments.date |
| ตัวกรอง | เงื่อนไขอย่างน้อย 1 รายการในอนุประโยค WHERE |
| ฟิลด์กลุ่ม | ใช้การแบ่งกลุ่มโดยรวมฟิลด์กลุ่ม ไว้ในคําค้นหา GAQL |
| การใส่เลขหน้า | การแบ่งหน้าจะแบ่งชุดผลลัพธ์ของ การค้นหาออกเป็นหลายหน้า |
คอลัมน์
คอลัมน์ใน UI เทียบเท่ากับ ฟิลด์ทรัพยากร ฟิลด์กลุ่ม และ เมตริกใน GAQL
การกรอง
คุณสามารถกรองและจัดระเบียบข้อมูลในรายงานได้
ช่วงวันที่
UI ของ Google Ads มีตารางที่แสดงสถิติบัญชี และเมนูแบบเลื่อนลงเพื่อ ควบคุมช่วงวันที่ของสถิติเหล่านี้
คุณมีสิทธิ์ควบคุมเดียวกันใน GAQL โดยการกรองใน
segments.date ในส่วน WHERE ของการค้นหา GAQL
ตัวกรอง
ตัวกรองใน UI เทียบเท่ากับเงื่อนไขอย่างน้อย 1 รายการในคําสั่ง WHERE ของ GAQL
การแบ่งกลุ่ม
หากต้องการดูสถิติโดยละเอียด ให้แยกข้อมูลตามกลุ่ม เช่น สมมติว่าคุณต้องการดูจำนวนการแสดงผลที่เฉพาะเจาะจงกับเครือข่ายการค้นหาของ Google แยกจากเครือข่าย Display ของ Google ในกรณีนี้ ให้แบ่งกลุ่มรายงานตาม เครือข่าย ดูการแบ่งกลุ่มเกี่ยวกับวิธีรวม ฟิลด์กลุ่มในอนุประโยค SELECT
การใส่เลขหน้า
ดูรายงานใน UI โดยใช้ตัวควบคุมที่ด้านล่างของตารางข้อมูลแต่ละตาราง ซึ่งช่วยให้คุณเปลี่ยนหน้าและเลือกจำนวนผลลัพธ์ที่จะแสดงจากชุดขนาดที่กำหนดได้
การแบ่งหน้าผ่านผลลัพธ์จะพร้อมใช้งานเมื่อดึงข้อมูลรายงานด้วย
GoogleAdsService.Search ผ่าน
next_page_token หากต้องการดึงข้อมูลชุดผลลัพธ์ทั้งหมด
โดยไม่มีการแบ่งหน้า ให้ใช้
GoogleAdsService.SearchStream
จัดเรียงผลการค้นหา
ใน UI คุณสามารถจัดเรียงผลลัพธ์ได้โดยเลือกคอลัมน์
ใน GAQL คุณสามารถใช้ คําสั่ง ORDER BY และ คําสั่ง LIMIT เพื่อจัดลําดับผลการค้นหา
รูปแบบการดาวน์โหลด
ใน UI คุณสามารถดาวน์โหลดรายงานได้หลายรูปแบบ เช่น CSV, TSV หรือ XML
API ไม่รองรับรูปแบบต่างๆ ในเอาต์พุตโดยตรง คุณจึงต้อง ทำการประมวลผลภายหลัง ดูตัวอย่างโค้ดนี้ที่แสดงวิธี การใช้การจัดรูปแบบ CSV ในไคลเอ็นต์
ตั้งเวลาและส่งรายงานทางอีเมล
คุณสามารถตั้งเวลารายงานและส่งทางอีเมลจาก UI ได้ แต่ระบบไม่รองรับฟีเจอร์เหล่านี้ใน API
รายงานที่กำหนดล่วงหน้า
คุณสร้างรายการรายงานที่กําหนดไว้ล่วงหน้าใน UI ของ Google Ads ได้
ต่อไปนี้คือรายการรายงานพื้นฐานที่กำหนดไว้ล่วงหน้าและชื่อทรัพยากร GAQL ที่ตรงกัน
| รายงานที่กำหนดไว้ล่วงหน้าขั้นพื้นฐาน | ชื่อทรัพยากร GAQL (ระบุในFROM clause) |
|---|---|
| บัญชี | ลูกค้า |
| แคมเปญ รายละเอียดแคมเปญ |
แคมเปญ |
| กลุ่มโฆษณา รายละเอียดกลุ่มโฆษณา |
ad_group |
|
โฆษณา URL สุดท้าย |
ad_group_ad |
| คีย์เวิร์ดสำหรับโฆษณา Search | keyword_view |
| ข้อความค้นหา | search_term_view |
| เสียค่าใช้จ่ายและเกิดขึ้นเอง | paid_organic_search_term_view |
| หน้า Landing Page | landing_page_view |
| หน้า Landing Page แบบขยาย | expanded_landing_page_view |
ตัวอย่างจากตารางก่อนหน้า คุณสามารถใช้ GAQL ต่อไปนี้เพื่อ สร้างรายงานบัญชี
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
ความแตกต่างที่พบได้ทั่วไป
เมื่อเปรียบเทียบรายงาน UI กับรายงาน API ความแตกต่างที่พบบ่อยที่สุดอย่างหนึ่งคือ UI จะกรองเอนทิตีที่นำออกโดยปริยาย ในขณะที่ API ไม่ได้กรอง
หากต้องการจำลองมุมมอง UI เริ่มต้น คุณต้องเพิ่มตัวกรอง โดยปกติจะใช้ฟิลด์ status เพื่อยกเว้นแถวที่นำออก เช่น
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"