מסמך זה מגדיר את הערכים שניתן לאחזר באמצעות ממשק ה-API של YouTube Analytics. ה-API הזה תומך בשאילתות בזמן אמת כדי ליצור דוחות YouTube Analytics בהתאמה אישית.
מדדים הם מדדים ספציפיים של פעילות המשתמשים, ביצועי המודעות או הכנסות משוערות. מדדי פעילות המשתמשים כוללים ספירות של צפיות בסרטונים ודירוגים שלהם (לייקים ודיסלייקים).
מדדי ליבה
למרות ש-YouTube Analytics API כפוף למדיניות ההוצאה משימוש המוגדרת בתנאים ובהגבלות, מדדים שאינם שירותי ליבה (ומאפיינים שאינם שירותי ליבה) אינם כפופים למדיניות. בהגדרות שבדף הזה, כל מדד שהוא מדד ראשי מזוהה באופן מפורש ככזה.
ברשימה הבאה מפורטים מדדי הליבה של ה-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. ניתן לאחזר את המדדים האלה רק דרך YouTube Analytics API.
למידע נוסף, תוכלו לעיין ברשימה של ממשקי ה-API של YouTube בכפוף למדיניות ההוצאה משימוש.
הצגת המדדים
- צפיות (מדד ליבה)
- מספר הצפיות בסרטון. בדוח של פלייליסט, המדד מציין את מספר הפעמים שמשתמשים צפו בסרטון בהקשר של פלייליסט. במרכז העזרה של YouTube יש מידע נוסף על אופן הדיווח על צפיות. This is a core metric and is subject to the Deprecation Policy.
- צפיות
- מספר הצפיות בסרטון ב-YouTube Premium (לשעבר YouTube Premium).
- ייחודיים (הוצא משימוש ב-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) צפו בסרטון.
- maxViewDuration (מדד ליבה)
- האורך הממוצע, בשניות, של הפעלות סרטונים. החל מ-13 בדצמבר 2021, המדד הזה לא כולל תנועה של קליפים מוצגים. בדוח של פלייליסט, המדד מציין את משך הזמן הממוצע, בשניות, של הפעלות סרטונים שהתרחשו בהקשר של פלייליסט. This is a core metric and is subject to the Deprecation Policy.
- AvgViewPercentage
- האחוז הממוצע של סרטון שנצפה במהלך הפעלת סרטון. החל מ-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. - משתמשים רשומים שנוספו (מדד ליבה)
- מספר הפעמים שמשתמשים נרשמו כמנויים לערוץ. 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
כדי להגביל את התגובה כך שתכלול נתונים רק לגבי סרטון מסוים, המדד הזה כולל רק משתמשים שביטלו את ההרשמה לדף הצפייה של הסרטון שצוין. - סרטונים שנוספו לפלייליסטים
- מספר הפעמים שסרטונים נוספו לפלייליסטים כלשהם של YouTube. ייתכן שהסרטונים נוספו לפלייליסט של בעלי הסרטון או לפלייליסטים של ערוצים אחרים.
ערך המדד כן כולל את מספר הפעמים שהסרטונים נוספו לפלייליסטים המוגדרים כברירת מחדל, למשל הפלייליסט 'לצפייה בהמשך'. עם זאת, המערכת לא סופרת פלייליסטים שסרטון נוסף אליהם באופן אוטומטי, למשל פלייליסט של סרטון שהועלה לערוץ או היסטוריית צפייה של המשתמש.
המדד הזה מחזיר מספר מוחלט, כלומר אם המשתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, ערך המדד משקף את הסרטון שמתווסף לפלייליסט פעמיים. נתונים על המדד הזה לא זמינים לתאריכים לפני 1 באוקטובר 2014. - סרטונים שהוסרו מפלייליסטים
- מספר הפעמים שסרטונים הוסרו מכל פלייליסטים של YouTube. יכול להיות שהסרטונים הוסרו מהפלייליסט של בעלי הסרטון או מפלייליסטים של ערוצים אחרים.
ערך המדד כולל את מספר הפעמים שסרטונים הוסרו מפלייליסטים שהוגדרו כברירת מחדל, למשל הפלייליסט 'לצפייה במועד מאוחר יותר'.
המדד הזה מחזיר מספר מוחלט, כך שאם משתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, ערך המדד משקף את הסרטון שהוסר פעמיים מהפלייליסט. נתונים על המדד הזה לא זמינים לתאריכים לפני 1 באוקטובר 2014.
מדדי מעורבות שהוצאו משימוש
המדדים הבאים היו שני מדדי ליבה שהוצאו משימוש ב-31 במרץ 2015.
- favoritesAdded (מדד ליבה) (יצא משימוש ב-31 במרץ 2015)
- מספר הפעמים שמשתמשים סימנו סרטון כסרטון מועדף. במרכז העזרה של YouTube תוכלו למצוא מידע נוסף. This is a core metric and is subject to the Deprecation Policy.
- favorites removed (מדד ליבה) (יצא משימוש ב-31 במרץ 2015)
- מספר הפעמים שמשתמשים הסירו סרטון מרשימת הסרטונים האהובים עליהם. במרכז העזרה של YouTube תוכלו למצוא מידע נוסף. This is a core metric and is subject to the Deprecation Policy.
מדדים של פלייליסטים
- playlistStarts
- מספר הפעמים שהצופים יזמו הפעלה של פלייליסט. לתשומת ליבכם: המדד הזה כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
- צפיות ב-PerPlaylistStart
- המספר הממוצע של צפיות בסרטונים שהתרחשו בכל פעם שפלייליסט הופעל. לתשומת ליבכם: המדד הזה כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
- AvgTimeInPlaylist
- משך הזמן הממוצע המשוער (בדקות) שבמהלכו אנשים צפו בסרטונים בפלייליסט. לתשומת ליבכם: המדד הזה כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
מדדים של הערות
הערה: דוחות YouTube Analytics API מחזירים נתונים רק לגבי המדדים annotationClickThroughRate
ו-annotationCloseRate
החל מ-10 ביוני 2012. בנוסף, דוחות YouTube Analytics API מחזירים נתונים רק לגבי מדדי ההערות שנותרו החל מ-16 ביולי 2013.
- חשיפות של הערות
- המספר הכולל של חשיפות של הערות.
- annotationClickable Impressions
- מספר ההערות שהופיעו שניתן היה ללחוץ עליהן.
- annotationClicks
- מספר ההערות שלחצו עליהן.
- annotationClickthroughRate (מדד ליבה)
- היחס בין הערות שהצופים לחצו עליהן לבין המספר הכולל של חשיפות של הערות שניתן ללחוץ עליהן. This is a core metric and is subject to the Deprecation Policy. במרכז העזרה של YouTube אפשר למצוא מידע נוסף על יצירת הערות ועל שימוש בהערות קישורים.
- annotationClosableחשיפות
- מספר ההערות שהופיעו וייתכן שניתן לסגור אותן.
- annoteationCloses
- מספר ההערות הסגורות.
- annotationCloseRate (מדד ליבה)
- היחס בין הערות שהצופים סגרו למספר הכולל של חשיפות של הערות. This is a core metric and is subject to the Deprecation Policy.
מדדי הכרטיס
במרכז העזרה של YouTube תמצאו הוראות מפורטות יותר להוספת כרטיסים לסרטונים ולדוח 'כרטיסי YouTube Analytics'.
- cardimpression
- מספר הפעמים שהכרטיסים הוצגו. כשחלונית הכרטיסים נפתחת, חשיפה של כרטיס נרשמת לכל אחד מהכרטיסים של הסרטון.
- cardClicks
- מספר הפעמים שלחצו על הכרטיסים.
- cardClickRate
- שיעור הקליקים על כרטיסים, שמחושב כיחס בין הקליקים על כרטיסים לבין החשיפות של כרטיסים.
- מספר הפעמים שבהן הוצגו טיזרים של כרטיסים. צפייה בווידאו יכולה ליצור מספר חשיפות של טיזר.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל הכרטיס מיוחסים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים של כרטיסים, והוא מחושב כיחס בין הקליקים על טיזרים של כרטיסים למספר הכולל של חשיפות טיזרים של כרטיסים.
מדדי שימור קהל
- audienceWatchRatio
- היחס המוחלט של צופים שצפו בסרטון בנקודת זמן מסוימת בסרטון. היחס מחושב על ידי השוואת מספר הפעמים שבהן חלק מהסרטון נצפה למספר הצפיות הכולל של הסרטון. המאפיין
elapsedVideoTimeRatio
מזהה את החלק בסרטון שהמדד תואם לו.
לידיעתכם, בסרטון מסוים אפשר לראות יותר מפעם אחת (או בכלל לא). לדוגמה, אם המשתמשים מריצים את הסרטון לאחור וצופים בו שוב ושוב מספר פעמים, היחס המוחלט עבור אותו חלק של הסרטון יכול להיות גדול מ-1
.
הדוגמאות הבאות ממחישות איך הערך מחושב:- סרטון באורך דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות, ושאר הצופים צופים בסרטון כולו. אף אחד מהצופים לא צופה בחלקים מהסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
1
עבור קטגוריות זמן ברבעון הראשון של הסרטון, וערך יהיה0.50
עבור המשך הסרטון. - סרטון באורך דקה נצפה 100 פעמים. כל הצופים צופים בסרטון כולו, אבל 20 מהצופים צופים עד לסמן 45 השניות של הסרטון, לאחר מכן מדלגים לסימן 30 השניות, ולאחר מכן צופים בשאר הסרטון. במקרה הזה, הערך של המדד יהיה
1
עבור קטגוריות הזמן במחצית הראשונה או ברבע האחרון של הסרטון. עם זאת, הערך יהיה1.2
עבור קטגוריות זמן ברבעון השלישי של הסרטון, מאחר ש-100 אחוזים מהצופים צפו בפלח זה של הסרטון, אך 20% מהצופים צפו בפלח פעמיים.
- סרטון באורך דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות, ושאר הצופים צופים בסרטון כולו. אף אחד מהצופים לא צופה בחלקים מהסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
- ביצועים יחסיים של שימור משתמשים
- מדידה שמראה עד כמה הסרטון מצליח לשמר את רמת העניין של הצופים במהלך הפעלות, בהשוואה לכל סרטוני YouTube שהם באורך דומה. המדד כולל ערך בין
0
ל-1
שמזהה את ביצועי השימור היחסי של הסרטון בנקודת זמן נתונה. הנקודה בסרטון מסופקת על ידי המאפייןelapsedVideoTimeRatio
.
ערך של0
מציין שהסרטון שומר על דירוג נמוך יותר בהשוואה לכל סרטון אחר באורך דומה, ואילו ערך של1
מציין שהסרטון שומר על הצופים טוב יותר מכל סרטון אחר באורך דומה. ערך חציוני של0.5
מציין שמחצית מהסרטונים באורך דומה משמרים את הצופים בצורה טובה יותר, בעוד שמחצית מהסרטונים משאירים את הצופים במצב גרוע יותר.
בדוגמה ההיפותטית הבאה אפשר לראות איך הערכים עשויים להופיע בדוח. בממוצע, 90 אחוזים מהצופים שצופים בסרטונים באורך 10 דקות עדיין צפו לאחר שלוש דקות ו-70 אחוזים עדיין צפו לאחר שמונה דקות. עם זאת, בסרטון ספציפי באורך 10 דקות, רק 80 אחוזים מהצופים עדיין צפו לאחר שלוש דקות, אך כל הצופים עדיין צפו לאחר שמונה דקות.- בערך
elapsedVideoTimeRatio
שתואם לנקודה של שלוש דקות בסרטון, הערך שלrelativeRetentionPerformance
יהיה נמוך מ-0.5
כי באותו זמן, הביצועים של הסרטון נמוכים יותר מאלה של הסרטון הממוצע. - בערך
elapsedVideoTimeRatio
המתאים לנקודה של שמונה דקות מתוך הסרטון, המדדrelativeRetentionPerformance
יהיה בעל ערך גבוה מ-0.5
, כי באותו זמן ביצועי הסרטון טובים יותר משל סרטונים אחרים באורך דומה.
- בערך
מדדי הכנסות משוערות
הערה: מדדי ההכנסה המשוערת כפופים להתאמות בסוף החודש, ואינם כוללים פרסום שנמכר על ידי שותפים או שמוצג על ידי שותפים. תוכלו לעיין במרכז העזרה של YouTube כדי לקבל מידע נוסף והערות בנוגע לנתוני ההכנסות המשוערות.
currency
עבור ערכים משוערים של הכנסות וביצועי מודעות, וכך אתם יכולים לאחזר נתוני הכנסות משוערות במטבעות אחרים.- estimatedהכנסות (מדד הליבה) (נקרא בעבר
earnings
) - סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google וגם ממקורות שאינם מפרסמים בטווח התאריכים ובאזור שנבחרו.
This is a core metric and is subject to the Deprecation Policy.
מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, ואינם כוללים פרסום שנמכר על ידי שותפים או שמוצג על ידי שותפים.
- estimatedAdRevenue (לשעבר
adEarnings
) - אומדן סך ההכנסות נטו מכל מקורות הפרסום שנמכרו על ידי Google בטווח התאריכים ובאזור שנבחרו.
מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, ואינם כוללים פרסום שנמכר על ידי שותפים או מודעות שהוצגו על ידי שותפים. - estimatedRedPartnerRevenue (נקרא בעבר
redPartnerRevenue
) - ההכנסות המשוערות הכוללות ממינויים של YouTube Premium (לשעבר YouTube Premium) עבור מאפייני הדוח שנבחרו. ערך המדד משקף הכנסות הן מתכני מוזיקה והן מתכנים שאינם מוזיקה, והוא כפוף להתאמות בסוף החודש.
מדדי ביצועים של מודעות
- GrossRevenue
- ההכנסות המשוערות המשוערות, בדולר ארה"ב, מכל הפרסום שנמכר על ידי Google או שותף שנמכר על ידי DoubleClick עבור האזור וטווח התאריכים שנבחרו. ההכנסות ברוטו כפופות להתאמות בסוף החודש, ואינן כוללות מודעות שהוצגו על ידי שותפים. חשוב להבחין בין הכנסה ברוטו לבין הכנסה נטו, או הכנסה נטו, הכוללת את החלק שלך בבעלות ובהסכמי חלוקת הכנסות.
- עלות לאלף חשיפות (לשעבר
impressionBasedCpm
) - אומדן ההכנסות המשוערות לאלף חשיפות של מודעה.
- adimpression (לשעבר
impressions
) - מספר החשיפות של מודעות מאומתות.
- הפעלות מונטיזציה
- מספר הפעמים שבהן צופה הפעיל את הסרטון שלך והוצגה לו לפחות חשיפה אחת של מודעה. 'סרטונים שמכילים מודעות' נספרים אם הצופה רואה מודעה לפני סרטון, אבל מפסיק לצפות במודעה לפני שהסרטון מתחיל. הנתון המשוער לשגיאה עבור המספר הזה הוא ±2.0%.
- playbackBasedCpm
- אומדן ההכנסות המשוערות לאלף הפעלות.