รายงานใน UI

คู่มือนี้จะเชื่อมโยงแนวคิดและรูปแบบการตั้งชื่อรายงานใน UI ของ Google Ads กับรายงานที่คุณสร้างได้โดยใช้ภาษาการค้นหาของ Google Ads (GAQL) และ Google Ads API

คําศัพท์ทั่วไปเกี่ยวกับ UI

ตารางต่อไปนี้สรุปคําศัพท์ทั่วไปที่ใช้ใน UI และการแมปกับภาษาคําค้นหาของ Google Ads (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

การแบ่งกลุ่ม

หากต้องการสถิติโดยละเอียดมากขึ้น คุณสามารถแยกข้อมูลตามกลุ่มได้ เช่น คุณอาจสนใจดูจํานวนการแสดงผลเฉพาะในเครือข่าย Search ของ 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

ต่อไปนี้คือรายการรายงานพื้นฐานที่กําหนดไว้ล่วงหน้าและ Resource Name ของ GAQL ที่ตรงกัน

รายงานที่กําหนดไว้ล่วงหน้าพื้นฐาน	ชื่อทรัพยากร GAQL (ระบุในคำสั่ง FROM)
บัญชี	customer
แคมเปญ รายละเอียดแคมเปญ	campaign
กลุ่มโฆษณา รายละเอียดกลุ่มโฆษณา	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"