במסמך הזה מוגדרים המדדים שאפשר לאחזר באמצעות YouTube Analytics API. ה-API הזה תומך בשאילתות בזמן אמת כדי ליצור דוחות YouTube Analytics בהתאמה אישית.
מדדים הם מדידות ספציפיות של פעילות משתמש, ביצועי מודעות או הכנסה משוערת. מדדי פעילות המשתמשים כוללים נתונים כמו מספר הצפיות בסרטונים ודירוגים (לייקים ודיסלייקים).
מדדים עיקריים
YouTube Analytics API כפוף למדיניות ההוצאה משימוש שמוגדרת בתנאים ובהגבלות, אבל מדדים לא מרכזיים (ומאפיינים לא מרכזיים) לא כפופים למדיניות הזו. בהגדרות שבדף הזה, כל מדד שהוא מדד ליבה מזוהה במפורש ככזה.
ברשימה הבאה מפורטים מדדי הליבה של ה-API.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
מידע נוסף זמין ברשימת ממשקי ה-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, המדד הזה לא כולל תנועה מקליפים בלופ.
מדדי התעניינות
- comments (מדד ליבה)
- מספר הפעמים שמשתמשים הגיבו על סרטון. מידע נוסף זמין במרכז העזרה של 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
- המספר הממוצע של צפיות בסרטונים בכל פעם שפלייליסט הופעל. שימו לב שהמדד הזה כולל רק צפיות בפלייליסטים שהתרחשו באינטרנט.
מדדי הערות
הערה: דוחות של YouTube Analytics API מחזירים נתונים רק לגבי המדדים annotationClickThroughRate ו-annotationCloseRate החל מ-10 ביוני 2012. בנוסף, הדוחות של 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
- שיעור הקליקים (CTR) של כרטיסים, שמחושב לפי היחס בין הקליקים על הכרטיסים לבין החשיפות של הכרטיסים.
- מספר הפעמים שהטיזרים של הכרטיסים הוצגו. צפייה אחת בסרטון יכולה להניב כמה חשיפות של טיזרים.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל הכרטיס משויכים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים בכרטיסים, שמחושב כיחס בין הקליקים על טיזרים בכרטיסים לבין המספר הכולל של החשיפות של טיזרים בכרטיסים.
מדדים של שידור חי (צופים בו-זמנית)
- 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
- ההכנסה המשוערת ברוטו לכל אלף הפעלות.