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
clause ที่กรองใน segments.date |
| ตัวกรอง | เงื่อนไขอย่างน้อย 1 รายการในอนุประโยค WHERE |
| ฟิลด์กลุ่ม | ใช้การแบ่งกลุ่มโดยรวมฟิลด์กลุ่ม ไว้ในคําค้นหา GAQL |
| การใส่เลขหน้า | การแบ่งหน้าจะแบ่งชุดผลลัพธ์ของ การค้นหาออกเป็นหลายหน้า |
คอลัมน์
คอลัมน์ใน UI เทียบเท่ากับการใช้กลไก SELECT สำหรับ ฟิลด์ทรัพยากร ฟิลด์กลุ่ม หรือ เมตริกใน 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 ของแผนที่ไปยังทรัพยากร 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 ต่อไปนี้เพื่อ สร้างรายงานบัญชี
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'