במסמך הזה מוגדרים המדדים ש-YouTube Reporting API מאחזר. ה-API הזה מאחזר דוחות נתונים בכמות גדולה שמכילים נתונים מ-YouTube Analytics לגבי ערוץ או בעלי תוכן.
מדדים הם מדידות ספציפיות של פעילות משתמש, ביצועי מודעות או הכנסה משוערת. מדדי פעילות המשתמשים כוללים דברים כמו מספר הצפיות בסרטונים ודירוגים (לייקים ודיסלייקים).
מדדים עיקריים
YouTube Reporting API כפוף למדיניות ההוצאה משימוש שמוגדרת בתנאים ובהגבלות, אבל מדדים לא מהותיים (ומאפיינים לא מהותיים) לא כפופים למדיניות הזו. בהגדרות שבדף הזה, כל מדד שהוא מדד ליבה מזוהה במפורש ככזה.
ברשימה הבאה מפורטים מדדי הליבה של ה-API. כל אחד מהמדדים האלה שמשמשים גם ב-YouTube Analytics API הם גם מדדי ליבה ב-API הזה.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
מידע נוסף זמין ברשימת ממשקי ה-API של YouTube שכפופים למדיניות ההוצאה משימוש.
הצגת המדדים
- engaged_views (מדד ליבה)
- מספר הפעמים שבהן משתמשים צפו בסרטונים של הערוץ מעבר לפריים הראשון, או לחצו על הסרטון כדי להפעיל אותו.
- צפיות (מדד ליבה)
- מספר הפעמים שאנשים צפו בסרטון. בדוח פלייליסט, המדד מציין את מספר הפעמים שבהן אנשים צפו בסרטון בהקשר של פלייליסט. המדד הזה כולל צפיות משותפות כשכמה אנשים צופים יחד במסך טלוויזיה.
במרכז העזרה של YouTube מוסבר איך מתבצע הדיווח על הצפיות.
This is a core metric and is subject to the Deprecation Policy.
- red_views
- מספר הפעמים שסרטון נצפה על ידי מנויי YouTube Premium (לשעבר YouTube Red).
- views_percentage (מדד ליבה)
- אחוז הצופים שהיו מחוברים לחשבון בזמן הצפייה בסרטון או בפלייליסט. This is a core metric and is subject to the Deprecation Policy.
מדדי היקף החשיפה
- video_thumbnail_impressions
- מספר הפעמים שהתמונות הממוזערות של הסרטונים הוצגו לצופים. החשיפות נספרות אם התמונה הממוזערת הוצגה למשך יותר משנייה אחת, ואם לפחות 50% ממנה היו גלויים במסך. מידע נוסף זמין במרכז העזרה של YouTube.
- video_thumbnail_impressions_ctr
- אחוז החשיפות שהובילו לקליק לצפייה בסרטון. כדי לחשב את המדד הזה, המערכת מחלקת את מספר הקליקים במספר החשיפות.
מדדי זמן הצפייה
- watch_time_minutes (מדד ליבה)
- מספר הדקות שבהן משתמשים צפו בסרטונים בערוץ, בבעלי התוכן, בסרטון או בפלייליסט שצוינו. המדד הזה כולל צפיות משותפות כשמספר אנשים צופים יחד במסך טלוויזיה. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- מספר הדקות שבהן מנויי YouTube Premium (לשעבר YouTube Red) צפו בסרטון.
- average_view_duration_seconds (מדד ליבה)
- משך הזמן הממוצע, בשניות, של הפעלות הסרטונים. החל מ-13 בדצמבר 2021, המדד הזה לא כולל תנועה מקליפים בלופ. בדוח פלייליסט, המדד מציין את האורך הממוצע, בשניות, של הפעלות סרטונים שהתרחשו בהקשר של פלייליסט. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- האחוז הממוצע של הסרטון שנצפה במהלך הפעלת סרטון. החל מ-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. - subscribers_gained (מדד ליבה)
- מספר הפעמים שמשתמשים נרשמו לערוץ. 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.
מדדים של פלייליסטים
דוחות הפלייליסטים מכילים שני סוגים של מדדים שמסבירים איך הצופים יוצרים אינטראקציה עם הסרטונים בפלייליסט:
-
מדדי סרטונים מצטברים מספקים מדדים של פעילות משתמשים וחשיפות שנצברים לכל הסרטונים בפלייליסט, שנמצאים גם בבעלות הערוץ שבבעלותו הפלייליסט. מדדים של סרטונים בבעלות של ערוצים אחרים לא נכללים בחישוב המצטבר. לכן, אם בערוץ מסוים נוצר פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, הדוחות של הפלייליסטים האלה לא יספקו ערכים למדדים האלה.
בקטעים מדדי צפיות ומדדי זמן צפייה במסמך הזה מפורטות ההגדרות של מדדי הסרטונים המצטברים הנתמכים.
-
מדדים בתוך הפלייליסט משקפים את פעילות המשתמש ואת ההתעניינות בהקשר של דף הפלייליסט. המדדים האלה כוללים צפיות בכל הסרטונים בפלייליסט, לא משנה מי הבעלים של הערוץ, אבל הם סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
רוב המדדים הבאים הם מדדים בתוך הפלייליסט. המדדים האחרים ברשימה, כמו המדד playlistSaves, עוסקים באינטראקציות של המשתמשים עם הפלייליסט עצמו ולא עם הסרטונים בפלייליסט. לכן, המדדים האלה לא יוגדרו כמדדים מצטברים של סרטונים או כמדדים של פלייליסטים.
- playlist_starts
- מספר הפעמים שצופים יזמו הפעלה של פלייליסט. שימו לב שהמדד הזה כולל רק צפיות בפלייליסטים שהתרחשו באינטרנט.
- playlist_saves_added (נתמך רק ב-YouTube Reporting API)
- מספר הפעמים שמשתמשים שמרו פלייליסט. מידע נוסף על פלייליסטים שמורים זמין במרכז העזרה של YouTube. המדד הזה מחזיר מספר מוחלט. כלומר, אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים ושומר אותו שוב, ערך המדד משקף שתי שמירות של פלייליסטים.
- playlist_saves_removed (נתמך רק ב-YouTube Reporting API)
- מספר הפעמים שמשתמשים הסירו את הפלייליסט מרשימת הפלייליסטים השמורים שלהם. המדד הזה מחזיר מספר מוחלט. כלומר, אם משתמש שומר פלייליסט, מסיר אותו מרשימת הפלייליסטים השמורים, שומר אותו שוב ומסיר אותו שוב, ערך המדד ישקף שתי הסרות של שמירת פלייליסט.
מדדי הערות
- annotation_impressions
- המספר הכולל של החשיפות של ההערות.
- 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_closes
- מספר ההערות שנסגרו.
- annotation_close_rate (מדד ליבה)
- היחס בין מספר ההערות שהצופים סגרו לבין המספר הכולל של החשיפות של ההערות. This is a core metric and is subject to the Deprecation Policy.
מדדי הכרטיס
במרכז העזרה של YouTube יש הוראות מפורטות יותר להוספת כרטיסים לסרטונים ולדוח הכרטיסים ב-YouTube Analytics.
- card_impressions
- מספר הפעמים שהכרטיסים הוצגו. כשחלונית הכרטיסים נפתחת, נרשמת חשיפה לכל אחד מהכרטיסים בסרטון.
- card_clicks
- מספר הפעמים שבוצע קליק על כרטיסים.
- card_click_rate
- שיעור הקליקים (CTR) של כרטיסים, שמחושב לפי היחס בין הקליקים על הכרטיסים לבין החשיפות של הכרטיסים.
- מספר הפעמים שהטיזרים של הכרטיסים הוצגו. צפייה אחת בסרטון יכולה להניב כמה חשיפות של טיזרים.
- מספר הקליקים על טיזרים של כרטיסים. קליקים על סמל הכרטיס משויכים לטיזר האחרון שהוצג למשתמש.
- שיעור הקליקים על טיזרים בכרטיסים, שמחושב כיחס בין הקליקים על טיזרים בכרטיסים לבין המספר הכולל של החשיפות של טיזרים בכרטיסים.
מדדים של מסך סיום
מסכי סיום הם רכיבים שמוצגים ב-5 עד 20 השניות האחרונות של הסרטון כדי לקדם את התוכן, הערוץ והאתרים שלכם. במרכז העזרה של YouTube יש הוראות מפורטות יותר לגבי הוספת מסכי סיום לסרטונים ודוח מסכי הסיום ב-YouTube Analytics.
- end_screen_element_impressions
- מספר הרכיבים של מסך הסיום שהוצגו. חשיפה אחת נרשמת לכל רכיב מסך סיום שמוצג.
- end_screen_element_clicks
- מספר הפעמים שהמשתמשים לחצו על רכיבים של מסך סיום.
- end_screen_element_click_rate
- שיעור הקליקים על רכיבי מסך הסיום, שמחושב לפי היחס בין הקליקים על רכיבי מסך הסיום לבין החשיפות של רכיבי מסך הסיום.
מדדים לגבי ביטול חברות במועדון
- membershipsCancellationSurveyResponses
- מספר הסקרים שמילאו משתמשי YouTube שביטלו את החברות במועדון של הערוץ שצוין במהלך תקופת הדיווח.
מדדי הכנסה משוערת
הערה: מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, ולא כוללים פרסום שנמכר או הוצג על ידי שותפים. במרכז העזרה של YouTube יש מידע נוסף והערות לגבי נתוני ההכנסות המשוערות.
- estimated_partner_revenue (מדד ליבה)
- סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google, וגם ממקורות שאינם פרסום, באזור ובטווח התאריכים שנבחרו.
- estimated_partner_ad_revenue
- סך כל ההכנסות המשוערות נטו מכל מקורות הפרסום שנמכרו על ידי Google באזור ובטווח התאריכים שנבחרו.
מדדי ההכנסות המשוערות כפופים להתאמות בסוף החודש, ואינם כוללים מודעות שהוצגו או נמכרו על ידי שותפים. - estimated_partner_ad_auction_revenue (נתמך רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (הכנסה נטו) מפרסום שנמכר במכירה פומבית דרך AdSense בטווח התאריכים ובאזור שנבחרו. המדד הזה נקרא בעבר
estimated_partner_ad_sense_revenue. - estimated_partner_ad_reserved_revenue (נתמך רק ב-YouTube Reporting API)
- סך כל הרווחים המשוערים (הכנסה נטו) מפרסום שמור שנמכר דרך DoubleClick (DCLK) וממקורות אחרים שנמכרים על ידי YouTube. המדד הזה נקרא בעבר
estimated_partner_double_click_revenue. - 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_impressions
- מספר החשיפות המאומתות של המודעות שהוצגו.
- estimated_monetized_playbacks
- מספר הפעמים שבהן צופה הפעיל את הסרטון שלך והוצגה לו לפחות חשיפה אחת של מודעה. צפייה שהוצגו בה מודעות נספרת אם הצופה רואה מודעה לפני הסרטון (pre-roll) אבל מפסיק לצפות בה לפני שהסרטון מתחיל. השגיאה המשוערת הצפויה בנתון הזה היא ±2.0%.
- estimated_playback_based_cpm
- ההכנסה המשוערת ברוטו לכל אלף הפעלות.