כלי לאימות שאילתות ב-Google Ads

כלי האימות של שאילתות ב-Google Ads הוא כלי אינטראקטיבי שנועד לעזור למפתחים ליצור ולאמת שאילתות בשפת השאילתות של Google Ads ‏ (GAQL) לפני שהם משלבים אותן באפליקציות. הכלי מאפשר להזין מחרוזת של שאילתת GAQL ולקבל משוב מיידי לגבי התוקף שלה, וכך לזהות שגיאות תחביר, חוסר תאימות של שדות ובעיות אחרות בשלב מוקדם בתהליך הפיתוח.

יתרונות

  • מניעת שגיאות: מאתרת שאילתות לא תקינות בשלב מוקדם, לפני שהן משולבות באפליקציות, וכך מצמצמת את השגיאות בזמן הריצה ואת הכשלים בקריאות ל-API.
  • פיתוח מהיר יותר: מאפשר בדיקה וניפוי באגים מהירים של הצהרות GAQL בלי העומס של מחזורי בקשות API ותגובות מלאים.
  • הסבר על אילוצים ב-GAQL: עוזר למפתחים להבין את הכללים המורכבים לגבי השדות התואמים והקשר בין המשאבים.
  • ניפוי באגים בשאילתות: אם השאילתה לא תקינה, מוצגות הודעות שגיאה ספציפיות, שלרוב מפורטות יותר מהודעת שגיאה כללית של ה-API. לפעמים מוצעות חלופות תקינות.
  • יעילות המשאבים: המערכת נמנעת מקריאות מיותרות ל-API עם שאילתות שנועדו להיכשל.

איך זה עובד

כלי אימות השאילתות מנתח את שאילתת GAQL בהתאם לסכימה של Google Ads API ולכללים שמוגדרים בשפת השאילתות של Google Ads. הוא משתמש במטא-נתונים, שחלק גדול מהם נגיש מ-GoogleAdsFieldService, כדי לבצע בדיקות, כולל:

  1. תחביר ומבנה: מוודא שהשאילתה תואמת לדקדוק הנכון של GAQL, כולל שימוש נכון בסעיפים כמו SELECT,‏ FROM, ‏ WHERE, ‏ ORDER BY, ‏ LIMIT ו-PARAMETERS, וסדר נכון שלהם.
  2. תקינות השדה: בדיקה אם כל השדות שצוינו (משאבים, פלחים, מדדים) קיימים והאיות שלהם נכון.
  3. תאימות המשאב: המערכת בודקת שהשדות שנבחרו בסעיף SELECT תואמים למשאב הראשי שצוין בסעיף FROM.
  4. תאימות של פלחים ומדדים: מוודא שהפלחים והמדדים שמשמשים יחד באותה שאילתה תואמים זה לזה ולמשאב בסעיף FROM.
  5. דרישות לגבי סעיפים: מאמת את הכללים, כמו הדרישה ששדות שמשמשים בסעיפי ORDER BY ושדות מסוימים שמשמשים בסעיפי WHERE (כמו פלחים) יופיעו גם בסעיף SELECT.
  6. שימוש באופרטורים: בדיקה של שימוש נכון באופרטורים בתנאים של סעיף WHERE.

אם השאילתה תקינה, הכלי יאשר אותה. אם נמצאו בעיות, יוצגו הודעות שגיאה שיעזרו לכם לזהות את הבעיה. לפעמים יוצגו גם הצעות לפתרון, כמו משאבים תואמים למדד מסוים.

שנתחיל?

כדי להשתמש בכלי לאימות שאילתות ב-Google Ads:

  1. עוברים אל Query Validator.
  2. מזינים את שאילתת GAQL.
  3. לוחצים על הלחצן Validate Query (אימות השאילתה).
  4. בודקים את הודעת האימות שמופיעה מתחת לווידג'ט Query Validator. אם השאילתה תקינה, תוצג הודעה על כך. אחרת, תוצג הודעת שגיאה עם תיאור הבעיה. הודעות השגיאה ינחו אתכם לתקן את השאילתה. לדוגמה, בשגיאה של חוסר תאימות בשדה יכול להיות שיופיעו משאבים חלופיים שכן תואמים למדד או לפלח שאתם מנסים לשלוף.

כדי לקבל הסברים מפורטים יותר על המושגים והאימות של GAQL, אפשר גם לעיין במדריכי הווידאו בנושא GAQL או להשתמש בכלי ליצירת שאילתות וב-API Explorer.