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