במסמך הזה מוגדרים המדדים שה-Reporting API של YouTube מאחזר. ה-API הזה מאחזר דוחות על נתונים בכמות גדולה שמכילים נתונים מ-YouTube Analytics עבור ערוץ או בעלי תוכן.
מדדים הם מדדים ספציפיים של פעילות המשתמשים, ביצועי המודעות או הכנסות משוערות. מדדי פעילות המשתמשים כוללים ספירות של צפיות בסרטונים ודירוגים שלהם (לייקים ודיסלייקים).
מדדי ליבה
ממשק Reporting API של YouTube כפוף למדיניות ההוצאה משימוש שמוגדרת בתנאים ובהגבלות, אבל מדדים שאינם ליבה (ומאפיינים שאינם שירותי ליבה) אינם כפופים למדיניות. בהגדרות שבדף הזה, כל מדד שהוא מדד ראשי מזוהה באופן מפורש ככזה.
ברשימה הבאה מפורטים מדדי הליבה של ה-API. כל אחד מהמדדים האלה, המשמש גם ב-API של YouTube Analytics, הוא ערך ליבה גם הוא באותו ממשק API.
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
למידע נוסף, תוכלו לעיין ברשימה של ממשקי ה-API של YouTube בכפוף למדיניות ההוצאה משימוש.
הצגת המדדים
- צפיות (מדד ליבה)
- מספר הצפיות בסרטון. בדוח של פלייליסט, המדד מציין את מספר הפעמים שמשתמשים צפו בסרטון בהקשר של פלייליסט. במרכז העזרה של YouTube יש מידע נוסף על אופן הדיווח על צפיות. This is a core metric and is subject to the Deprecation Policy.
- red_views
- מספר הצפיות בסרטון ב-YouTube Premium (לשעבר YouTube Premium).
- views_percentage (מדד ליבה)
- אחוז הצופים שהיו מחוברים בזמן הצפייה בסרטון או בפלייליסט. This is a core metric and is subject to the Deprecation Policy.
ערכים של זמן צפייה
- watch_time_minutes (מדד ליבה)
- מספר הדקות שמשתמשים צפו בסרטונים בערוץ, בבעלי התוכן, בסרטון או בפלייליסט שצוינו. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- מספר הדקות שמנויי YouTube Premium (לשעבר YouTube Red) צפו בסרטון.
- Avg_view_duration_seconds (מדד ליבה)
- האורך הממוצע, בשניות, של הפעלות סרטונים. החל מ-13 בדצמבר 2021, המדד הזה לא כולל תנועה של קליפים מוצגים. בדוח של פלייליסט, המדד מציין את משך הזמן הממוצע, בשניות, של הפעלות סרטונים שהתרחשו בהקשר של פלייליסט. This is a core metric and is subject to the Deprecation Policy.
- Avg_view_duration_percentage
- האחוז הממוצע של סרטון שנצפה במהלך הפעלת סרטון. החל מ-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. - subscribers_earned (מדד ליבה)
- מספר הפעמים שמשתמשים נרשמו כמנויים לערוץ. This is a core metric and is subject to the Deprecation Policy.
ערוצים יכולים לצבור או לאבד מנויים בכמה מקומות, כולל בדף הצפייה של הסרטון, בדף הערוץ ובמדריך שמופיע בדף הבית של YouTube. כדי לזהות את מספר המנויים החדשים לערוץ שלא נרשמו באמצעות דף צפייה של סרטון, דוח פעילות בסיסית של משתמש מכיל שורה ללא ציון של ערך המאפיין video_id. השורה הזו גם מציינת ערך של המדדsubscribersLost
, אבל לא מציינת ערכים של מדדים אחרים. - subscribers_lost (מדד ליבה)
- מספר הפעמים שמשתמשים ביטלו את ההרשמה לערוץ. This is a core metric and is subject to the Deprecation Policy.
הנתונים של המדד הזה מדווחים באופן דומה לערך שלsubscribers_gained
. כדי לזהות את מספר המשתמשים שביטלו את ההרשמה אבל לא ביטלו את ההרשמה שלהם לדף הצפייה של הסרטון, דוח הפעילות הבסיסי של המשתמש מכיל שורה שלא מציינת ערך של מאפיין video_id. השורה הזו גם מציינת ערך של המדדsubscribers_gained
, אבל לא מציינת ערכים של מדדים אחרים. - videos_added_to_playlists
- מספר הפעמים שסרטונים נוספו לפלייליסטים כלשהם של YouTube. ייתכן שהסרטונים נוספו לפלייליסט של בעלי הסרטון או לפלייליסטים של ערוצים אחרים.
ערך המדד כן כולל את מספר הפעמים שהסרטונים נוספו לפלייליסטים המוגדרים כברירת מחדל, למשל הפלייליסט 'לצפייה בהמשך'. עם זאת, המערכת לא סופרת פלייליסטים שסרטון נוסף אליהם באופן אוטומטי, למשל פלייליסט של סרטון שהועלה לערוץ או היסטוריית צפייה של המשתמש.
המדד הזה מחזיר מספר מוחלט, כלומר אם המשתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, ערך המדד משקף את הסרטון שמתווסף לפלייליסט פעמיים. נתונים על המדד הזה לא זמינים לתאריכים לפני 1 באוקטובר 2014. - videos_removed_from_playlists
- מספר הפעמים שסרטונים הוסרו מכל פלייליסטים של YouTube. יכול להיות שהסרטונים הוסרו מהפלייליסט של בעלי הסרטון או מפלייליסטים של ערוצים אחרים.
ערך המדד כולל את מספר הפעמים שסרטונים הוסרו מפלייליסטים שהוגדרו כברירת מחדל, למשל הפלייליסט 'לצפייה במועד מאוחר יותר'.
המדד הזה מחזיר מספר מוחלט, כך שאם משתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, ערך המדד משקף את הסרטון שהוסר פעמיים מהפלייליסט. נתונים על המדד הזה לא זמינים לתאריכים לפני 1 באוקטובר 2014.
מדדים של פלייליסטים
- playlist_starts
- מספר הפעמים שהצופים יזמו הפעלה של פלייליסט. לתשומת ליבכם: המדד הזה כולל רק צפיות בפלייליסט שהתרחשו באינטרנט.
- playlist_saves_added (נתמכת רק ב-YouTube Reporting API)
- מספר הפעמים שמשתמשים שמרו פלייליסט. תוכלו לבקר במרכז העזרה של YouTube כדי לקבל מידע נוסף על פלייליסטים ששמרתם. המדד הזה מחזיר מספר מוחלט. כלומר, אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים ושומר אותו שוב, ערך המדד משקף שתי שמירה של פלייליסט.
- playlist_saves_removed (נתמך רק ב-YouTube Reporting API)
- מספר הפעמים שמשתמשים הסירו את הפלייליסט מרשימת הפלייליסטים השמורים שלהם. ערך זה מחזיר מספר מוחלט, כלומר אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים, שומר אותו שוב ומסיר אותו שוב, הערך של המדד משקף שתי שמירות של פלייליסט שהוסרו.
מדדים של הערות
- annotation_impression
- המספר הכולל של חשיפות של הערות.
- annotation_clickable_impressions
- מספר ההערות שהופיעו שניתן היה ללחוץ עליהן.
- annotation_clicks
- מספר ההערות שלחצו עליהן.
- annotation_click_through_rate (מדד ליבה)
- היחס בין הערות שהצופים לחצו עליהן לבין המספר הכולל של חשיפות של הערות שניתן ללחוץ עליהן. This is a core metric and is subject to the Deprecation Policy. במרכז העזרה של YouTube אפשר למצוא מידע נוסף על יצירת הערות ועל שימוש בהערות קישורים.
- annotation_closable_impressions
- מספר ההערות שהופיעו וייתכן שניתן לסגור אותן.
- annotation_closed
- מספר ההערות הסגורות.
- annotation_close_rate (מדד ליבה)
- היחס בין הערות שהצופים סגרו למספר הכולל של חשיפות של הערות. This is a core metric and is subject to the Deprecation Policy.
מדדי הכרטיס
במרכז העזרה של YouTube תמצאו הוראות מפורטות יותר להוספת כרטיסים לסרטונים ולדוח 'כרטיסי YouTube Analytics'.
- card_impression
- מספר הפעמים שהכרטיסים הוצגו. כשחלונית הכרטיסים נפתחת, חשיפה של כרטיס נרשמת לכל אחד מהכרטיסים של הסרטון.
- card_clicks
- מספר הפעמים שלחצו על הכרטיסים.
- card_click_rate
- שיעור הקליקים על כרטיסים, שמחושב כיחס בין הקליקים על כרטיסים לבין החשיפות של כרטיסים.
- מספר הפעמים שבהן הוצגו טיזרים של כרטיסים. צפייה בווידאו יכולה ליצור מספר חשיפות של טיזר.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל הכרטיס מיוחסים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים של כרטיסים, והוא מחושב כיחס בין הקליקים על טיזרים של כרטיסים למספר הכולל של חשיפות טיזרים של כרטיסים.
מדדי מסך סיום
מסכי סיום הם רכיבים שמוצגים במהלך 5 עד 20 השניות האחרונות של הסרטון כדי לקדם את התוכן, הערוץ והאתרים שלכם. במרכז העזרה של YouTube תמצאו הוראות מפורטות יותר להוספת מסכי סיום לסרטונים ולדוח על מסכי הסיום ב-YouTube Analytics.
הערה: הנתונים של מדדי מסך הסיום זמינים החל מ-1 במאי 2016.
- end_screen_element_impressions
- מספר הרכיבים במסך הסיום שהוצגו. חשיפה אחת מתועדת עבור כל רכיב מסך סיום שמוצג.
- end_screen_element_clicks
- מספר הפעמים שלחצו על רכיבים של מסך סיום.
- end_screen_element_click_rate
- שיעור הקליקים של רכיבי מסך הסיום, והוא מחושב כיחס בין הקליקים על רכיבי מסך הסיום לבין החשיפות של רכיבי מסך סיום.
מדדי שימור קהל
- audience_retention_percentage
- היחס המוחלט של צופים שצפו בסרטון בנקודת זמן מסוימת בסרטון. היחס מחושב על ידי השוואת מספר הפעמים שבהן חלק מהסרטון נצפה למספר הצפיות הכולל של הסרטון. המאפיין
elapsed_video_time_percentage
מזהה את החלק בסרטון שהמדד תואם לו.
לידיעתכם, בסרטון מסוים אפשר לראות יותר מפעם אחת (או בכלל לא). לדוגמה, אם המשתמשים מריצים את הסרטון לאחור וצופים בו שוב ושוב מספר פעמים, היחס המוחלט עבור אותו חלק של הסרטון יכול להיות גדול מ-1
.
הדוגמאות הבאות ממחישות איך הערך מחושב:- סרטון באורך דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות, ושאר הצופים צופים בסרטון כולו. אף אחד מהצופים לא צופה בחלקים מהסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
1
עבור קטגוריות זמן ברבעון הראשון של הסרטון, וערך יהיה0.50
עבור המשך הסרטון. - סרטון באורך דקה נצפה 100 פעמים. כל הצופים צופים בסרטון כולו, אבל 20 מהצופים צופים עד לסמן 45 השניות של הסרטון, לאחר מכן מדלגים לסימן 30 השניות, ולאחר מכן צופים בשאר הסרטון. במקרה הזה, הערך של המדד יהיה
1
עבור קטגוריות הזמן במחצית הראשונה או ברבע האחרון של הסרטון. עם זאת, הערך יהיה1.2
עבור קטגוריות זמן ברבעון השלישי של הסרטון, מאחר ש-100 אחוזים מהצופים צפו בפלח זה של הסרטון, אך 20% מהצופים צפו בפלח פעמיים.
- סרטון באורך דקה נצפה 100 פעמים. מחצית מהצופים מפסיקים לצפות אחרי 15 שניות, ושאר הצופים צופים בסרטון כולו. אף אחד מהצופים לא צופה בחלקים מהסרטון יותר מפעם אחת. במקרה הזה, הערך של המדד הזה יהיה
מדדי הכנסות משוערות
הערה: מדדי ההכנסה המשוערת כפופים להתאמות בסוף החודש, ואינם כוללים פרסום שנמכר על ידי שותפים או שמוצג על ידי שותפים. תוכלו לעיין במרכז העזרה של YouTube כדי לקבל מידע נוסף והערות בנוגע לנתוני ההכנסות המשוערות.
- estimated_partner_Revenue (מדד ליבה)
- סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google וגם ממקורות שאינם מפרסמים בטווח התאריכים ובאזור שנבחרו.
- estimated_partner_ad_Revenue
- אומדן סך ההכנסות נטו מכל מקורות הפרסום שנמכרו על ידי Google בטווח התאריכים ובאזור שנבחרו.
מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, ואינם כוללים פרסום שנמכר על ידי שותפים או מודעות שהוצגו על ידי שותפים. - estimated_partner_ad_auction_Revenue (נתמך רק בממשק API לדיווח של YouTube)
- סך כל הרווחים המשוערים (הכנסות נטו) מפרסום שנמכר במכירה פומבית דרך AdSense בטווח התאריכים ובאזור שנבחרו. המדד הזה נקרא בעבר
estimated_partner_ad_sense_revenue
. - estimated_partner_ad_sense_Revenue (תמיכה רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (הכנסות נטו) מפרסום ב-AdSense שנמכרו במכרזים, באזור ובטווח התאריכים שנבחרו.
- estimated_partner_ad_reserving_Revenue (נתמך רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (הכנסות נטו) מפרסום שמור שנמכר דרך DoubleClick (DCLK) וממקורות אחרים שנמכרו על ידי YouTube. המדד הזה נקרא בעבר
estimated_partner_double_click_revenue
. - estimated_partner_double_click_Revenue (תמיכה רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (הכנסות נטו) מפרסום שמור שנמכר דרך DoubleClick (DCLK) ומקורות אחרים שנמכרו על ידי YouTube.
- estimated_partner_red_Revenue (תמיכה רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (נטו) ממינויים של YouTube Premium (לשעבר YouTube Red).
- estimated_partner_transaction_Revenue (נתמך רק ב-YouTube Reporting API)
- סך כל ההכנסות המשוערות מעסקאות, כגון תוכן בתשלום ומימון על ידי מעריצים, בניכוי החזרים כספיים שחויבו על ידי שותפים.
מדדי ביצועים של מודעות
- estimated_youtube_ad_Revenue
- ההכנסות המשוערות המשוערות, בדולר ארה"ב, מכל הפרסום שנמכר על ידי Google או שותף שנמכר על ידי DoubleClick עבור האזור וטווח התאריכים שנבחרו. ההכנסות ברוטו כפופות להתאמות בסוף החודש, ואינן כוללות מודעות שהוצגו על ידי שותפים. חשוב להבחין בין הכנסה ברוטו לבין הכנסה נטו, או הכנסה נטו, הכוללת את החלק שלך בבעלות ובהסכמי חלוקת הכנסות.
- estimated_cpm
- אומדן ההכנסות המשוערות לאלף חשיפות של מודעה.
- ad_impression
- מספר החשיפות של מודעות מאומתות.
- estimated_monetized_playbacks
- מספר הפעמים שבהן צופה הפעיל את הסרטון שלך והוצגה לו לפחות חשיפה אחת של מודעה. 'סרטונים שמכילים מודעות' נספרים אם הצופה רואה מודעה לפני סרטון, אבל מפסיק לצפות במודעה לפני שהסרטון מתחיל. הנתון המשוער לשגיאה עבור המספר הזה הוא ±2.0%.
- estimated_playback_based_cpm
- אומדן ההכנסות המשוערות לאלף הפעלות.