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