คู่มือนี้จะจับคู่แนวคิดและแบบแผนการตั้งชื่อสำหรับรายงานใน 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
การแบ่งกลุ่ม
หากต้องการดูสถิติโดยละเอียดมากขึ้น ให้แยกข้อมูลตามกลุ่ม เช่น สมมติว่าคุณต้องการดูจำนวนการแสดงผลที่เฉพาะเจาะจงสำหรับเครือข่าย Search ของ Google แยกจากเครือข่าย Display ของ 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) |
|---|---|
| บัญชี | 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 |
ตัวอย่างจากตารางก่อนหน้า คุณสามารถใช้ 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"