לכתוב ולהריץ דוחות

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

יצירת דוח

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

1. עוברים לכרטיסייה שאילתות ב-Ads Data Hub.
2. לוחצים על + יצירת שאילתה. הדף יצירת דוח חדש נפתח.
3. אופציונלי: אפשר לסנן תבניות על ידי חיפוש, בחירת סמלים ובחירת אפשרויות בתפריט הנפתח:
   • מקור נתונים
   • תרחיש לדוגמה
   • מלאי שטחי פרסום
   • הסמכה של MRC
4. אופציונלי: אפשר להציג תצוגה מקדימה של פרטי התבנית ושל SQL על ידי לחיצה על expand_content Expand.
5. לוחצים על Use template (שימוש בתבנית) כדי לבחור את התבנית הרצויה, או לוחצים על add_circle Add כדי להתחיל מאפס.
6. מזינים שם לדוח.
7. כותבים או עורכים את הדוח באמצעות SQL תואם ל-BigQuery. תוכלו למצוא טבלאות ושדות זמינים ולהוסיף אותם ל-SQL בכרטיסייה Google Tables.
8. אופציונלי: מגדירים פרמטרים.
9. אופציונלי: מגדירים את סיכום השורה המסוננת.
10. לוחצים על שמירה.

פרמטרים

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

סוגי פרמטרים

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

• 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.

הצגת התוצאות

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

Preview

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

BigQuery

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

Sheets ו-Data Studio

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