รายงานใน UI

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

คำศัพท์ทั่วไปของ UI

ตารางต่อไปนี้สรุปคำศัพท์ทั่วไปจำนวนหนึ่งที่ใช้ใน UI และ การแมปกับภาษาของคำค้นหาของ Google Ads (GAQL)

UI	GAQL
คอลัมน์	ทรัพยากร ช่องของกลุ่ม หรือเมตริกในอนุประโยค SELECT ของคำค้นหา GAQL
ช่วงวันที่	ช่วงวันที่แมปกับ WHERE วรรคที่กรองบน segments.date
ตัวกรอง	เงื่อนไขอย่างน้อย 1 รายการในคำสั่ง WHERE
ช่องกลุ่ม	ใช้การแบ่งกลุ่มโดยการรวมช่องกลุ่ม ในคำค้นหา GAQL
การใส่เลขหน้า	การแบ่งหน้าเป็นการแบ่งชุดผลลัพธ์ของ การค้นหาในหลายหน้า

คอลัมน์

คอลัมน์ใน UI เทียบเท่ากับ Resource ฟิลด์ กลุ่ม ฟิลด์ และ เมตริกใน 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"