תוסף גיליון אלקטרוני של Google Analytics

פיליפ וולטון (Philip Walton), מהנדס התוכנית למפתחים של Google Analytics – מרץ 2014

תוסף הגיליון האלקטרוני של Google Analytics מקל על משתמשי Google Analytics לגשת לנתונים שלהם, להציג אותם באופן חזותי, לשתף אותם ולבצע בהם פעולות.

מבוא

התוסף לגיליונות האלקטרוניים של Google Analytics מספק לכם את העוצמה של ממשק ה-API של Google Analytics, בשילוב עם העוצמה של מניפולציה של נתונים בגיליונות אלקטרוניים של Google. בעזרת הכלי הזה אפשר:

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

סרטוני הדרכה

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

עדכון גיליון אלקטרוני של Google Analytics

בניית מרכז שליטה באמצעות התוסף של Google Analytics לגיליונות אלקטרוניים

התקנת התוסף

כדי להשתמש בתוסף של Google Analytics, תחילה יש להוסיף אותו לגיליון האלקטרוני. ההוראות הבאות מסבירות את התהליך:

  1. יוצרים גיליון אלקטרוני חדש של Google (או פותחים גיליון אלקטרוני קיים).
  2. בסרגל התפריטים בוחרים באפשרות 'תוספים' > הורדת תוספים...
  3. מחפשים את תוסף Google Analytics מגלריית התוספים ובוחרים בו.
  4. מדף התיאור של התוסף, לוחצים על ה-"+"בפינה השמאלית העליונה כדי להוסיף את התוסף הזה לגיליון האלקטרוני.
  5. תופיע תיבת דו-שיח שבה תתבקשו להעניק לתוסף כדי לגשת לנתוני Google Analytics שלכם. לוחצים על &&אישור;&
  6. התוסף מותקן עכשיו. עכשיו תפריט משנה &&Google Analytics" צריך להופיע בתפריט התוספים.

יצירת דוחות

ניתן ליצור דוחות באופן ידני או בעזרת הכלי ליצירת דוחות לתוספים. כדי להשתמש בכלי, בוחרים "הוספה;" > "Google Analytics" > "יצירת דוח חדש" מסרגל התפריטים. בצד שמאל יופיע סרגל צד שמאפשר לך לחפש בקלות את פרטי החשבון ב-Google Analytics, ולבחור את המאפיינים והמדדים שיוצגו בתגובה לשאילתות. בסיום, יש ללחוץ על הלחצן &quotויצירת דוח&ציטוט; פרטי הדוח שלך יופיעו בגיליון בשם

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

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

דוחות פועלים

כדי להפיק את כל הדוחות שיצרת'בחר "Add-on" > "Google Analytics" > "הפעלת דוחות" מסרגל התפריטים.

החרגת דוח

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

בחירת גיליון פלט

הפעלת הדוחות תשלח בקשה ל-Google Analytics API ותדפיס את התוצאות לגיליון לבחירתך. הגיליון יכול להיות גיליון אלקטרוני שבו אתם משתמשים כרגע, או כל גיליון אלקטרוני אחר (כל עוד יש גישת עריכה לגיליון האלקטרוני הזה). כדי להדפיס את התוצאות לגיליון אלקטרוני אחר, מעתיקים את כתובת האתר של הגיליון האלקטרוני ומדביקים אותה בתא שמשמאל לפרמטר "spreadsheet-url" .

תזמון דוחות להפעלה אוטומטית

ניתן להפעיל את הדוחות באופן אוטומטי על ידי בחירת "Add-on" & > "Google Analytics" > "תזמון דוחות" מסרגל התפריטים. פעולה זו תיפתח תיבת דו-שיח לתזמון דוח, שבה תוכלו להפעיל ולהשבית את התזמון ולהגדיר את תדירות הרצת הדוח.

כדי להפעיל את התזמון, מסמנים את התיבה '&מירכאות; מפעילים דוחות באופן אוטומטי." אחרי שמפעילים את לוח הזמנים, אפשר להשתמש בתפריט הנפתח הנבחר כדי לשלוט בשעה ובתדירות. אפשר לתזמן דוחות כך שיפעלו כל שעה, יום, שבוע או חודש.

כדי להשבית את התזמון, מבטלים את הסימון בתיבה '&מירכאות; מפעילים את הדוחות באופן אוטומטי."

תרחישים נפוצים

יצירת שאילתות לנתונים ממספר תצוגות

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

יצירת חישובים בהתאמה אישית באמצעות נתוני Google Analytics

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

יצירת מרכזי בקרה באמצעות תצוגות חזותיות של נתונים מוטמעים

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

קובעים בקלות מי יכול לראות את נתוני Google Analytics

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

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

עדכון אוטומטי של הנתונים והרכיבים החזותיים

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

שאלות נפוצות

איך אפשר לדעת מתי הדוחות הבאים שלי יוצגו?

ההפעלה הראשונה של הדוחות המתוזמנות תתבצע באופן אקראי במהלך תקופת הזמן שציינת. הפעלות הבאות יתבצעו באופן חזוי באותו זמן, בהתאם למרווח שבחרת. לדוגמה, אם תזמנו את הרצת הדוחות מדי יום בין 4:00 ל-5:00 בבוקר, וההרצה הראשונה תתבצע בשעה 4:12 בבוקר, כל ההרצה הבאה תתבצע גם ב-4:12 בבוקר.

הדוחות המתוזמנים שלי לא פועלים בזמן שהם אמורים להופיע, האם הם מנותקים?

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

האם אפשר להגדיר לוחות זמנים שונים לדוחות שונים?

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

למה נתוני הדוח מופיעים בפורמט שגוי?

ממשקי ה-API של דוחות Google Analytics מחזירים את כל הערכים בפורמט של ארה"ב. אם הגיליון האלקטרוני מוגדר למקום אחר, מערכת Google Sheets תנסה לבצע המרה בשבילך, שלפעמים עשויה להניב תוצאות בלתי צפויות.

כדי למנוע את הבעיה הזו, צריך לוודא שהלוקאל של הגיליון האלקטרוני של הדוח מוגדר כ-"United States" (אפשר למצוא את ההוראות לשינוי הגיליון האלקטרוני's של הלוקאל ב-עורכי Docs Help). לאחר מכן, כדי להמיר את הנתונים לפורמט של הלוקאל המועדף עליך, אפשר ליצור גיליון אלקטרוני שני עם קבוצת הלוקאל המועדף עליך ולהשתמש בפונקציה IMPORTRANGE כדי לייבא את נתוני הדוח לגיליון האלקטרוני החדש הזה. מערכת Google Sheets תמיר באופן תקין פורמטים בין לוקאלים כשמייבאים מגיליון אלקטרוני אחד לאחר.

קבלת עזרה

כדי לשאול שאלה לגבי התוסף או לדווח על באג, אפשר לפרסם הודעה בקבוצת google-analytics-spreadsheet-add-on Google. יש לחפש בקבוצה לפני הפרסום כי יכול להיות שהשאלה שלך כבר נענתה.

הפניה לפרמטר של הגדרה

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

פרמטרים נדרשים

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

תאריך ההתחלה של אחזור נתוני Analytics. בקשות יכולות לציין תאריך התחלה בפורמט YYYY-MM-DD, או כתאריך יחסי (למשל, today, yesterday או NdaysAgo כאשר N הוא מספר שלם חיובי).

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

=EOMONTH(TODAY(), -1)
תאריך סיום

תאריך הסיום לאחזור הנתונים של Analytics. בקשות יכולות לציין תאריך סיום בפורמט YYYY-MM-DD, או כתאריך יחסי (למשל, today, yesterday או NdaysAgo כאשר N הוא מספר שלם חיובי).

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

=EOMONTH(TODAY(), -1)
מדדים

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

לדוגמה, כל הערכים הבאים הם ערכים חוקיים עבור הפרמטר 'מדדים'.

ga:sessions,ga:bounces
ga:sessions
ga:bounces
[{
  "expression": "ga:sessions/ga:users",
  "alias": "Sessions per User",
  "formattingType": "FLOAT"
}, {
  "expression": "ga:totalEvents/ga:pageviews",
  "alias": "Events per Pageview",
  "formattingType": "FLOAT"
}]

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

הרשימה המלאה של מאפיינים ומדדים והשילובים החוקיים שלהם זמינים ב-סייר המאפיינים והמדדים.

פרמטרים אופציונליים

שם תיאור
מאפיינים

רשימת מאפיינים לשאילתה. ניתן לציין מימדים באחד משני פורמטים:

לדוגמה, כל הערכים הבאים הם ערכים חוקיים עבור הפרמטר 'מדדים'.

ga:source,ga:deviceCategory
ga:source
ga:deviceCategory
[{
  "name": "ga:source"
}, {
  "name": "ga:deviceCategory"
}]

ברוב המקרים, רשימה של מזהי מאפיינים היא הדרך הקלה ביותר לציין את הפרמטר 'מימדים'.

הרשימה המלאה של מאפיינים ומדדים והשילובים החוקיים שלהם זמינים ב-סייר המאפיינים והמדדים.
הזמנה

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

לדוגמה, כל הערכים הבאים הם ערכים חוקיים עבור הפרמטר Order.

-ga:sessions,ga:eventLabel
-ga:sessions
ga:eventLabel
[{
  "fieldName": "ga:sessions",
  "sortOrder": "DESCENDING"
}, {
  "fieldName": "ga:eventLabel",
  "sortOrder": "ASCENDING",
  "orderType": "DIMENSION_AS_INTEGER"
}]

ברוב המקרים, הפורמט הקודם הוא הדרך הקלה ביותר לציין את פרמטר ההזמנה. עם זאת, אם רוצים להשתמש בפרמטר orderType, צריך לציין את הערך בפורמט JSON.
מסננים

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

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

ga:sessions>10;ga:country==United States
{
  "metricFilterClauses": [{
    "filters": [
      {
        "metricName": "ga:totalEvents",
        "operator": "GREATER_THAN",
        "comparisonValue": "100"
      }
    ]
  }],
  "dimensionFilterClauses": [{
    "operator": "AND",
    "filters": [
      {
        "dimensionName": "ga:eventCategory",
        "operator": "EXACT",
        "expressions": ["Outbound Link"]
      }
    ],
    "filters": [
      {
        "dimensionName": "ga:eventAction",
        "operator": "EXACT",
        "expressions": ["click"]
      }
    ]
  }]
}

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

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

לדוגמה, כל אחד מהערכים הבאים הוא ערכים חוקיים עבור הפרמטר 'פלחים'.

gaid::-1,sessions::condition::ga:city==New York
gaid::-1,
sessions::condition::ga:city==New York
[{
  "dynamicSegment": {
    "name": "New York Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses":[{
              "dimensionFilter": {
                "dimensionName": "ga:city",
                "expressions": ["New York"]
              }
            }]
          }]
        }
      }]
    }
  }
}, {
  "dynamicSegment": {
    "name": "Non-referral Sessions",
    "sessionSegment": {
      "segmentFilters": [{
        "simpleSegment": {
          "orFiltersForSegment": [{
            "segmentFilterClauses": [{
              "dimensionFilter": {
                "dimensionName": "ga:medium",
                "operator": "EXACT",
                "expressions": [ "referral" ]
              }
            }]
          }]
        },
        "not": "True"
      }]
    }
  }
}]

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

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

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

לידיעתך, אפשר להגדיר את השדה הזה באופן פרוגרמטי באמצעות נוסחה. לדוגמה, הביטוי הבא ידלג על הדוח אם הערך של תאריך הסיום (תא &ציטוט;B5" עבר):

=IF(B5 < TODAY(), TRUE, FALSE)

פרמטרים מוסתרים

שם סיכום
סוג הדוח

כברירת מחדל (או אם משאירים אותו ריק), הדוח הזה ישלח שאילתה לגבי Analytics Reporting API v4. כדי לשלוח שאילתה ל-API לדיווח על משפכים מרובי-ערוצים, אפשר להגדיר את הערך כ- "mcf"

הערה: כשמשתמשים ב-MCF API, צריך להשתמש גם במאפיינים ומדדים של MCF. בנוסף, חלק מהתכונות האחרות (למשל פלחים) לא זמינות בדוחות של משפכים מרובי-ערוצים (MCF).
רמת הדגימה גודל הדגימה הרצוי של הדוח. ערכים אפשריים הם "DEFAULT" (זהה להשארתם ריקים), &"small" או "LARGE".
שימוש במכסות המשאבים מערכת המכסה מבוססת המשאבים היא מערכת מכסה חדשה שתאפשר לחשבונות 360 מסוימים ב-Analytics 360 לקבל ספי דגימה גבוהים יותר בזמן השימוש ב-Analytics Reporting API. אם יש לך גישה לתכונה הזו, יש לך אפשרות להפעיל אותה על ידי הגדרת הפרמטר הזה ל-TRUE.
החרגה של שורות ריקות

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

חשוב לשים לב שהפרמטר הזה תואם לפרמטר includeEmptyRows של Analytics Reporting API v4, אבל שמו שונה מ-"include" ל-"excluded" כדי להקל על הבנת ההתנהגות שלו.