במסמך הזה מוגדרים המדדים שאפשר לאחזר באמצעות YouTube Analytics API. ה-API הזה תומך בשאילתות בזמן אמת כדי ליצור דוחות YouTube Analytics בהתאמה אישית.
מדדים הם מדידות נפרדות של פעילות המשתמשים, ביצועי המודעות או הכנסות משוערות. מדדי פעילות המשתמשים כוללים נתונים כמו מספר הצפיות בסרטונים והדירוגים (לייקים ודיסלייקים).
מדדים עיקריים
אמנם, ה-API של YouTube Analytics כפוף למדיניות הוצאה משימוש שמוגדרת בתנאים ובהגבלות, אבל מדדים שאינם מרכזיים (וגם מאפיינים שאינם מרכזיים) לא כפופים למדיניות הזו. בהגדרות שבדף הזה, כל מדד שהוא מדד ליבה מזוהה במפורש כמדד ליבה.
הרשימה הבאה מפרטת את מדדי הליבה של ה-API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
engagedViews
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
מידע נוסף זמין ברשימת ממשקי ה-API של YouTube שחלים עליהם כללי המדיניות בנושא הוצאה משימוש.
הצגת המדדים
- engagedViews (מדד ליבה)
- מספר הפעמים שהצופים המשיכו לצפות בסרטונים בערוץ אחרי השניות הראשונות.
- צפיות (מדד מרכזי)
- המדד הזה מייצג מספרים שונים בסוגים שונים של דוחות.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- המדד הזה מוגדר בקטע מדדים של פלייליסטים.
- redViews
- מספר הפעמים שמנויי YouTube Premium (שנקרא בעבר YouTube Red) צפו בסרטון.
- 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.
- dislikes (מדד ליבה)
- מספר הפעמים שמשתמשים ציינו שהם לא אהבו סרטון מסוים בכך שהם נתנו לסרטון דירוג שלילי. 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.
מדדים של פלייליסטים
דוחות הפלייליסטים כוללים שני סוגים של מדדים שמסבירים איך הצופים מנהלים אינטראקציה עם הסרטונים בפלייליסט:
-
מדדי סרטונים מצטברים מספקים מדדים של פעילות משתמשים וחשיפות שמצטברים עבור כל הסרטונים בפלייליסט, שהם גם בבעלות הערוץ שבבעלותו הפלייליסט. המדדים של סרטונים בבעלות של ערוצים אחרים לא מחושבים בצבירה. כתוצאה מכך, אם בערוץ מסוים נוצר פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, בדוחות של הפלייליסטים האלה לא יופיעו ערכים למדדים האלה.
בקטעים מדדי צפייה ומדדי זמן צפייה במסמך הזה מופיעות הגדרות של מדדי וידאו מצטברים נתמכים.
-
המדדים בפלייליסט משקפים את הפעילות וההתעניינות של המשתמשים בהקשר של דף הפלייליסט. המדדים האלה כוללים צפיות בכל הסרטונים בפלייליסט, לא משנה באיזה ערוץ הם מתפרסמים, אבל הם סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
רוב המדדים הבאים הם מדדים שקשורים לפלייליסט. המדדים שנותרו ברשימה, כמו המדד playlistSaves
, קשורים לאינטראקציות של המשתמשים עם הפלייליסט עצמו ולא עם הסרטונים בפלייליסט. לכן, המדדים האלה לא יוגדרו כמדדים מצטברים של סרטונים או כמדדים של פלייליסטים.
- averageTimeInPlaylist
- האומדן של משך הזמן הממוצע, בדקות, שבו צופים צפו בסרטונים בפלייליסט אחרי שהם התחילו לצפות בו. הערה: המדד הזה כולל רק צפיות בפלייליסטים שהתרחשו באינטרנט.
- playlistAverageViewDuration
- אורך הצפייה הממוצע המשוער בשניות בכל צפייה בפלייליסט. שימו לב שהמדד הזה
מייצג את האורך הממוצע של צפיות בסרטונים נפרדים בפלייליסט. לעומת זאת, המדד
averageTimeInPlaylist
מייצג את הזמן הממוצע שכל צופה מקדיש לצפייה בפלייליסט כולו. המדד הזה כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים. - playlistEstimatedMinutesWatched
- מספר הדקות שבהן המשתמשים צפו בתוכן של הפלייליסט כחלק מהפלייליסט. זמן צפייה שהתרחש בהקשרים אחרים – לדוגמה, זמן צפייה מצפיות שהתרחשו כשצופים צפו באותו סרטון כחלק מפלייליסטים אחרים – לא נספר. המדד הזה
כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים.
- playlistSaves
- מספר הפעמים שמשתמשים שמרו פלייליסט. מידע נוסף על פלייליסטים שמורים זמין במרכז העזרה של YouTube. המדד הזה מחזיר מספר של שינוי נטו. כלומר, אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים ושומר אותו שוב, ערך המדד ישקף הוספה של פלייליסט שמור אחד.
- playlistStarts
- מספר הפעמים שצופים יזמו הפעלה של פלייליסט. הערה: המדד הזה כולל רק צפיות בפלייליסטים שהתרחשו באינטרנט.
- playlistViews
- מספר הפעמים שצפו בסרטונים בפלייליסט בהקשר של הפלייליסט הזה.
המדד הזה כולל נתונים של סרטונים בפלייליסט שנמצאים בבעלות של ערוצים אחרים.
- viewsPerPlaylistStart
- המספר הממוצע של צפיות בסרטונים שהתרחשו בכל פעם שהופעל פלייליסט. הערה:
המדד הזה כולל רק צפיות בפלייליסטים שהתרחשו באינטרנט.
מדדי הערות
הערה: החל מ-10 ביוני 2012, דוחות של YouTube Analytics API מחזירים נתונים רק לגבי המדדים annotationClickThroughRate
ו-annotationCloseRate
. בנוסף, דוחות של YouTube Analytics API מחזירים נתונים רק לגבי מדדי ההערות שנותרו, החל מ-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
- שיעור הקליקים על כרטיסים, שמחושב כיחס בין הקליקים על כרטיסים לבין החשיפות של כרטיסים.
- מספר הפעמים שבהן הוצגו טיזרים של כרטיסים. צפייה בסרטון יכולה ליצור כמה חשיפות של טיזרים.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל כרטיס מיוחסים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים של כרטיסים, שמחושב כיחס בין הקליקים על טיזרים של כרטיסים לבין המספר הכולל של חשיפות של טיזרים של כרטיסים.
מדדים של שידור חי (מספר הצופים בו-זמנית)
- averageConcurrentViewers
- המספר הממוצע של צופים בו-זמנית בסרטון מסוים. אם המאפיין livestreamPosition
מוגדר בדוח, הערך
averageConcurrentViewers
מציין את המספר הממוצע של צופים בו-זמנית במהלך פלח מסוים - peakConcurrentViewers
- מספר הצופים המרבי בו-זמנית בסרטון מסוים. אם המאפיין livestreamPosition
מוגדר בדוח, הערך
peakConcurrentViewers
מציין את מספר הצופים המרבי בו-זמנית במהלך קטע מסוים בסרטון.
מדדי שימור קהל
- 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
, כלומר 8 דקות מתחילת הסרטון, הערך של המדדrelativeRetentionPerformance
יהיה גבוה יותר מהערך של0.5
, כי באותו זמן הביצועים של הסרטון טובים יותר מהביצועים של סרטונים אחרים באורך דומה.
- בנקודה שמתאימה לערך
- startedWatching
- מספר הפעמים שקטע מסוים בסרטון היה הקטע הראשון שנצפה במהלך הפעלת הסרטון.
לדוגמה, נניח שהסרטון X הוא באורך 5 דקות. לצורך הדוח הזה, מערכת YouTube מחלקת את הסרטון ל-100 פלחים של 3 שניות, שמזוהים באמצעות המאפיין elapsedVideoTimeRatio. משתמש נכנס ל-YouTube וצופה בדקה ועשר השניות הראשונות של הסרטון, שכוללות את כל 24 הקטעים הראשונים של הסרטון או חלק מהם. בביקור הבא ב-YouTube, הצופה צופה בשאר הסרטון, ממשיך את ההפעלה בקטע 24 וממשיך עד קטע 100.
בדוגמה הזו, הערכים של מדדי הצפייה יהיו:- הערך של המדד
startedWatching
יהיה1
עבור פלחים 1 ו-24, והערך של המדד יהיה0
עבור כל שאר הפלחים. - הערך של המדד
stoppedWatching
יהיה1
עבור פלחים 24 ו-100, והערך של המדד יהיה0
עבור כל שאר הפלחים. - הערך של המדד
totalSegmentImpressions
יהיה2
עבור פלח 24, והערך של המדד יהיה1
עבור כל שאר הפלחים.
- הערך של המדד
- stoppedWatching
- מספר הפעמים שקטע מסוים בסרטון היה הקטע האחרון שנצפה במהלך הפעלת הסרטון. אפשר לעיין בהגדרה של המדד
startedWatching
כדי לראות דוגמה לאופן החישוב של ערך המדד הזה. - totalSegmentImpressions
- מספר הפעמים שצפו בקטע מסוים בסרטון. אפשר לעיין בהגדרה של המדד
startedWatching
כדי לראות דוגמה לאופן החישוב של ערך המדד הזה. הערה: צופה יכול לצפות באותו קטע של סרטון כמה פעמים במהלך אותה הפעלה.
מדדים לגבי ביטולי מינויים
- membershipsCancellationSurveyResponses
- מספר הסקרים שהושלמו על ידי משתמשי YouTube שביטלו את החברות שלהם במועדון של הערוץ שצוין במהלך תקופת הדיווח.
מדדי הכנסה משוערת
הערה: מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, והם לא כוללים הכנסות מפרסום שנמכרו או הוצגו על ידי שותפים. מידע נוסף והערות לגבי נתוני ההכנסה המשוערת זמינים במרכז העזרה של 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 בטווח התאריכים ובאזור שנבחרו. ההכנסות ברוטו כפופות להתאמות בסוף החודש ולא כוללות הכנסות מפרסום שהוצגו על ידי שותפים. אין לבלבל בין הכנסה ברוטו לבין הכנסה משוערת או הכנסה נטו, שכוללת את חלקכם בבעלות ואת הסכמי חלוקת ההכנסות.
- cpm (לשעבר
impressionBasedCpm
) - ההכנסה המשוערת (ברוטו) לאלף חשיפות של מודעות.
- adImpressions (לשעבר
impressions
) - מספר החשיפות המאומתות של מודעות שהוצגו.
- monetizedPlaybacks
- מספר המקרים שבהם צופה הפעיל את הסרטון שלכם וראה לפחות חשיפה אחת של מודעה. צפייה שכללה מודעה נספרת אם מוצגת לצופה מודעה לפני סרטון, אבל הוא מפסיק לצפות במודעה לפני שהסרטון מתחיל. השגיאה המשוערת הצפויה לנתון הזה היא ±2.0%.
- playbackBasedCpm
- ההכנסה המשוערת ברוטו לכל אלף הפעלות.