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

יצירת שאילתה

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

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

פרמטרים

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

סוגי פרמטרים

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

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

יצירת פרמטר

1. פותחים שאילתה שמורה או יוצרים שאילתה חדשה.
2. לוחצים על נכסים > פרמטרים > הוספת פרמטר.
3. מזינים שם בשדה Name. השם הזה ישמש להפניה לפרמטר בטקסט של השאילתה.
4. בוחרים את סוג הפרמטר בתפריט הנפתח.
   • אם בוחרים באפשרות array, מופיע תפריט נפתח נוסף. בוחרים את סוג המערך בתפריט הנפתח.
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. בכרטיס Parameters, לוחצים על delete Delete לצד הפרמטר שרוצים למחוק.
4. לוחצים על 'שמירה'.

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

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

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

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

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

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

עריכת שאילתה

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

הרצת שאילתה

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

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

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

הצגת התוצאות

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

תצוגה מקדימה

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

BigQuery

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

Sheets ו-Data Studio

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