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'