במסמך הזה מוגדרים המדדים שאפשר לאחזר באמצעות 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, המדד הזה לא כולל תנועה של סרטונים חוזרים.
מדדי התעניינות
- תגובות (מדד מרכזי)
- מספר הפעמים שמשתמשים הגיבו על סרטון. מידע נוסף זמין במרכז העזרה של 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.
מדדים של פלייליסטים
דוחות הפלייליסטים כוללים שני סוגים של מדדים שמסבירים איך הצופים מנהלים אינטראקציה עם הסרטונים בפלייליסט:
-
מדדי סרטונים מצטברים מספקים מדדים של פעילות משתמשים וחשיפות שמצטברים עבור כל הסרטונים בפלייליסט, שהערוץ שבבעלותו הפלייליסט הוא גם הבעלים שלהם. המדדים של סרטונים בבעלות של ערוצים אחרים לא מחושבים בצבירה. לכן, אם בערוץ מסוים נוצר פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, בדוחות של הפלייליסטים האלה לא יוצגו ערכים למדדים האלה.
בקטעים מדדי צפייה ומדדי זמן צפייה במסמך הזה מופיעות הגדרות של מדדים מצטברים נתמכים של סרטונים.
-
מדדי פלייליסט משקפים את פעילות המשתמש והמעורבות בהקשר של דף הפלייליסט. המדדים האלה כוללים צפיות בכל הסרטונים בפלייליסט, לא משנה באיזה ערוץ הם נמצאים, אבל הם סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
רוב המדדים הבאים הם מדדים שקשורים לפלייליסט. המדדים שנותרו ברשימה, כמו המדד 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
- ההכנסה המשוערת ברוטו לאלף הפעלות.