รายงานใน UI ของ Google Ads

UI ของ Google Ads มีความสามารถในการรายงาน หากต้องการสร้างรายงาน ให้ลงชื่อเข้าใช้บัญชี Google Ads แล้วคลิกแคมเปญ ในเมนูการนำทางด้านซ้าย จากนั้นคลิกข้อมูลเชิงลึกและรายงาน หากต้องการสร้างรายงานตั้งแต่ต้น ให้คลิกเครื่องมือแก้ไขรายงาน

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

เครื่องมือและแหล่งข้อมูล

ดูตัวอย่างโดยละเอียดเพิ่มเติมและความช่วยเหลืออัตโนมัติในการจับคู่หน้าจอ UI กับ API ได้จากแหล่งข้อมูลต่อไปนี้

• Query Cookbook: ชุดคําค้นหา GAQL ที่จำลองข้อมูลที่พบในหน้าจอ UI ของ Google Ads ทั่วไปหลายหน้าจอ
• ส่วนขยายการรายงานของ Google Ads API: ส่วนขยาย Chrome ที่ช่วยคุณระบุชื่อทรัพยากรและชื่อฟิลด์ API ได้โดยตรงภายใน UI ของ Google Ads

คำศัพท์ทั่วไปใน UI

ตารางต่อไปนี้สรุปคำศัพท์ทั่วไปบางคำที่ใช้ใน UI และ การจับคู่กับ Google Ads Query Language (GAQL)

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

คอลัมน์

คอลัมน์ใน UI เทียบเท่ากับการใช้ SELECT clause สําหรับ ฟิลด์ทรัพยากร, ฟิลด์กลุ่ม, หรือ เมตริก ใน 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 clause และ LIMIT clause เพื่อจัดเรียงและจํากัดผลลัพธ์ของคําค้นหา

รูปแบบการดาวน์โหลด

ใน UI คุณสามารถดาวน์โหลดรายงานได้หลายรูปแบบ เช่น CSV, TSV หรือ XML

API จะไม่จัดรูปแบบเอาต์พุตเป็นไฟล์ เช่น CSV โดยตรง ดังนั้นแอปพลิเคชันไคลเอ็นต์ของคุณจึงต้องจัดรูปแบบการตอบสนอง ดูตัวอย่างโค้ดรายงานแคมเปญเป็น CSVเพื่อดูวิธีใช้การจัดรูปแบบ CSV ในไคลเอ็นต์

ตั้งเวลาและส่งรายงานทางอีเมล

คุณสามารถตั้งเวลาและส่งรายงานทางอีเมลจาก UI ได้ แต่ API ไม่รองรับฟีเจอร์เหล่านี้

จับคู่มุมมอง UI กับทรัพยากร API

ต่อไปนี้คือรายการมุมมอง UI ทั่วไปและชื่อทรัพยากร GAQL ที่ตรงกัน

มุมมอง UI	ชื่อทรัพยากร 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
เนื้อหา > ตำแหน่ง	managed_placement_view
เนื้อหา > ตำแหน่งที่แสดงโฆษณา	group_placement_view
เนื้อหา > ตำแหน่งที่แสดงโฆษณา > ดูรายละเอียด	detail_placement_view
กลุ่มเป้าหมาย > ข้อมูลประชากร > อายุ	age_range_view
กลุ่มเป้าหมาย > ข้อมูลประชากร > เพศ	gender_view
สถานที่ตั้ง	location_view
เนื้อหา > หัวข้อ	topic_view
สถานที่ตั้ง > รายงานทางภูมิศาสตร์	geographic_view

^* หากต้องการสร้างรายงานการค้นหาทั่วไปและแบบเสียค่าใช้จ่าย คุณต้องลิงก์บัญชี Google Search Console กับบัญชี Google Ads ที่ระดับลูกค้า

ตัวอย่างจากตารางก่อนหน้า คุณสามารถใช้คําค้นหา GAQL ต่อไปนี้เพื่อสร้างรายงานบัญชีแบบรวมในช่วง 7 วันที่ผ่านมา (เพิ่ม segments.date ลงในอนุประโยค SELECT หากต้องการแบ่งเมตริกตามวัน)

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 เพื่อยกเว้นแถวที่นําออก (หรือใส่เอนทิตี ENABLED และ PAUSED อย่างชัดเจน) ตัวอย่าง

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'