הכלי לאימות שאילתות ב-Google Ads הוא כלי אינטראקטיבי שמיועד לעזור למפתחים ליצור ולאמת שאילתות בשפת השאילתות של Google Ads (GAQL) לפני שהם משלבים אותן באפליקציות. הוא מאפשר להזין מחרוזת שאילתה ב-GAQL ולקבל משוב מיידי על התקינות שלה, וכך לזהות שגיאות תחביר, חוסר תאימות של שדות ובעיות אחרות בשלב מוקדם של תהליך הפיתוח.
יתרונות
- מניעת שגיאות: זיהוי שאילתות לא תקינות בשלב מוקדם, לפני שהן משולבות באפליקציות, כדי לצמצם את שגיאות זמן הריצה והכשלים בקריאות ל-API.
- פיתוח מהיר יותר: מאפשר בדיקה וניפוי באגים מהירים של הצהרות GAQL בלי העומס של מחזורי בקשות API ותגובות מלאים של ה-API.
- הבנת המגבלות של GAQL: עוזרת למפתחים ללמוד את הכללים המורכבים לגבי השדות התואמים והקשר בין המשאבים.
- ניפוי באגים בשאילתות: הצגת הודעות שגיאה ספציפיות כששאילתה לא תקינה, לרוב מפורטות יותר משגיאת API כללית, ולפעמים גם הצעות לחלופות תקינות.
- ניצול יעיל של משאבים: מונע קריאות מיותרות ל-API עם שאילתות שנועדו להיכשל.
איך זה עובד
הכלי לתיקוף שאילתות מנתח את שאילתת ה-GAQL בהתאם לסכימה של Google Ads API ולכללים שמוגדרים בשפת השאילתות של Google Ads. הוא משתמש במטא-נתונים, שרובם נגישים מ-GoogleAdsFieldService, כדי לבצע בדיקות, כולל:
- תחביר ומבנה: מוודא שהשאילתה תואמת לדקדוק הנכון של GAQL, כולל שימוש נכון וסדר נכון של משפטים כמו
SELECT,FROM,WHERE,ORDER BY,LIMITו-PARAMETERS. - תקינות השדות: בדיקה אם כל השדות שצוינו (משאבים, פלחים, מדדים) קיימים ומאוישים נכון.
- תאימות משאבים: בדיקה שהשדות שנבחרו בסעיף
SELECTתואמים למשאב הראשי שצוין בסעיףFROM. - תאימות בין פלחים למדדים: מוודאת שהפלחים והמדדים שמשתמשים בהם יחד באותה שאילתה תואמים זה לזה ולמשאב בסעיף
FROM. - דרישות לגבי סעיפים: אימות של כללים כמו הדרישה ששדות שמשתמשים בהם בסעיפי
ORDER BYושדות מסוימים שמשתמשים בהם בסעיפיWHERE(כמו פלחים) יופיעו גם בסעיףSELECT. - שימוש באופרטורים: בדיקה של שימוש נכון באופרטורים בתנאי הסעיף
WHERE.
אם השאילתה תקינה, הכלי מאשר זאת. אם נמצאו בעיות, הוא מספק הודעות שגיאה שנועדו לעזור לכם לאתר את הבעיה, ולפעמים מציע הצעות לתיקונים, כמו משאבים תואמים למדד נתון.
שנתחיל?
כדי להשתמש בכלי לתיקוף שאילתות ב-Google Ads:
- עוברים אל הכלי לתיקוף שאילתות.
- מזינים את שאילתת ה-GAQL.
- לוחצים על הכפתור Validate Query.
- בודקים את הודעת האימות שמופיעה מתחת לווידג'ט של הכלי לתיקוף שאילתות. אם השאילתה תקינה, תופיע הודעה על כך. אחרת, תוצג הודעת שגיאה שמתארת את הבעיה. הודעות השגיאה ינחו אתכם איך לתקן את השאילתה. לדוגמה, אם יש שגיאה של חוסר תאימות בין שדות, יכול להיות שיופיעו משאבים חלופיים שכן תואמים למדד או לפלח שאתם מנסים לשלוח לגביהם שאילתה.
הסברים מעמיקים יותר על המושגים והתחביר של GAQL זמינים במדריך של שפת השאילתות של Google Ads. כדי ליצור ולבדוק שאילתות GAQL באופן אינטראקטיבי, אפשר גם להשתמש בכלי ליצירת שאילתות וב-API Explorer.