UI ของ Google Ads มีความสามารถในการรายงาน หากต้องการสร้างรายงาน ให้ลงชื่อเข้าใช้ บัญชี Google Ads คลิกแคมเปญในเมนูการนำทางด้านซ้าย แล้วคลิกข้อมูลเชิงลึกและรายงาน หากต้องการสร้างรายงานตั้งแต่ต้น ให้คลิกเครื่องมือแก้ไข รายงาน
คู่มือนี้จะเชื่อมโยงแนวคิดการรายงานและแบบแผนการตั้งชื่อทั่วไปใน UI ของ Google Ads กับรายงานที่คุณสร้างได้โดยใช้ภาษาการค้นหาของ Google Ads (GAQL) และ Google Ads API นอกจากนี้ คุณยังทำตามข้อความแจ้งใน UI เพื่อสร้างรายงานที่ ตรงกับข้อกำหนดของคุณมากที่สุดได้ด้วย
เครื่องมือและแหล่งข้อมูล
ดูตัวอย่างโดยละเอียดและความช่วยเหลืออัตโนมัติในการแมปหน้าจอ UI กับ API ได้จากแหล่งข้อมูลต่อไปนี้
- สูตรการแก้ปัญหาการค้นหา: ชุดการค้นหา GAQL ที่จำลองข้อมูลที่พบในหน้าจอ UI ของ Google Ads ทั่วไปหลายหน้าจอ
- ส่วนขยายการรายงานของ Google Ads API: ส่วนขยาย Chrome ที่ช่วยให้คุณระบุชื่อทรัพยากรและชื่อฟิลด์ API ได้โดยตรงภายใน UI ของ Google Ads
คำศัพท์ 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'