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

יצירת שאילתה

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

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

פרמטרים

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

סוגי פרמטרים

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

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

יצירת פרמטר

1. פותחים שאילתה שמורה או יוצרים שאילתה חדשה.
2. לוחצים על מאפיינים > פרמטרים > Add parameter (הוספת פרמטר).
3. מזינים שם בשדה Name. נשתמש בשם הזה כדי להפנות אל בטקסט של השאילתה.
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

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

הסרת פרמטר

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

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

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

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

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

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

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

עריכת שאילתה

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

הרצת שאילתה

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

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

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

הצגת התוצאות

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

תצוגה מקדימה

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

BigQuery

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

Sheets ו-Data Studio

פותחים את התפריט הנפתח הצגה כניתוח ובוחרים באפשרות גילוי באמצעות Sheets, או גילוי באמצעות Data Studio מתוך האפשרויות. הפעולה הזו פותחת את הנתונים חלון.