במסמך הזה מוגדרים המדדים שאפשר לאחזר באמצעות ממשק ה-API של YouTube Analytics. ה-API הזה תומך בשאילתות בזמן אמת ליצירת דוחות YouTube Analytics בהתאמה אישית.
מדדים הם אומדנים בודדים של פעילות משתמשים, ביצועי מודעות או הכנסה משוערת. מדדי פעילות המשתמשים כוללים מידע כמו ספירת צפיות בסרטונים ודירוגים (לייקים ודיסלייקים).
מדדי ליבה
ממשק ה-API של YouTube Analytics כפוף למדיניות ההוצאה משימוש שהוגדרה בתנאים והגבלות, אבל מדדים שאינם ליבה (ומאפיינים שאינם ליבה) לא כפופים למדיניות. כל מדד שהוא מדד מרכזי מוגדר בהגדרות בדף הזה באופן מפורש.
ברשימה הבאה מפורטים מדדי הליבה של ה-API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
- מדד הליבה
earnings
הוצא משימוש ב-4 באוגוסט 2016 ושמו השתנה ל-estimatedRevenue
. בהתאם למדיניות ההוצאה משימוש המוגדרת בתנאים ובהגבלות, המדדיםearnings
ו-estimatedRevenue
נתמכים בו-זמנית עד 10 באוגוסט 2017. - מדדי הליבה
favoritesAdded
ו-favoritesRemoved
הוצאו משימוש ב-31 במרץ 2015. את המדדים האלה ניתן לאחזר רק דרך ממשק ה-API של YouTube Analytics.
מידע נוסף זמין ברשימת ממשקי ה-API של YouTube שכפופים למדיניות ההוצאה משימוש.
הצגת המדדים
- צפיות (מדד ליבה)
- המדד הזה מייצג מספרים שונים בסוגים שונים של דוחות:
- בדוחות וידאו, המדד הזה מציין את מספר הפעמים שבהן הסרטון נצפה.
- בדוחות פלייליסטים שלא משתמשים במאפיין
isCurated
, המדד הזה מציין את מספר הצפיות הכולל בסרטונים בפלייליסט, בין אם הצפיות האלה בוצעו בהקשר של הפלייליסט. חשוב לשים לב שערך המדד כולל רק צפיות בסרטונים של בעלי הערוץ.
בדוחות האלה, המדדplaylistViews
מציין את מספר הפעמים שאנשים צפו בסרטונים בפלייליסט הזה בהקשר של פלייליסט ספציפי. - בדוחות של פלייליסטים שנעשה בהם שימוש במאפיין
isCurated
, המדד הזה מציין את מספר הפעמים שהסרטונים נצפו בהקשר של פלייליסט ספציפי. הערה: המדדplaylistViews
לא נתמך בדוחות האלה.
- playlistViews
- המדד הזה מוגדר בקטע מדדי הפלייליסט.
- redViews
- מספר הפעמים שבהן מנויי YouTube Premium (לשעבר YouTube Red) צפו בסרטון מסוים.
- UPI (הוצא משימוש ב-27 בספטמבר 2016)
- מספר הצופים הייחודיים שצפו בסרטון. החישוב הזה מבוסס על מספר קובצי ה-cookie הייחודיים, ולכן יגרום לספירת יתר של משתמשים שמשתמשים במספר מכשירים או דפדפנים.
המדדuniques
הוצא משימוש ב-27 בספטמבר 2016. זה לא מדד עיקרי, והוא נתמך עד 31 באוקטובר 2016. - viewerPercentage (מדד ליבה)
- אחוז הצופים שהיו מחוברים בזמן הצפייה בסרטון או בפלייליסט. This is a core metric and is subject to the Deprecation Policy.
ערכים של זמן צפייה
- estimatedMinutesWatched (מדד ליבה)
- מספר הדקות שבהן משתמשים צפו בסרטונים של הערוץ, בעלי התוכן, הסרטון או הפלייליסט שצוינו. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- מספר הדקות שבהן מנויי YouTube Premium (לשעבר YouTube Red) צפו בסרטון.
- averageViewDuration (מדד ליבה)
- משך הזמן הממוצע, בשניות, של הפעלות של סרטונים. נכון ל-13 בדצמבר 2021, המדד הזה לא כולל תנועה מסוג קליפים מסוג לולאה. בדוח 'פלייליסט', המדד מציין את משך הזמן הממוצע, בשניות, של הפעלות סרטונים שהתרחשו בהקשר של פלייליסט. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- האחוז הממוצע מתוך סרטון שנצפה במהלך הפעלת סרטון. נכון ל-13 בדצמבר 2021, המדד הזה לא כולל תנועה מסוג קליפים מסוג לולאה.
מדדי התעניינות
- הערות (מדד ליבה)
- מספר הפעמים שמשתמשים הגיבו על סרטון. מידע נוסף זמין במרכז העזרה של YouTube. This is a core metric and is subject to the Deprecation Policy.
- לייקים (מדד ליבה)
- מספר הפעמים שמשתמשים ציינו שהם אהבו סרטון בכך שנתנו לו דירוג חיובי. This is a core metric and is subject to the Deprecation Policy.
- דיסלייקים (מדד ליבה)
- מספר הפעמים שמשתמשים ציינו שהם לא אהבו סרטון בכך שהעניקו לו דירוג שלילי. This is a core metric and is subject to the Deprecation Policy.
- מספר הפעמים שמשתמשים שיתפו סרטון באמצעות הלחצן
Share
. מידע נוסף זמין במרכז העזרה של YouTube. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (מדד ליבה)
- מספר הפעמים שמשתמשים נרשמו לערוץ. This is a core metric and is subject to the Deprecation Policy.
ערוצים יכולים לצבור או לאבד מנויים בכמה מקומות, כולל בדף הצפייה של הסרטון, בדף הערוץ ובמדריך שמופיע בדף הבית של YouTube. בדוחות הערוצים, המדד הזה כולל מנויים שנצברו מכל אחד מהמקומות האלה. עם זאת, בדוחות שבהם נעשה שימוש במאפייןvideo
או בפרמטרfilter
כדי להגביל את התגובה כך שתכלול רק נתונים של סרטון מסוים, המדדsubscribersGained
יכלול רק נתונים סטטיסטיים מדף הצפייה של הסרטון שצוין. - subscribersLost (מדד ליבה)
- מספר הפעמים שמשתמשים ביטלו את הרישום לערוץ. This is a core metric and is subject to the Deprecation Policy.
הנתונים של המדד הזה מדווחים באופן דומה לנתונים של המדדsubscribersGained
. בדוחות ערוצים, ערך זה כולל מנויים שעזבו בכל מנגנון שבאמצעותו משתמשים יכולים לבטל את ההרשמה לערוץ. עם זאת, בדוחות שבהם נעשה שימוש במאפייןvideo
או בפרמטרfilter
כדי להגביל את התגובה כך שתכלול רק נתונים לגבי סרטון מסוים, המדד הזה כולל רק משתמשים שביטלו את ההרשמה לדף הצפייה של הסרטון שצוין. - videosAddedToPlaylists
- מספר הפעמים שהסרטונים נוספו לפלייליסטים ב-YouTube. ייתכן שהסרטונים נוספו לפלייליסט של בעלי הסרטון או לפלייליסטים של ערוצים אחרים.
ערך המדד כולל את מספר הפעמים שהסרטונים נוספו לפלייליסטים שמוגדרים כברירת מחדל, כגון הפלייליסט 'לצפייה בהמשך'. עם זאת, המדד הזה לא סופר פלייליסטים שסרטון נוסף אליהם באופן אוטומטי, כמו פלייליסטים שהועלו בערוץ או היסטוריית צפייה של המשתמש.
המדד הזה מחזיר מספר מוחלט, כלומר, אם משתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, ערך המדד משקף את הסרטון שהתווסף לפלייליסט פעמיים. נתונים עבור המדד הזה אינם זמינים לתאריכים לפני 1 באוקטובר 2014. - videosRemovedFromPlaylists
- מספר הפעמים שהסרטונים הוסרו מכל פלייליסט ב-YouTube. ייתכן שהסרטונים הוסרו מהפלייליסט של בעלי הסרטון או מפלייליסטים של ערוצים אחרים.
ערך המדד כולל את מספר הפעמים שבהן סרטונים הוסרו מפלייליסטים שמוגדרים כברירת מחדל, כמו הפלייליסט 'לצפייה בהמשך'.
המדד הזה מחזיר מספר מוחלט, כלומר אם משתמש מוסיף סרטון לפלייליסט, מסיר אותו, מוסיף אותו שוב ואז מסיר אותו שוב, ערך המדד משקף את הסרטון שהוסר מהפלייליסט פעמיים. נתונים עבור המדד הזה אינם זמינים לתאריכים לפני 1 באוקטובר 2014.
מדדי התעניינות שהוצאו משימוש
המדדים הבאים היו שני מדדי ליבה שהוצאו משימוש ב-31 במרץ 2015.
- favoritesAdded (מדד ליבה) (הוצא משימוש ב-31 במרץ 2015)
- מספר הפעמים שמשתמשים סימנו סרטון כסרטון מועדף. מידע נוסף זמין במרכז העזרה של YouTube. This is a core metric and is subject to the Deprecation Policy.
- favoritesRemoved (מדד ליבה) (הוצא משימוש ב-31 במרץ 2015)
- מספר הפעמים שמשתמשים הסירו סרטון מרשימות הסרטונים המועדפות שלהם. מידע נוסף זמין במרכז העזרה של YouTube. This is a core metric and is subject to the Deprecation Policy.
מדדים של פלייליסטים
דוחות פלייליסטים מכילים שני סוגי מדדים שמסבירים את האינטראקציה של הצופים עם הסרטונים בפלייליסט:
-
מדדי הסרטונים המצטברים מספקים מדדי חשיפות ופעילות משתמשים. מדדי החשיפות נצברים לכל הסרטונים בפלייליסט, שהם גם בבעלות הערוץ שהפלייליסט נמצא בבעלותו. מדדים של סרטונים שנמצאים בבעלות של ערוצים אחרים לא מחושבים בחשבון הצבירה. כתוצאה מכך, אם ערוץ יוצר פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, הדוחות של הפלייליסטים האלה לא יספקו ערכים למדדים האלה.
אפשר להיעזר בקטעים מדדי צפייה ומדדים של זמן צפייה במסמך הזה, להגדרות של מדדי וידאו נצברים נתמכים.
-
מדדים בתוך הפלייליסט משקפים את פעילות המשתמשים ואת ההתעניינות שלהם בהקשר של דף הפלייליסט. המדדים האלה כוללים צפיות בכל הסרטונים בפלייליסט, ללא קשר לערוץ הבעלים שלהם, אבל הם סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
רוב המדדים שמפורטים למטה הם מדדים בפלייליסט. המדדים שנותרו ברשימה, כמו המדד playlistSaves
, משקפים את האינטראקציות של המשתמשים עם הפלייליסט עצמו
ולא עם סרטונים בפלייליסט. לכן, המדדים האלה לא יאופינו
כמדדי וידאו מצטברים או כמדדים בפלייליסט.
- averageTimeInPlaylist
- אומדן של משך הזמן הממוצע, בדקות, שבמהלכו צופה צפה בסרטונים בפלייליסט
לאחר התחלת הפלייליסט. לתשומת ליבך, המדד הזה כולל רק צפיות בפלייליסט
שהתרחשו באינטרנט.
- playlistAverageViewDuration
- משך הזמן הממוצע המשוער, בשניות, שנצפה בכל צפייה בפלייליסט. חשוב לשים לב שהמדד הזה
מייצג את משך הצפיות הממוצע בסרטונים ספציפיים בתוך פלייליסט. לעומת זאת,
המדד
averageTimeInPlaylist
מייצג את הזמן הממוצע שכל צופה מקדיש לצפייה בפלייליסט כולו. המדד הזה כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים. - playlistEstimatedMinutesWatched
- מספר הדקות שבהן משתמשים צפו בתוכן הפלייליסט כחלק מהפלייליסט. זמן צפייה
שהתרחש בהקשרים אחרים – למשל, זמן צפייה מצפיות שהתרחשו
כשצופים צפו באותו סרטון כחלק מפלייליסטים אחרים – לא נספר. המדד הזה
כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים.
- playlistSaves
- מספר הפעמים נטו שמשתמשים שמרו פלייליסט. כדאי להיכנס
למרכז העזרה של YouTube כדי לקבל מידע נוסף
על פלייליסטים שמורים. המדד הזה מחזיר מספר נטו של שינוי. כלומר, אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים ושומר אותו שוב, ערך המדד משקף שמירה אחת של פלייליסט.
- playlistStarts
- מספר הפעמים שצופים יזמו הפעלה של פלייליסט. חשוב לשים לב שהמדד הזה
כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
- playlistViews
- מספר הפעמים שהסרטונים בפלייליסט נצפו בהקשר של אותו פלייליסט.
המדד הזה כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים.
- viewsPerPlaylistStart
- המספר הממוצע של צפיות בסרטונים שהתרחשו בכל פעם שפלייליסט הופעל. חשוב לשים לב
שהמדד הזה כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
מדדי הערות
הערה: דוחות ה-API של YouTube Analytics מחזירים נתונים רק עבור המדדים annotationClickThroughRate
ו-annotationCloseRate
החל מ-10 ביוני 2012. בנוסף, דוחות ה-API של YouTube Analytics מחזירים נתונים רק לגבי מדדי ההערות הנותרים נכון ל-16 ביולי 2013.
- annotationImpressions
- המספר הכולל של חשיפות של הערות.
- annotationClickableImpressions
- מספר ההערות שהופיעו וניתן היה ללחוץ עליהן.
- annotationClicks
- מספר ההערות שלחצו עליהן.
- annotationClickThroughRate (מדד ליבה)
- היחס בין ההערות שהצופים לחצו עליהן לבין המספר הכולל של החשיפות של הערות שניתן ללחוץ עליהן. This is a core metric and is subject to the Deprecation Policy. במרכז העזרה של YouTube יש מידע נוסף על יצירת הערות ועל שימוש בהערות לקישורים.
- annotationClosableImpressions
- מספר ההערות שהופיעו ואפשר לסגור אותן.
- annotationCloses
- מספר ההערות שנסגרו.
- annotationCloseRate (מדד הליבה)
- היחס בין ההערות שהצופים סגרו לבין המספר הכולל של החשיפות של ההערות. This is a core metric and is subject to the Deprecation Policy.
מדדי כרטיסים
מרכז העזרה של YouTube כולל הוראות מפורטות יותר להוספת כרטיסים לסרטונים ולדוח הכרטיסים של YouTube Analytics.
- cardImpressions
- מספר הפעמים שהוצגו כרטיסים. כשחלונית הכרטיסים נפתחת, נספרת חשיפה של כרטיס לכל אחד מהכרטיסים בסרטון.
- cardClicks
- מספר הפעמים שלחצו על כרטיסים.
- cardClickRate
- שיעור הקליקים על כרטיסים, שמחושב כיחס בין הקליקים על כרטיסים לחשיפות של כרטיסים.
- מספר הפעמים שבהן הוצגו טיזרים של כרטיסים. צפייה בסרטון יכולה ליצור מספר חשיפות של טיזרים.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל הכרטיס משויכים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים של כרטיסים, שמחושב כיחס בין הקליקים על טיזרים של כרטיסים לבין המספר הכולל של חשיפות של טיזרים בכרטיסים.
מדדי שימור קהל
- audienceWatchRatio
- היחס המוחלט של אנשים שצופים בסרטון בנקודה הנתונה בסרטון. היחס מחושב על ידי השוואה בין מספר הפעמים שמשתמשים צפו בחלק מסרטון לבין מספר הצפיות הכולל בסרטון. המאפיין
elapsedVideoTimeRatio
מזהה את החלק בסרטון שאליו המדד תואם.
חשוב לדעת שאפשר לצפות בחלק מסרטון יותר מפעם אחת (או לא לצפות בכלל) בכל צפייה בסרטון. לדוגמה, אם משתמשים מעבירים אחורה וצופים באותו חלק של סרטון כמה פעמים, היחס המוחלט בחלק הזה של הסרטון עשוי להיות גדול מ-1
.
הדוגמאות הבאות ממחישות איך הערך מחושב:- בסרטון באורך דקה של דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות ושאר הצופים מפסיקים לצפות בסרטון כולו. אף אחד מהצופים לא צופה בחלקים של הסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
1
עבור קטגוריות הזמן ברבע הראשון של הסרטון, והערך שלו יהיה0.50
עד סוף הסרטון. - בסרטון באורך דקה של דקה נצפה 100 פעמים. כל המשתמשים צופים בסרטון כולו, אבל 20 מהצופים צופים בו עד לסיום 45 השניות של הסרטון, לאחר מכן מדלגים חזרה לסמן 30 השניות של הסרטון וצופים בהמשך הסרטון. במקרה הזה, ערך המדד יהיה
1
לקטגוריות זמן במחצית הראשונה או ברבעון האחרון של הסרטון. עם זאת, הערך יהיה1.2
לגבי קטגוריות הזמן ברבעון השלישי של הסרטון, מכיוון ש-100 אחוז מהצופים צפו בחלק הזה של הסרטון, אבל 20% מהצופים האלה צפו בקטע פעמיים.
- בסרטון באורך דקה של דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות ושאר הצופים מפסיקים לצפות בסרטון כולו. אף אחד מהצופים לא צופה בחלקים של הסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
- relativeRetentionPerformance
- מדד שמראה עד כמה סרטון מצליח לשמר את הצופים במהלך הפעלות בהשוואה לכל הסרטונים ב-YouTube באורך דומה. למדד יש ערך בין
0
ל-1
שמזהה את ביצועי השימור היחסיים של הסרטון בנקודה נתונה בסרטון. הנקודה בסרטון מסופקת על ידי המאפייןelapsedVideoTimeRatio
.
הערך0
מציין שהסרטון שומר על מספר הצופים נמוך יותר מכל סרטון אחר באורך דומה, ואילו ערך של1
מצביע על כך שהסרטון משאיר את הצופים טוב יותר מכל סרטון אחר באורך דומה. ערך חציוני של0.5
מצביע על כך שחצי מהסרטונים באורך דומה משמרים צופים טובים יותר, וחצי מהסרטונים משמרים צופים פחות טובים.
הדוגמה ההיפותטית הבאה ממחישה איך הערכים עשויים להופיע בדוח. בממוצע, 90 אחוזים מהצופים שצופים בסרטונים באורך 10 דקות ממשיכים לצפות לאחר שלוש דקות, ו-70 אחוזים עדיין צופים לאחר שמונה דקות. עם זאת, לגבי סרטון ספציפי באורך 10 דקות, רק 80 אחוזים מהצופים ממשיכים לצפות אחרי שלוש דקות, אבל כל הצופים האלה עדיין צפו לאחר שמונה דקות.- בערך
elapsedVideoTimeRatio
שתואם לנקודה שנמצאת שלוש דקות בתחילת הסרטון, למדדrelativeRetentionPerformance
יהיה ערך נמוך מ-0.5
. זאת מכיוון שבאותו זמן הביצועים של הסרטון היו פחות טובים מאלה של הסרטון הממוצע. - בערך
elapsedVideoTimeRatio
שתואם לנקודה שנמצאת שמונה דקות מתחילת הסרטון, למדדrelativeRetentionPerformance
יהיה ערך גבוה מ-0.5
. לכן, באותו זמן, ביצועי הסרטון טובים יותר בהשוואה לסרטונים אחרים באורך דומה.
- בערך
מדדי הכנסה משוערת
הערה: מדדי ההכנסה המשוערת כפופים להתאמות בסוף החודש, ואינם כוללים מודעות שנמכרו או שהוצגו על ידי שותפים. במרכז העזרה של YouTube ניתן למצוא מידע נוסף והערות לגבי נתוני הכנסות משוערים.
currency
למדדים מסוימים של הכנסות משוערות וביצועי מודעות, וכך אפשר לאחזר נתוני הכנסות משוערות במטבעות אחרים.- estimatedRevenue (מדד ליבה) (לשעבר
earnings
) - סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google וכן ממקורות שאינם פרסום באזור ובטווח התאריכים שנבחרו.
This is a core metric and is subject to the Deprecation Policy.
מדדי ההכנסה המשוערת כפופים להתאמות בסוף החודש ואינם כוללים פרסום שנמכר או שמוצג על ידי שותפים.
- estimatedAdRevenue (לשעבר
adEarnings
) - סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google בטווח התאריכים ובאזור שנבחרו.
מדדי ההכנסה המשוערת כפופים להתאמות בסוף החודש ואינם כוללים מודעות שנמכרו או שהוצגו על ידי שותפים. - estimatedRedPartnerRevenue (לשעבר
redPartnerRevenue
) - סך כל ההכנסות המשוערות ממינויים ל-YouTube Premium (לשעבר YouTube Red) ממאפייני הדיווח שנבחרו. ערך המדד משקף את ההכנסות מתוכן מוזיקלי וגם מתוכן שאינו מוזיקה, והוא כפוף להתאמות בסוף החודש.
מדדי ביצועים של מודעות
- grossRevenue
- ההכנסה המשוערת ברוטו בדולר ארה"ב, מכל הפרסום שנמכר על ידי Google או שנמכר על ידי שותף DoubleClick באזור ובטווח התאריכים שנבחרו. ההכנסות ברוטו כפופות להתאמות בסוף החודש ואינן כוללות מודעות שהוצגו על ידי שותפים. חשוב להבדיל בין הכנסה ברוטו לבין הכנסה משוערת, או הכנסה נטו, שמשלבת את החלק שלכם בבעלות ובהסכמי חלוקת ההכנסות.
- עלות לאלף חשיפות (לשעבר
impressionBasedCpm
) - ההכנסה המשוערת ברוטו לכל אלף חשיפות של מודעות.
- adImpressions (לשעבר
impressions
) - מספר החשיפות המאומתות של מודעות שהוצגו.
- monetizedPlaybacks
- מספר הפעמים שבהן צופה הפעיל את הסרטון שלך ונרשמה לו לפחות חשיפה אחת של מודעה. הפעלה שעברה מונטיזציה נספרת אם לצופה מוצגת מודעה לפני סרטון, אבל הפסיק לצפות במודעה לפני שהסרטון מתחיל. השגיאה המשוערת הצפויה עבור הנתון הזה היא ±2.0%.
- playbackBasedCpm
- ההכנסה המשוערת ברוטו לכל אלף הפעלות.