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