כתיבה והפעלה של שאילתות

יצירת שאילתה

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

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

הסרת פרמטר

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

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

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

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

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

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

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

עריכת שאילתה

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

הרצת שאילתה

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

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

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

הצגת התוצאות

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

Preview

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

BigQuery

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

Sheets ו-Data Studio

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