כלי לאימות שאילתות ב-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, וסדר נכון שלהם.
  2. תקינות השדות: בדיקה אם כל השדות שצוינו (משאבים, פלחים, מדדים) קיימים והאיות שלהם נכון.
  3. תאימות משאבים: מוודא שהשדות שנבחרו בסעיף SELECT תואמים למשאב הראשי שצוין בסעיף FROM.
  4. תאימות של פלחים ומדדים: מוודא שהפלחים והמדדים שמשמשים יחד באותה שאילתה תואמים זה לזה ולמשאב בסעיף FROM.
  5. דרישות של סעיפים: מאמת את הכללים, כמו הדרישה ששדות מסוימים שמשמשים בסעיפים WHERE או ORDER BY יופיעו גם בסעיף SELECT.
  6. שימוש באופרטורים: בדיקה של שימוש נכון באופרטורים בתנאים של סעיף WHERE.

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

שנתחיל?

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

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

הסברים מפורטים יותר על מושגים ואימות של GAQL זמינים גם במדריכי הווידאו בנושא GAQL.