יצירה והרצה של דוחות

במדריך הזה מוסבר איך ליצור ולהריץ דוחות ואיך לצפות בתוצאות.

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

יצירת דוח

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

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

1. ב-Ads Data Hub, פותחים את הדף Reports (דוחות).
2. לוחצים על + יצירת דוח. ייפתח הדף Create a new report.
   • אפשר לסנן תבניות באמצעות חיפוש, בחירה של סמלי מוצרים ובחירה באפשרויות מהתפריט הנפתח.
3. בוחרים תבנית ולוחצים על שימוש בתבנית, או לוחצים על SQL כדי להתחיל מאפס.
   • כדי לראות תצוגה מקדימה של פרטי התבנית ושל ה-SQL, לוחצים על expand_content הרחבה.
4. כדי לערוך את הדוח, לוחצים על עריכת השאילתה. בעזרת עורך השאילתות אפשר:
   • להתאים אישית את הדוח באמצעות SQL שתואם ל-BigQuery.
   • מגדירים פרמטרים בכרטיסייה מאפיינים.
   • בכרטיסייה טבלאות של Google אפשר לראות רשימה של טבלאות ושדות זמינים.
   • בכרטיסייה 'טבלה עם נתונים ממקור ראשון' אפשר לראות רשימה של טבלאות עם נתונים ממקור ראשון שייבאתם ואת הסכימות שלהן.
   • לוחצים על Run כדי להריץ את שאילתת ה-SQL. שימו לב שהרצות שהופעלו מכלי העריכה של שאילתות SQL לא נכללות בהיסטוריית ההרצות של הדוח, ולא יופיעו בקטע פעילות אחרונה בדף הבית.
   • לוחצים על סיום כדי לאשר את השינויים בשאילתה ולחזור לדף הגדרת הדוח.
5. נותנים שם לדוח.
6. אם רלוונטי, מגדירים את ערכי הפרמטרים בכרטיס ההגדרה.
7. מגדירים את הקלט והפלט של משימות שמופעלות בדוח הזה:
   • בוחרים מקור נתונים בשדה נתוני מודעות מ. זה צריך להיות מספר החשבון ב-Ads Data Hub שמשויך לנתוני הפרסום שרוצים להריץ עליהם שאילתה. (אם רוצים להריץ שאילתות על נתוני Sandbox, בוחרים באפשרות ADH Sandbox Customer).
   • אם משתמשים בטבלת התאמה, בוחרים את טבלת ההתאמה בשדה חשבון טבלת ההתאמה.
   • בוחרים טווח תאריכים ואזור זמן לדוח. אזור הזמן בדוח צריך להיות זהה לאזור הזמן של חשבון הפרסום המקושר, כמו חשבון Google Ads. הערה: אפשר להגדיר טווח תאריכים מותאם אישית לבדיקת שאילתות רק כשמריצים את השאילתה ממסך עורך ה-SQL.
   • אופציונלי: משנים את הגדרות הפרטיות ומגדירים את סיכום השורות המסוננות.
   • בוחרים את הפרויקט, מערך הנתונים והטבלה ב-BigQuery שבהם רוצים לשמור את תוצאות הדוח.
8. אופציונלי: אפשר להגדיר את הדוח כך שיפעל לפי לוח זמנים.
9. לוחצים על שמירה.

---

פרמטרים

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

בדוגמה הבאה, הדוח מכיל פרמטר בשם campaign_ids, שמקבל array של int64 מזהי קמפיינים:

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

  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

סוגי פרמטרים

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

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

הוספת פרמטר לדוח

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

שימוש בפרמטר

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

הסרת פרמטר

1. פותחים דוח שהוגדרו לו פרמטרים.
2. לוחצים על עריכת שאילתה כדי לפתוח את עורך ה-SQL.
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 (לא משתמשים ב-@ שמופיע לפני פרמטרים אחרים). מידע נוסף ודוגמאות לשימוש בפרמטר הזה זמינים במאמר ייצוא של כמה טבלאות באמצעות שאילתה אחת.

---

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

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

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

---

עריכת דוח

1. ב-Ads Data Hub, פותחים את הדף Reports (דוחות).
2. לוחצים על שם הדוח שרוצים לערוך.
3. מבצעים שינויים בדוח. לדוגמה, לערוך את ה-SQL, לנהל ערכי פרמטרים או להגדיר לוח זמנים.
4. לוחצים על שמירה.

---

הרצת דוח

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

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

1. ב-Ads Data Hub, פותחים את הדף Reports (דוחות).
2. לוחצים על שם הדוח שרוצים להריץ.
3. לוחצים על Run.

הרצת דוח לפי לוח זמנים

1. ב-Ads Data Hub, פותחים את הדף Reports (דוחות).
2. לוחצים על שם הדוח שרוצים לתזמן.
   • כדי להגדיר תזמון לדוח חדש, יוצרים את הדוח ואז לוחצים על שמירה.
3. לוחצים על + הגדרת לוח זמנים.
4. בחלונית תזמון, לוחצים על המתג תזמון ההפעלה של הדוח הזה עם הפרטים שלמטה כדי להעביר אותו למצב מופעל.
5. בקטע תדירות, בוחרים את פרק הזמן ואת השעה ביום, ואז מזינים את אזור הזמן.
   • כדי להשתמש בביטוי cron במקום זאת, לוחצים על המתג הגדרת לוח זמנים באמצעות ביטוי cron כדי להעביר אותו למצב מופעל, ואז מזינים את הביטוי בתיבה.
6. לוחצים על סיום.
7. לוחצים על שמירה כדי לשמור את השינויים בדוח.

כדי להציג את המשימות המתוזמנות בדף Home, בוחרים באפשרות Anyone ברשימת המסננים Owner.

---

הצגת התוצאות

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

תצוגה מקדימה

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

BigQuery

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

‫Sheets ו-Data Studio

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