คู่มือนี้จะเชื่อมโยงแนวคิดและแบบแผนการตั้งชื่อรายงานใน 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"