כתיבת שאילתות והרצתן

יצירת שאילתה

הערה: לא כל המשתמשים יכולים ליצור ולערוך שאילתות. מידע נוסף על בקרת גישה ב-Ads Data Hub

1. עוברים לכרטיסייה שאילתות ב-Ads Data Hub.
2. לוחצים על + יצירת שאילתה. ייפתח הדף תבניות של שאילתות ניתוח.
3. אופציונלי: כדי לראות תצוגה מקדימה של תבנית SQL, לוחצים על הרחבה.
4. כדי לבחור תבנית, לוחצים על שימוש בתבנית. כדי להתחיל מאפס, לוחצים על ריק.
5. נותנים שם לדוח.
6. כותבים או עורכים את השאילתה באמצעות SQL שמתאים ל-BigQuery. בכרטיסייה טבלאות Google אפשר למצוא טבלאות ושדות זמינים ולהוסיף אותם ל-SQL.
7. אופציונלי: מגדירים פרמטרים.
8. אופציונלי: מגדירים את סיכום השורה המסוננת.
9. לוחצים על שמירה.

פרמטרים

הפרמטרים הופכים את השאילתות לגמישות יותר. לדוגמה, יכול להיות שתרצו להריץ את אותה שאילתה על קמפיינים שונים. במקום להריץ שאילתות כפולות או להגדיר מראש את מזהי הקמפיינים לפני כל הרצה, אפשר להגדיר פרמטר שמקבל מזהה קמפיין אחד או יותר שיוזנו מכרטיס ההרצה כשמריצים שאילתה. השימוש בפרמטרים מאפשר לשמור על קוד נקי, מצמצם את הסיכוי להוספת שגיאות באמצעות עריכה ומאפשר לעשות שימוש חוזר בשאילתה בלי לערוך אותה. הפרמטרים מוגבלים לשאילתה שבה הם נוצרו, כך שאפשר להשתמש בשם של פרמטר בשאילתה אחרת.

סוגי פרמטרים

מותר להשתמש בסוגי הפרמטרים הבאים:

• int64
• float64
• bool
• string
• date
• timestamp
• ‫array, מכל אחד מהסוגים המותרים

יצירת פרמטר

1. פותחים שאילתה שמורה או יוצרים שאילתה חדשה.
2. לוחצים על מאפיינים > פרמטרים > הוספת פרמטר.
3. מזינים שם בשדה שם. השם הזה ישמש להפניה לפרמטר בטקסט של השאילתה.
4. משתמשים בתפריט הנפתח כדי לבחור את סוג הפרמטר.
   • אם בוחרים באפשרות 'מערך', מופיע תפריט נפתח נוסף. בוחרים את סוג המערך בתפריט הנפתח.
5. אופציונלי: חוזרים על שלבים 2-4 עד שמוסיפים את כל הפרמטרים הרצויים.
6. לוחצים על שמירה.

שימוש בפרמטר

בטקסט של השאילתה, משתמשים בפורמט הסטנדרטי של פרמטר SQL, כלומר מוסיפים @ לפני שם הפרמטר. בדוגמה הבאה, השאילתה מכילה פרמטר בשם @campaign_ids:

  /* Parameters:
  * @campaign_ids (ARRAY of INT64): A list of campaign IDs
  *   to conduct analysis on */

  WITH user_reach AS (
  SELECT 
    user_id,
    count(*) AS num_views
  FROM 
    adh.google_ads_impressions
  WHERE 
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY 
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM 
    user_reach

כשמריצים את השאילתה, תיבת הדו-שיח New job מכילה שדה Parameters. מזינים ערכים לכל פרמטר שהגדרתם.

הסרת פרמטר

1. פותחים את השאילתה שכוללת את הפרמטר שרוצים למחוק.
2. פותחים את הכרטיסייה מאפיינים.
3. בכרטיס פרמטרים, לוחצים על מחיקה מחיקה לצד הפרמטר שרוצים למחוק.
4. לוחצים על 'שמירה'.

פרמטרים שמורים

בטבלה הבאה מפורטים הפרמטרים ששמורים ב-Ads Data Hub. אפשר להשתמש בפרמטרים האלה בשאילתות, אבל אי אפשר ליצור פרמטר עם שם זהה לפרמטר שמור.

start_date	date תאריך ההתחלה (כולל) של עבודת השאילתה. פרמטר שהוגדר על ידי המשתמש עם השם הזה יתעלם ויוחלף בערכים שהוגדרו בתיבת הדו-שיח New job.
end_date	date תאריך הסיום (כולל) של עבודת השאילתה. פרמטר שהוגדר על ידי המשתמש עם השם הזה יתעלם ויוחלף בערכים שהוגדרו בתיבת הדו-שיח New job.
time_zone	string אזור הזמן של עבודת השאילתה. המערכת תתעלם מפרמטר שהוגדר על ידי המשתמש עם השם הזה, ותחליף אותו בערכים שהוגדרו בתיבת הדו-שיח New job. טיפ: כדי למנוע אי התאמות כשמשתמשים באזורי זמן בשאילתה, למשל בסעיפים של WHERE, אפשר להשתמש ב-time_zone כדי להתאים לאזור הזמן שהוגדר בNew job. חשוב גם להשתמש באותו אזור זמן כמו מקור הנתונים.
params	string מרחב שמות למתן שמות לטבלאות מיוצאות. כדי ליצור placeholder בשאילתה, צריך להשתמש בפורמט הבא, ואז לספק את שם הטבלה כשמריצים את הדוח: params.TABLE_NAME (לא משתמשים ב-@ שמופיע לפני פרמטרים אחרים). מידע נוסף ודוגמאות לשימוש בפרמטר הזה זמינים במאמר ייצוא של כמה טבלאות באמצעות שאילתה אחת.

סיכום השורות שסוננו

סיכומי שורות מסוננות מסכמים נתונים שסוננו בגלל בדיקות לאימות הפרטיות. הנתונים מהשורות המסוננות מסוכמים ומוספים לשורה כללית. אי אפשר לנתח את הנתונים המסוננים, אבל אפשר לראות סיכום של כמות הנתונים שסוננו מהתוצאות.

הערה: דרישות הצבירה חלות על סיכומי השורות המסוננות עצמן. אם סיכום השורות שסונן לא עומד בדרישות הצבירה, גם הוא יעבור סינון.

עריכת שאילתה

1. עוברים לכרטיסייה שאילתות ב-Ads Data Hub.
2. לוחצים על שם השאילתה שרוצים לערוך.
3. עורכים את השאילתה.
4. לוחצים על שמירה.

הרצת שאילתה

נקודה חשובה: מומלץ לכתוב ולבדוק את השאילתות באמצעות ארגז החול לפני שמריצים אותן על נתונים אמיתיים. מידע נוסף על שיטות מומלצות לכתיבת שאילתות ב-Ads Data Hub

לפני שמריצים שאילתה, צריך לוודא שנתתם לחשבון השירות dataEditor הרשאה למערך הנתונים שיכיל את הפלט של הצטרפויות. מידע נוסף על אמצעי בקרת הגישה ב-BigQuery

1. עוברים לכרטיסייה שאילתות ב-Ads Data Hub.
2. לוחצים על שם השאילתה שרוצים להריץ.
3. לוחצים על הפעלה.
   • מספר הבייטים הצפוי שהשאילתה תשתמש בהם מוצג בחלק העליון של הדף.
4. בוחרים מזהה בשדה נתוני Google Ads מ. זה צריך להיות מספר החשבון שמשויך לנתוני המודעות שרוצים לשלוח לגביהם שאילתה. (אם רוצים להריץ שאילתות על נתוני ארגז חול, בוחרים באפשרות ADH Sandbox Customer).
5. אם משתמשים בטבלת התאמה, בוחרים את טבלת ההתאמה בשדה טבלת התאמה מ.
6. בוחרים את מצב הפרטיות. מידע נוסף על מצבי פרטיות.
7. מציינים איפה לשמור את תוצאות השאילתה בשדה Destination table.
8. מזינים תאריכי התחלה וסיום כדי לקבוע את טווח התאריכים של השאילתה.
9. מזינים אזור זמן. השעה צריכה להיות זהה לאזור הזמן של דלת הכניסה לקנייה.
10. אופציונלי: מזינים ערכים לפרמטרים.
11. לוחצים על Run.

הצגת התוצאות

אחרי שהשאילתה מסיימת לפעול, אפשר לראות תצוגה מקדימה של התוצאות בדף 'משימות'. אפשר גם לבדוק את הנתונים ב-BigQuery, ב-Sheets או ב-Data Studio.

תצוגה מקדימה

לוחצים על תצוגה מקדימה בתוך העבודה שהסתיימה. 20 התוצאות הראשונות יופיעו מתחת למשימה.

BigQuery

כברירת מחדל, התוצאות מיוצאות ל-BigQuery. לוחצים על הצגת הטבלה כדי לפתוח את BigQuery בחלון חדש.

‫Sheets ו-Data Studio

פותחים את התפריט הנפתח ניתוח ובוחרים באפשרות ניתוח באמצעות Sheets או באפשרות ניתוח באמצעות Data Studio. הנתונים ייפתחו בחלון חדש.