כלי לאימות שאילתות ב-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.