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