รายงานใน 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

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

หากต้องการสถิติโดยละเอียด คุณสามารถแบ่งข้อมูลตามกลุ่มได้ ตัวอย่างเช่น คุณอาจสนใจดูจำนวนการแสดงผลที่มีเฉพาะในเครือข่ายการค้นหาของ Google แยกจากเครือข่ายดิสเพลย์ของ 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)
บัญชี	ลูกค้า
แคมเปญ รายละเอียดแคมเปญ	แคมเปญ
กลุ่มโฆษณา รายละเอียดกลุ่มโฆษณา	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"