Google Ads Query Builder เป็นเครื่องมือแบบอินเทอร์แอกทีฟที่ออกแบบมาเพื่อช่วยคุณสร้างและตรวจสอบคำค้นหาโดยใช้ Google Ads Query Language (GAQL) ไม่ว่าคุณจะเป็นผู้ใช้ GAQL มือใหม่หรือผู้ใช้ที่มีประสบการณ์ Query Builder จะช่วยลดความซับซ้อนของกระบวนการดึงข้อมูลที่ต้องการจาก Google Ads API ได้
ข้อดี
- ใช้งานง่าย: ลดความซับซ้อนของกระบวนการเขียนคําค้นหา GAQL โดยไม่จําเป็นต้องคุ้นเคยกับไวยากรณ์ที่เฉพาะเจาะจงและฟิลด์ที่ใช้ได้
- การค้นพบได้: ช่วยสำรวจและค้นหาแหล่งข้อมูล ฟิลด์ กลุ่ม และเมตริกที่พร้อมใช้งานภายในโมเดลข้อมูล Google Ads API
- ลดข้อผิดพลาด: การมีอินเทอร์เฟซที่มีโครงสร้างและเมนูแบบเลื่อนลงของตัวเลือกที่ถูกต้องจะช่วยป้องกันข้อผิดพลาดทางไวยากรณ์และการพิมพ์ผิด เพื่อให้มั่นใจว่าคำค้นหาที่สร้างขึ้นนั้นถูกต้อง
- สร้างการค้นหาได้เร็วขึ้น: เร่งกระบวนการพัฒนาโดยสร้างสตริงการค้นหาโดยอัตโนมัติ
- การตรวจสอบ: เครื่องมือนี้ลิงก์กับโปรแกรมสำรวจ API และเครื่องมือตรวจสอบคำค้นหาเพื่อตรวจสอบคำค้นหากับกฎ API ก่อนดำเนินการ
วิธีการทำงาน
Google Ads Query Builder มีอินเทอร์เฟซที่ใช้ง่ายเพื่อประกอบคำค้นหา GAQL แบบภาพ เวิร์กโฟลว์พื้นฐานมีดังนี้
- เลือกทรัพยากร: เริ่มต้นด้วยการเลือกทรัพยากรหลักจากแท็บข้อมูลอ้างอิงสำหรับเวอร์ชันที่ต้องการค้นหา ทรัพยากรนี้อยู่ในส่วนคำสั่ง
FROMทรัพยากรแสดงถึงเอนทิตีภายใน Google Ads เช่นcampaign,ad_groupหรือkeyword_viewเครื่องมือสร้างจะแสดงแหล่งข้อมูลทั้งหมดที่ใช้ได้ - เลือกช่อง: เมื่อเลือกทรัพยากรแล้ว เครื่องมือจะแสดงช่องที่เลือกได้ทั้งหมด ซึ่งรวมถึงแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้องกับทรัพยากรนั้นและทรัพยากรที่ระบุแหล่งที่มา (รวมกันโดยนัย) คุณสามารถเลือกช่องทำเครื่องหมายเพื่อรวมฟิลด์ไว้ในส่วนคำสั่ง
SELECTได้ ขณะที่คุณเลือก เครื่องมือจะสร้างสตริงการค้นหา GAQL ที่เกี่ยวข้องแบบไดนามิก แสดงข้อผิดพลาด และกรองชุดค่าผสมของช่องที่ไม่เข้ากันออก - ใช้ตัวกรอง: เพิ่มเงื่อนไขส่วนคำสั่ง
WHEREเพื่อกรองผลลัพธ์ เครื่องมือสร้างจะช่วยคุณเลือกฟิลด์ โอเปอเรเตอร์ และค่าต่างๆ เพื่อให้มั่นใจว่าไวยากรณ์ถูกต้อง - จัดเรียงผลลัพธ์: ระบุลำดับการจัดเรียงโดยใช้ส่วนคำสั่ง
ORDER BY - กำหนดขีดจำกัด: เพิ่มส่วนคำสั่ง
LIMITเพื่อควบคุมจำนวนผลลัพธ์ที่แสดง - ตรวจสอบ: เครื่องมือจะแนะนำชุดค่าผสมของช่องที่ถูกต้องโดยอัตโนมัติ และยังลิงก์ไปยังโปรแกรมสำรวจ API เพื่อให้คุณทดสอบการค้นหากับข้อมูลบัญชีได้ นอกจากนี้ยังมีเครื่องมือตรวจสอบการค้นหาแยกต่างหาก ซึ่งคุณสามารถวางและตรวจสอบการค้นหา GAQL ที่เขียนด้วยตนเองได้
- ส่งออก: เมื่อพอใจกับคำค้นหาแล้ว ให้คัดลอกและวางสตริง GAQL ที่ทดสอบแล้วและถูกต้องตามไวยากรณ์ลงในคำขอของไคลเอ็นต์
GoogleAdsService.SearchหรือSearchStream
เครื่องมือสร้างจะตรวจสอบว่าช่อง กลุ่ม และเมตริกที่เลือกเข้ากันได้และใช้ร่วมกันได้ในการค้นหาเดียว โดยอ้างอิงข้อมูลเมตาที่เกี่ยวข้องของ Google Ads API
เริ่มต้นใช้งาน
การไปยัง Query Builder ทำได้ 2 วิธี ได้แก่ ไปที่หน้าใดหน้าหนึ่งในเอกสารอ้างอิงการรายงาน หรือสำรวจจากหน้าภาพรวมของ Query Builder
จากเอกสารอ้างอิงการรายงาน
- เริ่มต้นด้วยเอกสารอ้างอิงการรายงาน แล้วเลือกทรัพยากรที่ต้องการเริ่มต้นในรายการทรัพยากรทั้งหมด หรือจะไปยังแหล่งข้อมูลโดยตรงจากแผงการนำทางด้านซ้ายก็ได้
- คลิกช่วยฉันสร้างคำค้นหา ซึ่งจะนำคุณไปยัง Query Builder สำหรับแหล่งข้อมูลนั้นๆ
จากหน้าภาพรวมของ Query Builder
ไปที่ส่วน Query Builder ของเอกสารอ้างอิงการรายงาน แล้วเลือกแหล่งข้อมูลที่ต้องการสำรวจ
การผสานรวมกับเครื่องมืออื่นๆ
Query Builder ผสานรวมกับเครื่องมืออื่นๆ ในชุดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Google Ads API คุณสามารถนำคำค้นหาที่สร้างใน Query Builder ไปทดสอบในโปรแกรมสำรวจ API หรือตรวจสอบด้วยเครื่องมือตรวจสอบคำค้นหาได้
โปรแกรมสำรวจ API
เมื่อสร้างการค้นหาแล้ว ให้คลิกลองใช้ในโปรแกรมสำรวจ API เพื่อเปิดการค้นหาในโปรแกรมสำรวจ API ระบบจะป้อนคำค้นหาของคุณในเนื้อหาคำขอโดยอัตโนมัติ จากนั้นคุณจะทดสอบคำค้นหาได้โดยเรียกใช้กับข้อมูลบัญชี ดูข้อมูลเพิ่มเติมเกี่ยวกับเครื่องมือดังกล่าวได้ที่โปรแกรมสำรวจ API
Query Validator
เมื่อคลิกป้อนหรือแก้ไขการค้นหา เครื่องมือตรวจสอบการค้นหาจะเปิดขึ้น ใช้เครื่องมือตรวจสอบการค้นหาเพื่อตรวจสอบไวยากรณ์ของการค้นหา คำค้นหาที่สร้างขึ้นทั้งหมดผ่าน Query Builder มีไวยากรณ์ที่ถูกต้องอยู่แล้ว แต่หากคุณคุ้นเคยกับทรัพยากรที่กำลังค้นหา เครื่องมือตรวจสอบคำค้นหาจะช่วยให้คุณป้อนคำค้นหาและตรวจสอบความถูกต้องได้อย่างรวดเร็ว ดูข้อมูลเพิ่มเติมเกี่ยวกับเครื่องมือดังกล่าวได้ที่เครื่องมือตรวจสอบการค้นหา