הכלי של Google Ads ליצירת שאילתות הוא כלי אינטראקטיבי שנועד לעזור לכם ליצור ולאמת שאילתות באמצעות שפת השאילתות של Google Ads (GAQL). גם אם אתם חדשים ב-GAQL וגם אם אתם משתמשים מנוסים, הכלי ליצירת שאילתות יכול לפשט את התהליך של אחזור הנתונים המדויקים שאתם צריכים מ-Google Ads API.
יתרונות
- קלות השימוש: הכלי מפשט את תהליך הכתיבה של שאילתות GAQL, בלי לדרוש היכרות עם התחביר הספציפי והשדות הזמינים.
- גילוי: עוזר לחקור ולמצוא משאבים, שדות, פלחים ומדדים שזמינים במודל הנתונים של Google Ads API.
- פחות שגיאות: הממשק המובנה ותפריטי הנפתחים עם האפשרויות התקינות עוזרים למנוע שגיאות תחביר ושגיאות הקלדה, וכך לוודא שהשאילתה שנוצרה תקינה.
- יצירת שאילתות מהירה יותר: כדי להאיץ את תהליך הפיתוח, המערכת יוצרת באופן אוטומטי מחרוזות של שאילתות.
- אימות: הכלי מקושר ל-API Explorer ול-Query Validator, כדי לבדוק שאילתות מול כללי ה-API לפני ההפעלה.
איך זה עובד
הכלי של Google Ads ליצירת שאילתות מספק ממשק ידידותי למשתמש שמאפשר להרכיב שאילתות GAQL באופן ויזואלי. זהו תהליך העבודה הבסיסי:
- בחירת מקור: מתחילים בבחירת המקור הראשי בכרטיסייה Reference של הגרסה שרוצים לשלוח לה שאילתה. המשאב הזה מופיע בסעיף
FROM. משאבים מייצגים ישויות ב-Google Ads, כמוcampaign,ad_groupאוkeyword_view. בכלי לבניית תוכניות מופיעה רשימה של כל המשאבים הזמינים. - בחירת שדות: אחרי שבוחרים משאב, הכלי מציג את כל השדות שאפשר לבחור, כולל מאפיינים, פלחים ומדדים שקשורים למשאב הזה ולמשאבים המשויכים שלו (שאפשר לצרף באופן מרומז). אפשר לסמן את התיבות כדי לכלול שדות בסעיף
SELECT. כשאתם בוחרים אפשרויות, הכלי יוצר באופן דינמי את מחרוזת השאילתה המתאימה של GAQL, מציג שגיאות ומסנן שילובים לא תואמים של שדות. - החלת מסננים: מוסיפים תנאים של פסוקית
WHEREכדי לסנן את התוצאות. הכלי לבניית שאילתות עוזר לכם לבחור שדות, אופרטורים וערכים, ומבטיח תחביר נכון. - מיון התוצאות: מציינים את סדר המיון באמצעות פסוקית
ORDER BY. - הגדרת מגבלות: מוסיפים פסוקית
LIMITכדי לשלוט במספר התוצאות שמוחזרות. - אימות: הכלי מנחה אתכם באופן מובנה ליצירת שילובים תקינים של שדות, ומקשר גם אל API Explorer כדי שתוכלו לבדוק את השאילתה מול נתוני החשבון שלכם. יש גם כלי נפרד לאימות שאילתות שבו אפשר להדביק ולבדוק שאילתות GAQL שנכתבו באופן ידני.
- ייצוא: אחרי שאתם מרוצים מהשאילתה, מעתיקים ומדביקים את מחרוזת ה-GAQL שנבדקה והיא תקינה מבחינת התחביר, אל בקשות הלקוח שלכם ב-
GoogleAdsService.Searchאו ב-SearchStream.
הכלי ליצירת שאילתות מוודא שהשדות, הפלחים והמדדים שנבחרו תואמים ושאפשר להשתמש בהם יחד בשאילתה אחת, תוך הפניה למטא-נתונים הבסיסיים של Google Ads API.
שנתחיל?
יש שתי דרכים להגיע לכלי ליצירת שאילתות: אפשר לעבור לדף ספציפי במסמכי העזר בנושא דיווח, או לעיין בדף הסקירה הכללית של הכלי ליצירת שאילתות.
ממאמרי העזרה בנושא דיווח
- כדאי להתחיל עם מסמכי העזר בנושא דיווח ולבחור משאב ספציפי מרשימת כל המשאבים. אפשרות אחרת היא לנווט ישירות למשאב מחלונית הניווט הימנית.
- לוחצים על עזרה ביצירת שאילתה כדי לעבור אל הכלי ליצירת שאילתות עבור המשאב הספציפי הזה.
מדף הסקירה הכללית של הכלי ליצירת שאילתות
עוברים לקטע Query Builder (כלי ליצירת שאילתות) במסמכי העזר בנושא דיווח, ובוחרים את המשאב שרוצים לבדוק.
שילוב עם כלים אחרים
הכלי ליצירת שאילתות משולב עם כלים אחרים בערכת הכלים למפתחים של Google Ads API. אפשר לקחת שאילתה שנוצרה בכלי ליצירת שאילתות ולבדוק אותה בכלי API Explorer או לאמת אותה באמצעות כלי אימות השאילתות.
API Explorer
אחרי שיוצרים את השאילתה, לוחצים על Try in API Explorer (התנסות ב-API Explorer) כדי לפתוח את השאילתה ב-API Explorer. השאילתה שלכם מאוכלסת אוטומטית בגוף הבקשה, ואז תוכלו לבדוק את השאילתה על ידי הרצתה על נתוני החשבון. מידע נוסף על הכלי הזה זמין במאמר בנושא API Explorer.
הכלי לתיקוף שאילתות
כשלוחצים על הזנה או עריכה של שאילתה, נפתח מאמת השאילתות. כדי לאמת את התחביר של השאילתה, משתמשים בכלי לאימות שאילתות. לכל שאילתה שנוצרה באמצעות הכלי ליצירת שאילתות יש כבר תחביר נכון, אבל אם אתם מכירים את המשאב שאתם שולחים לו שאילתה, הכלי לאימות שאילתות מאפשר להזין שאילתה ולבדוק את התוקף שלה במהירות. מידע נוסף על הכלי הזה זמין במאמר Query Validator.