הכלי של Google Ads ליצירת שאילתות הוא כלי אינטראקטיבי שנועד לעזור לכם ליצור ולאמת שאילתות באמצעות שפת השאילתות של Google Ads (GAQL). לא משנה אם אתם משתמשים חדשים או מנוסים ב-GAQL, הכלי ליצירת שאילתות יכול לפשט את התהליך של אחזור הנתונים המדויקים שאתם צריכים מ-Google Ads API.
יתרונות
- קלות שימוש: הכלי מפשט את תהליך הכתיבה של שאילתות GAQL, בלי שצריך להכיר את התחביר הספציפי ואת השדות הזמינים.
- יכולת גילוי: עוזרת לחקור ולמצוא משאבים, שדות, פלחים ומדדים זמינים במודל הנתונים של Google Ads API.
- פחות שגיאות: הממשק המובנה והתפריטים הנפתחים עם האפשרויות התקינות עוזרים למנוע שגיאות תחביר ושגיאות הקלדה, וכך מבטיחים שהשאילתה שנוצרת תקינה.
- יצירת שאילתות מהירה יותר: מאיצה את תהליך הפיתוח על ידי אוטומציה של יצירת מחרוזות שאילתות.
- אימות: הכלי מקושר ל-API Explorer ולכלי לתיקוף שאילתות, כדי לבדוק את השאילתות מול כללי ה-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 כדי לוודא שהשדות, הפלחים והמדדים שנבחרו תואמים ואפשר להשתמש בהם ביחד בשאילתה אחת.
שנתחיל?
יש שתי דרכים להגיע לכלי ליצירת שאילתות: דרך דף ספציפי במסמכי העזר בנושא דיווח, או דרך דף הסקירה הכללית של הכלי ליצירת שאילתות.
ממסמכי העזרה בנושא דיווח
- מתחילים עם מסמכי העזר בנושא דיווח, ובוחרים משאב ספציפי להתחיל איתו ברשימה של כל המשאבים. אפשר גם לעבור ישירות למשאב מחלונית הניווט שמימין.
- לוחצים על Help me build a query כדי לעבור לכלי ליצירת שאילתות של המשאב הספציפי הזה.
מדף הסקירה הכללית של הכלי ליצירת שאילתות
עוברים לקטע Query Builder במסמכי העזר בנושא דיווח ובוחרים את המשאב שרוצים לבדוק.
שילוב עם כלים אחרים
הכלי ליצירת שאילתות משולב עם כלים אחרים בערכת הכלים למפתחים של Google Ads API. אתם יכולים לקחת שאילתה שנוצרה בכלי ליצירת שאילתות ולבדוק אותה ב-API Explorer או לאמת אותה באמצעות הכלי לאימות שאילתות.
API Explorer
אחרי שיוצרים את השאילתה, לוחצים על Try in API Explorer כדי לפתוח את השאילתה ב-API Explorer. השאילתה מאוכלסת באופן אוטומטי בגוף הבקשה, ואז אפשר לבדוק את השאילתה על ידי הרצה שלה על נתוני החשבון. למידע נוסף על הכלי, ראו API Explorer.
הכלי לתיקוף שאילתות
כשלוחצים על הזנה או עריכה של שאילתה, הכלי לתיקוף שאילתות נפתח. כדי לאמת את התחביר של השאילתה, משתמשים בכלי לאימות שאילתות. כל שאילתה שנוצרה במלואה באמצעות הכלי ליצירת שאילתות כבר כוללת את התחביר הנכון, אבל אם אתם מכירים את המשאב שאתם שולחים לגביו שאילתה, הכלי לאימות שאילתות מספק דרך מהירה להזין שאילתה ולבדוק את התקינות שלה. מידע נוסף על הכלי הזה זמין במאמר הכלי לתיקוף שאילתות.