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

במדריך הזה תלמדו איך ליצור ולהריץ דוחות, וגם איך להציג את התוצאות.

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

יצירת דוח

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

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

1. ב-Ads Data Hub, פותחים את הדף Reports.
2. לוחצים על + יצירת דוח. הדף יצירת דוח חדש נפתח.
   • אפשר לסנן תבניות באמצעות חיפוש, בחירה של סמלי מוצרים ובחירה באפשרויות בתפריטים הנפתחים.
3. בוחרים תבנית ולוחצים על Use template (שימוש בתבנית), או לוחצים על SQL כדי להתחיל מאפס.
   • כדי לראות תצוגה מקדימה של פרטי התבנית ושל ה-SQL, לוחצים על expand_content Expand.
4. כדי לערוך את הדוח, לוחצים על עריכת השאילתה. משתמשים בעורך השאילתות כדי:
   • להתאים אישית את הדוח באמצעות SQL תואם ל-BigQuery.
   • מגדירים פרמטרים בכרטיסייה נכסים.
   • בכרטיסייה טבלאות Google מוצגת רשימה של הטבלאות והשדות שזמינים.
   • בכרטיסייה 'טבלאות צד ראשון' מוצגת רשימה של טבלאות צד ראשון שיובאו והסכמות שלהן.
   • לוחצים על Run כדי להריץ את שאילתת ה-SQL. חשוב לזכור שהפעלות שמתחילים דרך עורך השאילתות של SQL לא נכללות בהיסטוריית הביצועים של הדוח, ולא יופיעו בקטע פעילות אחרונה בדף דף הבית.
   • לוחצים על Done כדי לאשר את השינויים בשאילתה ולחזור לדף ההגדרה של הדוח.
5. נותנים שם לדוח.
6. אם רלוונטי, מגדירים את ערכי הפרמטרים בכרטיס ההגדרה.
7. מגדירים את הקלט והפלט למשימות שמריצים בדוח הזה:
   • בוחרים מקור נתונים בשדה נתוני מודעות מ. זה צריך להיות מספר החשבון ב-Ads Data Hub שמשויך לנתוני המודעות שרוצים לשלוח אליהם שאילתה. (אם רוצים להריץ שאילתות על נתונים בארגז החול, בוחרים באפשרות ADH Sandbox Customer).
   • אם משתמשים בטבלת התאמות, בוחרים את טבלת ההתאמות בשדה Match table account.
   • בוחרים טווח תאריכים ואזור זמן לדוח. אזור הזמן של הדוח צריך להתאים לאזור הזמן של חשבון Google Ads המקושר, למשל חשבון 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. לוחצים על Edit query (עריכת השאילתה).
3. בקטע נכסים, לוחצים על הוספת פרמטר.
4. מזינים שם בשדה Name. השם הזה ישמש להפניה לפרמטר בטקסט של הדוח.
5. בוחרים את סוג הפרמטר בתפריט הנפתח.
   • אם בוחרים בסוג מערך, מופיע תפריט נפתח נוסף. בוחרים את סוג המערך בתפריט הנפתח.
6. בשאילתת ה-SQL, מוסיפים את הפרמטר באמצעות פורמט הפרמטר הרגיל של SQL: @PARAMETER_NAME. דוגמה לדוגמה מופיעה בהמשך.
7. לוחצים על סיום ולאחר מכן על שמירה.

שימוש בפרמטר

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

הסרת פרמטר

1. פותחים דוח שבו מוגדרים פרמטרים.
2. לוחצים על Edit query כדי לפתוח את עורך ה-SQL.
3. בקטע Properties, לוחצים על סמל המחיקה Delete לצד הפרמטר שרוצים למחוק.
4. לוחצים על סיום ולאחר מכן על שמירה.

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

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

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

---

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

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

בסיכומי השורות שסוננו מסתנכרנים הנתונים שסוננו עקב בדיקות ההבדלים. הנתונים משורות שסוננו מסוכמים ומתווספים לשורה כוללת. אי אפשר לנתח את הנתונים המסוננים, אבל הם מספקים סיכום של כמות הנתונים שסוננו מהתוצאות. בשאילתות שמשתמשות במצב הפרטיות של בדיקות ההבדלים, מערכת 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. בחלונית Schedule, לוחצים על המתג Schedule this report to run with below details ומעבירים את המתג למצב פעיל.
5. בקטע תדירות, בוחרים פרק זמן ושעה ביום ומזינים אזור זמן.
   • כדי להשתמש בביטוי cron במקום זאת, מעבירים את המתג Set schedule using a cron expression למצב מופעל ומזינים את הביטוי בתיבה.
6. לוחצים על סיום.
7. לוחצים על Save כדי לשמור את השינויים בדוח.

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

---

הצגת התוצאות

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

תצוגה מקדימה

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

BigQuery

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

Sheets ו-Data Studio

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