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

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

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

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

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

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

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

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

คอลัมน์

คอลัมน์ใน UI เทียบเท่ากับการใช้คําสั่ง SELECT สําหรับ ฟิลด์ทรัพยากร ฟิลด์กลุ่ม หรือ เมตริกใน GAQL

ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับคอลัมน์ในตารางสถิติ

ช่วงวันที่

UI ของ Google Ads มีตารางที่แสดงสถิติบัญชี และเมนูแบบเลื่อนลงเพื่อ ควบคุมช่วงวันที่ของสถิติเหล่านี้

คุณมีสิทธิ์ควบคุมเดียวกันใน GAQL โดยการกรองใน segments.date ในคําสั่ง WHERE ของคําค้นหา GAQL

ตัวกรอง

ตัวกรองใน UI เทียบเท่ากับเงื่อนไขอย่างน้อย 1 รายการในWHERE clause ของ 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 clause)
บัญชี ลูกค้า
แคมเปญ
รายละเอียดแคมเปญ
แคมเปญ
กลุ่มโฆษณา
รายละเอียดกลุ่มโฆษณา
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'