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