YouTube Analytics API: Channel Reports

בדף הזה מפורטים הדוחות שבעלי ערוצים יכולים לאחזר באמצעות YouTube Analytics API. דוחות הערוץ מספקים מדדים של פעילות המשתמשים בערוץ ספציפי, ומודדים נתונים כמו צפיות בסרטונים, דירוגים ומספר המנויים.

  • דוחות הסרטונים מספקים נתונים סטטיסטיים על כל פעילות המשתמשים שקשורה לסרטונים בערוץ.
  • דוחות על פלייליסטים מספקים נתונים סטטיסטיים שקשורים באופן ספציפי לצפיות בסרטונים שמתרחשות בהקשר של פלייליסט.
  • דוחות ביצועי מודעות מכילים מדדים שקשורים להכנסות ולביצועי המודעות. הם משתמשים במאפיין adType כדי לקבץ מדדים על סמך סוגי המודעות שהוצגו במהלך הפעלת סרטונים. בקטע דוחות ביצועי מודעות מוסבר על שני סוגים של מדדי ביצועי מודעות שה-API תומך בהם.

אחזור דוח

כדי לאחזר דוח ערוצים, צריך להגדיר את ערך הפרמטר ids בבקשת ה-API לאחד מהערכים הבאים:

  • channel==MINE – ממשק ה-API מחזיר נתונים לגבי ערוץ YouTube של המשתמש המאומת.

  • channel==CHANNEL_ID – מגדירים את CHANNEL_ID למזהה הערוץ הייחודי של הערוץ שממנו מאחזרים נתונים. המשתמש שמאשר את הבקשה חייב להיות הבעלים של הערוץ.

    מזהה הערוץ הוא כרגע מחרוזת שמתחילה באותיות UC, אבל הפורמט שלו עשוי להשתנות. (אפשר למצוא את מזהה הערוץ בדף הגדרות החשבון המתקדמות של ערוץ YouTube, או לאחזר את מזהה הערוץ באופן פרוגרמטי באמצעות השיטה YouTube Data API's channels.list).

אישור

כל הבקשות ל-YouTube Analytics API צריכות להיות מאושרות. במדריך ההרשאות מוסבר איך להשתמש בפרוטוקול OAuth 2.0 כדי לאחזר אסימוני הרשאה.

בקשות ל-YouTube Analytics API משתמשות בהיקפי ההרשאות הבאים:

טווחים
https://www.googleapis.com/auth/yt-analytics.readonly עיון בדוחות YouTube Analytics עבור התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדים של פעילות המשתמשים, כמו מספר הצפיות ומספר הדירוגים.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly עיון בדוחות כספיים של YouTube Analytics לגבי התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדי פעילות המשתמשים ולמדדי ביצועי המודעות וההכנסות המשוערות.
https://www.googleapis.com/auth/youtube ניהול חשבון YouTube. ב-YouTube Analytics API, בעלי ערוצים משתמשים בהיקף הזה כדי לנהל קבוצות של YouTube Analytics ופריטים בקבוצות.
https://www.googleapis.com/auth/youtubepartner הצגה וניהול של נכסים ב-YouTube ותוכן שמשויך אליהם ב-YouTube. ב-API של YouTube Analytics, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות של YouTube Analytics ופריטים בקבוצות.

הערה: בשלב הזה, אין תמיכה בדוחות על ערוצים ברווחים משוערים ובמדדי ביצועים של מודעות. לכן, היקף ההרשאה https://www.googleapis.com/auth/yt-analytics-monetary.readonly לא מעניק כרגע גישה לנתונים כספיים בדוחות האלה.

מסננים

בטבלאות שבהן מוסבר על הדוחות הנתמכים מפורטים המסננים שאפשר להשתמש בהם בכל דוח. בטבלאות, מסננים שמופיעים בסוגריים הם אופציונליים. לדוגמה, כדי להשתמש באפשרות הסינון video(,country), חובה להשתמש במסנן video, אבל המסנן country הוא אופציונלי.

בנוסף, ה-API תומך באפשרות לציין כמה ערכים למסננים video ו-playlist. אם מציינים כמה ערכים לאחד מהמסננים האלה, אפשר גם להוסיף את המסנן הזה לרשימת המימדים שמציינים בבקשה. זה נכון גם אם המסנן לא מופיע כמאפיין נתמך בדוח מסוים.

בקטע filters הגדרת הפרמטר מוסבר באופן מלא איך לסנן את תוצאות ה-API לפי ערך ספציפי או קבוצת ערכים.

הסבר על טבלאות בדוחות

בקטע הזה מוסבר על הפורמט והטרמינולוגיה שבהם נעשה שימוש בטבלאות שמגדירות את הדוחות שה-API תומך בהם. בטבלה הבאה מפורטים המאפיינים, המדדים והמסננים שנתמכים בדוח 'פרטי הפעלה' של סרטון, באמצעות מאפיין הזמן והמדד averageViewPercentage.

תוכן עניינים
מאפיינים:
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus, ‏ youtubeProduct
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct

הטבלה מכילה שתי שורות למאפיינים, שורה אחת למדדים ושלוש שורות למסננים. במקרה של מאפיינים ומסננים, אפשר לשלב ערכים מכל שורה בבקשת API, כל עוד השילוב עומד בכללי השימוש שמופיעים בטבלה. לכן, לדוגמה, ערכי הפרמטר dimensions התקינים בדוח הזה כוללים:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

עם זאת, ערך הפרמטר day,month לא תקין כי נעשה בו שימוש בשני מאפיינים מבוססי-זמן, ובבקשה צריך להשתמש ב-0 או ב-1.

מונחים שקשורים לדוח בטבלה

בטבלאות נעשה שימוש במונחים הבאים כדי לציין אם מאפיינים הם חובה או אופציונליים:

  • המונחים הבאים מציינים שחובה להזין ערך:
    • חובה: צריך לציין את הערך.
    • חובה להשתמש בערך אחד בדיוק: צריך לכלול ערך אחד מהקבוצה.
    • משתמשים בערך אחד או יותר: אפשר לכלול את כל הערכים מהקבוצה או רק חלק מהם, אבל צריך לכלול לפחות ערך אחד.
  • המונחים הבאים מציינים שערך הוא אופציונלי:
    • אופציונלי: אפשר לכלול את הערך.
    • שימוש בערך 0 או 1: יש לכם אפשרות לכלול ערך אחד מהקבוצה.
    • שימוש ב-0 או יותר: יש לכם אפשרות לכלול את כל הערכים מהקבוצה או חלק מהם.

דוחות סרטונים

נתונים סטטיסטיים בסיסיים

נתונים סטטיסטיים בסיסיים של פעילות המשתמשים

בדוח הזה מוצגת סטטיסטיקה שקשורה לפעולות של משתמשים בערוץ. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים של סרטון או מדינה ספציפיים.

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
משתמשים ב-1 או יותר adImpressions
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

נתונים סטטיסטיים בסיסיים על פעילות משתמשים במדינות בארה"ב

בדוח הזה מוצגים נתונים סטטיסטיים לגבי מדינה מסוימת בארה"ב או מחוז קולומביה. הערה: הדוח הזה תומך רק בחלק מהמדדים שזמינים בדוח הספציפי למדינה שמתואר למעלה.

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
חובה province
משתמשים ב-0 או ב-1 video, ‏ group

מבוסס-זמן

פעילות המשתמשים לפי מדינה לתקופות זמן ספציפיות

בדוח הזה מוצגות סטטיסטיקות שקשורות לפעולות של משתמשים בערוץ במרווחי זמן ספציפיים. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים של סרטון או מדינה ספציפיים.

תוכן עניינים
מאפיינים:
שימוש בערך 1 בלבד day, month
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר adImpressions
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

פעילות משתמשים במדינות בארה"ב בתקופות זמן ספציפיות

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לפעילות משתמשים במדינה מסוימת בארה"ב או במחוז קולומביה. הערה: הדוח הזה תומך רק בחלק מהמדדים שזמינים בדוח הספציפי למדינה שמתואר למעלה.

תוכן עניינים
מאפיינים:
שימוש בערך 1 בלבד day, month
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
חובה province
משתמשים ב-0 או ב-1 video, ‏ group

המיקום הגיאוגרפי של המשתמש

פעילות המשתמשים לפי מדינה

בדוח הזה מוצגת סטטיסטיקה שקשורה לפעילות המשתמשים בערוץ, לפי מדינה. אפשר לסנן את הדוח כדי להציג רק נתונים של סרטון ספציפי.

תוכן עניינים
מאפיינים:
חובה country
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר adImpressions
מסננים:
משתמשים ב-0 או ב-1 continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

פעילות המשתמשים לפי מחוז

בדוח הזה מוצגות סטטיסטיקות של פעילות המשתמשים במדינות בארה"ב ובמחוז קולומביה. בדוח הזה, צריך להגדיר את ערך הפרמטר filters ל-country==US.

תוכן עניינים
מאפיינים:
חובה province
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
חובה country==US
משתמשים ב-0 או ב-1 video, ‏ group

פעילות המשתמשים לפי עיר (עד 250 תוצאות)

הערה: כדי להשתמש בדוח הזה, צריך להגדיר את הפרמטר maxResults לערך שלם של 250 או פחות. בשונה מרוב הדוחות האחרים, בדוח הזה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה מוצגות סטטיסטיקות של פעילות המשתמשים לפי עיר.

תוכן עניינים
מאפיינים:
חובה city
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ country, ‏ province, ‏ subscribedStatus

הערה: אם כוללים את המאפיין province, צריך להשתמש גם במסנן country==US.
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשרויות מיון: ‫-views
-estimatedMinutesWatched

פעילות המשתמשים לפי אזור שוק ייעודי (DMA)

בדוח הזה מוצגת סטטיסטיקה של פעילות המשתמשים לפי אזור שוק ייעודי (DMA). כדי להשתמש בדוח הזה, צריך להגדיר את ערך הפרמטר filters ל-country==US או לסנן לפי מחוז מסוים (מדינה בארה"ב).

תוכן עניינים
מאפיינים:
חובה dma
משתמשים ב-0 או ב-1 day
month
creatorContentType
subscribedStatus
מדדים:
משתמשים ב-1 או יותר engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 country==US
province
משתמשים ב-0 או ב-1 video
group
אפשרויות מיון: ‫-views
-estimatedMinutesWatched

פרטי הפעלה

בדוחות על פרטי ההפעלה מופיעים נתונים סטטיסטיים שקשורים למאפייני הצפייה הבאים:

  • האם הצפייה הייתה בשידור חי או בסרטון לפי דרישה?
  • האם הצופה נרשם כמנוי לערוץ שבבעלותו הסרטון?
  • באיזה מוצר של YouTube התרחשה הצפייה?

הערה: אי אפשר להשתמש במאפיין liveOrOnDemand ובמסנן שלו יחד עם המדד averageViewPercentage. לכן, בכל אחד מקטעי המשנה הבאים מפורטים שני דוחות. דוח אחד תומך במאפיין (ובמסנן) liveOrOnDemand, והדוח השני תומך במדד averageViewPercentage.

פעילות המשתמשים לפי סטטוס המינוי

בדוח הזה מוצגים מדדים של פעילות המשתמשים בקרב צופים מנויים ולא מנויים. אפשר לקבץ את הנתונים הסטטיסטיים לפי תקופת זמן (יום או חודש), ואפשר גם לסנן את הדוח לפי מדינה, יבשת או subContinent.

תוכן עניינים
מאפיינים:
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ likes, ‏ dislikes, ‏ videosAddedToPlaylists, ‏ videosRemovedFromPlaylists, ‏ shares, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אופציונלי subscribedStatus

פעילות המשתמשים לפי סטטוס המינוי במחוזות

בדוח הזה מוצגים מדדי פעילות משתמשים של צופים מנויים ולא מנויים במדינות בארה"ב או במחוז קולומביה. הדוח הזה תומך בפחות מדדים מהדוח הקודם.

תוכן עניינים
מאפיינים:
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר province, ‏ subscribedStatus

פרטי הפעלה עם מאפיין זמן אופציונלי

המאפיין 'זמן' – day או month – הוא אופציונלי בדוחות האלה, כי בכל מקרה צריך להשתמש בפרמטרים של הבקשה startDate ו-endDate כדי לציין את טווח התאריכים שהדוח יכלול. אם המאפיין הזה קיים, הוא מציין שרוצים שהנתונים בדוח יצטברו לפי יום, חודש וכו'.

פרטי הפעלה עם מאפיין זמן אופציונלי ונתונים סטטיסטיים של liveOrOnDemand

בדוח הזה מוצגת סטטיסטיקה מפורטת של הפעלות במרווחי זמן ספציפיים. הוא תומך במאפיין (ובמסנן) liveOrOnDemand.

תוכן עניינים
מאפיינים:
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
פרטי ההפעלה עם מאפיין זמן אופציונלי והמדד averageViewPercentage

בדוח הזה מוצגת סטטיסטיקה מפורטת של הפעלות במרווחי זמן ספציפיים. הוא תומך במדד averageViewPercentage.

תוכן עניינים
מאפיינים:
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus, ‏ youtubeProduct
משתמשים ב-0 או ב-1 day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct

פרטי הפעלה לפי מדינה

פרטי הפעלה לפי מדינה עם נתונים סטטיסטיים של liveOrOnDemand

בדוח הזה מוצגים נתונים סטטיסטיים מפורטים על הפעלת סרטונים, לפי מדינה. הוא תומך במאפיין (ובמסנן) liveOrOnDemand.

תוכן עניינים
מאפיינים:
חובה country
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
משתמשים ב-0 או ב-1 continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
פרטי הפעלה לפי מדינה עם המדד averageViewPercentage

הדוח הבא דומה לדוח הקודם. הוא מוסיף תמיכה במדד averageViewPercentage, אבל הוא לא תומך ב-liveOrOnDemand כמאפיין או כמסנן.

תוכן עניינים
מאפיינים:
חובה country
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct

פרטי הפעלה לפי פרובינציה

פרטי הפעלה לפי מחוז עם נתונים סטטיסטיים של liveOrOnDemand

בדוח הזה מופיעים נתונים סטטיסטיים מפורטים על הפעלת תוכן במדינות בארה"ב ובמחוז קולומביה. הוא תומך במאפיין (ובמסנן) liveOrOnDemand.

תוכן עניינים
מאפיינים:
חובה province
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
חובה country==US
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
פרטי הפעלה לפי פרובינציה עם המדד averageViewPercentage

הדוח הבא דומה לדוח הקודם. הוא מוסיף תמיכה במדד averageViewPercentage, אבל הוא לא תומך ב-liveOrOnDemand כמאפיין או כמסנן.

תוכן עניינים
מאפיינים:
חובה province
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
חובה country==US
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct

מקומות שבהם הסרטון הופעל

דוח מיקום הפעלה של סרטון

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לסוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים.

תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationType
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ day, ‏ liveOrOnDemand, ‏ subscribedStatus
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus

פרטים על מקומות שבהם הסרטון הופעל (<= 25 תוצאות)

הערה: כדי להשתמש בדוח הזה, צריך להגדיר את הפרמטר maxResults לערך שלם של 25 או פחות. בשונה מרוב הדוחות האחרים, בדוח הזה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה אפשר לראות אילו נגני וידאו מוטמעים הניבו את מספר הצפיות הגבוה ביותר בסרטונים בערוץ או את זמן הצפייה הארוך ביותר בסרטונים בערוץ.

תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationDetail
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
חובה insightPlaybackLocationType==EMBEDDED
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus
אפשרויות מיון: ‫-views
-estimatedMinutesWatched

מקורות תנועה

מקור תנועה

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך האופן שבו הצופים הגיעו לתוכן הסרטון שלכם. לדוגמה, הוא מזהה את מספר הצפיות שהגיעו מחיפוש Google או מקישור לסרטון קשור.

הערה: אם המכפלה של מספר הסרטונים שנכללו בשאילתה כפול מספר הימים בטווח התאריכים גדולה מ-50,000, הדוח יחזיר שגיאה. לדוגמה, שאילתה שמאחזרת נתונים של 500 מזהי סרטונים יכולה לבקש נתונים ל-100 ימים לכל היותר. כדי להקטין את מספר השורות שהבקשה מחזירה, אפשר לפצל את השאילתה לכמה שאילתות שמציינות פחות סרטונים או להגדיר טווחי תאריכים קצרים יותר.

תוכן עניינים
מאפיינים:
חובה insightTrafficSourceType
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ day, ‏ liveOrOnDemand, ‏ subscribedStatus
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus

פרטים על מקורות התנועה (<= 25 תוצאות)

הערה: כדי להשתמש בדוח הזה, צריך להגדיר את הפרמטר maxResults לערך שלם של 25 או פחות. בשונה מרוב הדוחות האחרים, בדוח הזה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה מוצגים נתונים סטטיסטיים של צפיות שמבוססים על מקורות התנועה שהניבו הכי הרבה צפיות בתוכן של הערוץ. ההפניות מסווגות לפי סוג מקור התנועה, וההגדרה של המימד insightTrafficSourceDetail מזהה את מקורות התנועה שעבורם הדוח זמין. לדוגמה, אם מגדירים את המסנן insightTrafficSourceType לערך ADVERTISING, בדוח יופיעו סוגי המודעות שהניבו הכי הרבה צפיות או זמן צפייה בתוכן של הערוץ.

תוכן עניינים
מאפיינים:
חובה insightTrafficSourceDetail
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
חובה insightTrafficSourceType (ראו הערה מתחת לטבלה)
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus
אפשרויות מיון: ‫-views
-estimatedMinutesWatched

הערה: הדוח הזה נתמך רק עבור מקורות תנועה ספציפיים. חלק ממקורות התנועה שלא נתמכים הם VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ו-NO_LINK_EMBEDDED.

סוג המכשיר ומערכת ההפעלה

סוג מכשיר

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות שמבוססים על האופן שבו הצופים הגיעו לתוכן הווידאו שלכם. לדוגמה, היא מזהה את מספר הצפיות שהתרחשו במכשירים ניידים או בקונסולות משחקים.

תוכן עניינים
מאפיינים:
חובה deviceType
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ day, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר operatingSystem, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct

מערכת הפעלה

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך מערכות ההפעלה של הצופים. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו במכשירי Android או בקונסולות PlayStation.

תוכן עניינים
מאפיינים:
חובה operatingSystem
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ day, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר deviceType, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct

מערכת הפעלה וסוג מכשיר

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך מערכות ההפעלה וסוגי המכשירים של הצופים. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו בטאבלטים עם Android או במחשבים שולחניים עם Windows.

תוכן עניינים
מאפיינים:
חובה deviceType, ‏ operatingSystem
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ day, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct

המאפיינים הדמוגרפיים של הצופים

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך קבוצת הגיל והמגדר של הצופים.

תוכן עניינים
מאפיינים:
משתמשים ב-1 או יותר ageGroup, ‏ gender
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ liveOrOnDemand, ‏ subscribedStatus
מדדים:
משתמשים ב-1 או יותר viewerPercentage
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus
הערה: הערכים של viewerPercentage בדוח הזה לא מנורמלים לערכים שונים או לשילובים שונים של ערכים במאפייני פרטי ההפעלה (subscribedStatus,‏ liveOrOnDemand או youtubeProduct).

לדוגמה, בדוח שמשתמש במאפיין subscribedStatus מוצגים נתונים של viewerPercentage שמסתכמים ל-100% עבור צפיות של מנויים וגם נתונים של viewerPercentage שמסתכמים ל-100% עבור צפיות של משתמשים שלא נרשמו כמנויים. (הערך הכולל של כל השדות viewerPercentage בדוח הוא 200%).

אפשר להשתמש במסננים כדי לוודא שהדוח יכיל רק נתונים של viewerPercentage עבור ערך אחד (או שילוב של ערכים) של מאפייני פרטי ההפעלה.

מעורבות ושיתוף תוכן

בדוח הזה מוצגים נתונים סטטיסטיים שמראים באיזו תדירות הסרטונים בערוץ שותפו בפלטפורמות חברתיות שונות.

תוכן עניינים
מאפיינים:
חובה sharingService
אפשר להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus
מדדים:
משתמשים ב-1 או יותר shares
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אופציונלי subscribedStatus

שימור קהל

בדוח הזה אפשר לראות עד כמה הסרטון מצליח לשמור על הקהל שלו, וגם כמה פעמים צפו בחלקים ספציפיים בסרטון. המאפיין elapsedVideoTimeRatio מודד את משך הזמן שחלף בסרטון עבור ערכי המדדים המתאימים. אפשר לחלק את המדדים לשתי קטגוריות:

  • שימור קהל

    המדדים האלה מראים באיזו מידה הסרטון מצליח לשמר את רמת העניין של הצופים.

    • audienceWatchRatio הוא יחס שמשווה בין מספר הפעמים שמשתמשים צפו בחלק מסוים של סרטון לבין המספר הכולל של הצפיות בסרטון.
    • relativeRetentionPerformance מראה עד כמה הסרטון מצליח לשמור על רמת העניין של הצופים במהלך ההפעלה, בהשוואה לסרטונים אחרים ב-YouTube באורך דומה.
  • נתונים סטטיסטיים מפורטים על צפייה

    המדדים האלה מספקים מידע על התדירות שבה צופים צפו בחלקים ספציפיים של סרטון.

    • המדד startedWatching מציין את התדירות שבה הצופים התחילו לצפות בסרטון במהלך קטע מסוים בסרטון.
    • stoppedWatching מציין את התדירות שבה הצופים הפסיקו לצפות בסרטון במהלך קטע מסוים בסרטון.
    • totalSegmentImpressions מציין את התדירות שבה אנשים צפו בקטע מסוים בסרטון.

הערה: בדוח הזה אי אפשר לציין רשימה של ערכים מופרדים בפסיקים עבור המסנן video. הערך חייב להיות מזהה סרטון יחיד.

תוכן עניינים
מאפיינים:
חובה elapsedVideoTimeRatio
מדדים:
משתמשים ב-1 או יותר audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
מסננים:
חובה סרטון
אפשר להשתמש ב-0 או יותר audienceType
subscribedStatus
youtubeProduct

צופים בו-זמנית (בשידורים חיים)

בדוח הזה מוצג מספר הצופים בו-זמנית במיקום נתון בסרטון אחד שמועבר בסטרימינג בשידור חי. הפילטר מציין את הסרטון. מאפיין המיקום בדרך כלל מייצג דקה אחת.

תוכן עניינים
מאפיינים:
משתמשים ב-0 או ב-1 livestreamPosition
מדדים:
משתמשים ב-1 או יותר averageConcurrentViewers
peakConcurrentViewers
מסננים:
חובה סרטון

סרטונים מובילים

הערה: כדי להשתמש בדוחות האלה, צריך להגדיר את הפרמטר maxResults לערך של מספר שלם שהוא 200 או פחות. לפני 1 בינואר 2013, הנתונים זמינים רק לגבי 10 הסרטונים המובילים. בניגוד לרוב הדוחות האחרים, בדוחות האלה צריך גם לציין ערך לפרמטר הבקשה sort.

הסרטונים המובילים עם מסננים אזוריים אופציונליים (<= 200 תוצאות)

בדוח הזה מפורטים הסרטונים המובילים בערוץ. אפשר לסנן את הדוח כדי להציג את הסרטונים המובילים לפי מדינה, יבשת או subContinent.

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר adImpressions
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
אפשרויות מיון: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

הסרטונים המובילים לפי מדינה (עד 200 תוצאות)

בדוח הזה מפורטים הסרטונים המובילים בערוץ במדינה מסוימת בארה"ב או במחוז קולומביה. הערה: הדוח הזה תומך רק בחלק מהמדדים שזמינים בדוח הספציפי למדינה שמתואר למעלה.

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
חובה province
אופציונלי subscribedStatus
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

הסרטונים המובילים בקרב צופים שנרשמו כמנויים או שלא נרשמו כמנויים(עד 200 תוצאות)

בדוח הזה מפורטים הסרטונים המובילים בערוץ לצופים מנויים או לצופים לא מנויים. אפשר לסנן את הדוח כדי להציג את הסרטונים המובילים לפי מדינה, יבשת או subContinent. בדוח הקודם אפשר לאחזר את הסרטונים המובילים במדינה מסוימת בארה"ב עבור צופים מנויים או לא מנויים, אבל הוא תומך בפחות מדדים מהדוח הזה.

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ likes, ‏ dislikes, ‏ videosAddedToPlaylists, ‏ videosRemovedFromPlaylists, ‏ shares, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage, ‏ annotationClickThroughRate, ‏ annotationCloseRate, ‏ annotationImpressions, ‏ annotationClickableImpressions, ‏ annotationClosableImpressions, ‏ annotationClicks, ‏ annotationCloses, ‏ cardClickRate, ‏ cardTeaserClickRate, ‏ cardImpressions, ‏ cardTeaserImpressions, ‏ cardClicks, ‏ cardTeaserClicks
מסננים:
אופציונלי subscribedStatus
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

הסרטונים המובילים לפי מוצר של YouTube (<= 200 תוצאות)

בדוח הזה מפורטים הסרטונים המובילים בערוץ, והוא תומך במסננים של פרטי הפעלה ומיקום גיאוגרפי. הדוח הזה דומה לדוח הקודם, אבל הוא תומך בפחות מדדים ומוסיף תמיכה במסנן youtubeProduct.

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
אפשר להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

הסרטונים המובילים עם מסננים של פרטי ההפעלה (עד 200 תוצאות)

בדוח הזה מפורטים הסרטונים המובילים בערוץ, עם סינון לפי אחד או יותר מהמדדים של פרטי ההפעלה: liveOrOnDemand,‏ subscribedStatus ו-youtubeProduct. בניגוד לדוח הקודם, הדוח הזה תומך במסנן liveOrOnDemand ולא תומך במדד averageViewPercentage.

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
משתמשים ב-0 או ב-1 country, ‏ province, ‏ continent, ‏ subContinent
אפשר להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

דוחות על פלייליסטים

דוחות הפלייליסטים מכילים מדדים שקשורים לפעילות המשתמשים בסרטונים בפלייליסטים של בעל הערוץ. יש שתי גרסאות של הדוחות האלה, ובקטעים הבאים מופיע תיאור של כל גרסה של כל דוח:

מדדים מצטברים של סרטונים

המדדים האלה מספקים נתונים מצטברים על פעילות המשתמשים ועל חשיפות לכל הסרטונים בפלייליסט, ששייכים גם לערוץ שמוגדר כבעלים של הפלייליסט. המדדים של סרטונים בבעלות של ערוצים אחרים לא מחושבים בצבירה. כתוצאה מכך, אם בערוץ מסוים נוצר פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, בדוחות של הפלייליסטים האלה לא יוצגו ערכים למדדים האלה.

בקטע מדדים נתמכים של פלייליסטים מופיעה רשימה של מדדים מצטברים של סרטונים שנתמכים ב-YouTube.

מדדים בפלייליסט

המדדים האלה משקפים את הפעילות וההתעניינות של המשתמשים בהקשר של דף הפלייליסט. המדדים האלה כוללים צפיות בכל הסרטונים בפלייליסט, לא משנה מי הבעלים של הערוץ, אבל הם סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.

מדדים נתמכים של פלייליסטים

תוכן עניינים
מדדים מצטברים של סרטונים engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration
מדדים בפלייליסט playlistViews, ‏ playlistEstimatedMinutesWatched, ‏ playlistAverageViewDuration, playlistSaves, ‏ playlistStarts, viewsPerPlaylistStart, ‏ averageTimeInPlaylist

נתונים סטטיסטיים בסיסיים

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לאינטראקציות של המשתמשים עם הסרטונים בפלייליסטים של הערוץ. אפשר לסנן את הדוח כדי להציג רק נתונים של פלייליסט ספציפי.

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistSaves, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

מבוסס-זמן

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לאינטראקציות של המשתמשים עם הסרטונים בפלייליסטים של הערוץ. אפשר לסנן את הדוח כדי להציג רק נתונים של פלייליסט ספציפי.

תוכן עניינים
מאפיינים:
שימוש בערך 1 בלבד day, month
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistSaves, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

המיקום הגיאוגרפי של המשתמש

פעילות בפלייליסטים לפי מדינה

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לאינטראקציות של משתמשים במדינה מסוימת עם הסרטונים בפלייליסטים של הערוץ.

תוכן עניינים
מאפיינים:
חובה country
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration
מסננים:
שימוש בערך 1 בלבד playlist, group
משתמשים ב-0 או ב-1 continent, ‏ subContinent

פעילות בפלייליסטים לפי פרובינציה

בדוח הזה מוצגים נתונים סטטיסטיים של פעילות בפלייליסטים במדינות בארה"ב ובמחוז קולומביה. בדוח הזה, צריך לסנן את התוצאות כדי להציג נתונים רק לגבי ארצות הברית.

תוכן עניינים
מאפיינים:
חובה province
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration
מסננים:
חובה country==US
שימוש בערך 1 בלבד playlist, group

מקומות שבהם הסרטון הופעל

בדוח הזה מוצגים נתונים סטטיסטיים שקשורים לסוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים בפלייליסט שלכם.

תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

פרטים על מקומות שבהם הסרטון הופעל (<= 25 תוצאות)

הערה: כדי להשתמש בדוח הזה, צריך להגדיר את הפרמטר maxResults לערך של מספר שלם עד 25. בשונה מרוב הדוחות האחרים, בדוח הזה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה אפשר לראות אילו נגני וידאו מוטמעים הניבו הכי הרבה צפיות או זמן צפייה בסרטונים בפלייליסטים של הערוץ.

תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationDetail
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
חובה insightPlaybackLocationType==EMBEDDED
שימוש בערך 1 בלבד playlist, group
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

מקורות תנועה

בדוח הזה מוצגים נתונים סטטיסטיים של צפיות שמבוססים על האופן שבו הצופים הגיעו לתוכן בפלייליסט שלכם. לדוגמה, המדד הזה מציג את מספר הצפיות שמקורן בחיפוש Google.

תוכן עניינים
מאפיינים:
חובה insightTrafficSourceType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistSaves, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

פרטים על מקורות התנועה (<= 25 תוצאות)

הערה: כדי להשתמש בדוח הזה, צריך להגדיר את הפרמטר maxResults לערך שלם של 25 או פחות. בשונה מרוב הדוחות האחרים, בדוח הזה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך מקורות התנועה שהניבו הכי הרבה צפיות בסרטונים בפלייליסטים של הערוץ. המפנים מסווגים לפי סוג מקור התנועה, וההגדרה של מאפיין insightTrafficSourceDetail מזהה את מקורות התנועה שעבורם הדוח זמין.

לדוגמה, אם מגדירים את המסנן insightTrafficSourceType לערך ADVERTISING, בדוח יופיעו סוגי המודעות שהניבו הכי הרבה צפיות או זמן צפייה בפלייליסטים של הערוץ.

תוכן עניינים
מאפיינים:
חובה insightTrafficSourceDetail
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistSaves, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
חובה insightTrafficSourceType==ADVERTISING (או ערך נתמך אחר)
שימוש בערך 1 בלבד playlist, group
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

הערה: הדוח הזה נתמך רק עבור מקורות תנועה ספציפיים. חלק ממקורות התנועה שלא נתמכים הם VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ו-NO_LINK_EMBEDDED.

סוג המכשיר ומערכת ההפעלה

סוג מכשיר

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות, על סמך האופן שבו הצופים הגיעו לסרטונים בפלייליסטים שלכם. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו במכשירים ניידים או בקונסולות משחקים.

תוכן עניינים
מאפיינים:
חובה deviceType
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

מערכת הפעלה

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך מערכות ההפעלה של הצופים. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו במכשירי Android או בקונסולות PlayStation.

תוכן עניינים
מאפיינים:
חובה operatingSystem
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

מערכת הפעלה וסוג מכשיר

בדוח הזה מוצגים נתונים סטטיסטיים מצטברים של צפיות על סמך מערכות ההפעלה וסוגי המכשירים של הצופים. לדוגמה, המערכת מזהה כמה צפיות התרחשו בטאבלטים עם Android או במחשבים עם Windows.

תוכן עניינים
מאפיינים:
חובה deviceType, ‏ operatingSystem
מדדים:
משתמשים ב-1 או יותר engagedViews, ‏ views, ‏ estimatedMinutesWatched, ‏ averageViewDuration, ‏ averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
מסננים:
שימוש בערך 1 בלבד playlist, group

המאפיינים הדמוגרפיים של הצופים

תוכן עניינים
מאפיינים:
משתמשים ב-1 או יותר ageGroup, ‏ gender
מדדים:
חובה viewerPercentage
מסננים:
שימוש בערך 1 בלבד playlist, group

פלייליסטים מובילים

הערה: כדי להשתמש בדוחות האלה, צריך להגדיר את הפרמטר maxResults לערך של מספר שלם שהוא 200 או פחות. נתונים שהתקבלו לפני 1 בינואר 2013 זמינים רק לגבי 10 הפלייליסטים המובילים. בניגוד לרוב הדוחות האחרים, בדוחות האלה צריך גם לציין ערך לפרמטר הבקשה sort.

בדוח הזה מפורטים הפלייליסטים המובילים בערוץ על סמך קריטריוני הסינון והמיון שצוינו.

תוכן עניינים
מאפיינים:
חובה פלייליסט
מדדים:
משתמשים ב-1 או יותר averageTimeInPlaylist, ‏ playlistAverageViewDuration, ‏ playlistEstimatedMinutesWatched, ‏ playlistSaves, ‏ playlistStarts, ‏ playlistViews, ‏ viewsPerPlaylistStart
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

דוחות בנושא חברות במועדון

ביטולי מינויים

בדוח הזה מוצגים נתונים סטטיסטיים שמראים למה משתמשים ביטלו את החברות שלהם במועדון החברים של הערוץ.

תוכן עניינים
מאפיינים:
משתמשים ב-0 או ב-1 membershipsCancellationSurveyReason
מדדים:
חובה membershipsCancellationSurveyResponses

דוח ביצועי מודעות

הערה: כדי לגשת לדוחות ביצועי המודעות, צריך אסימון הרשאה שמעניק גישה להיקף https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

בדוחות ביצועי המודעות מוצגים מדדים שמבוססים על חשיפות של מודעות שהוצגו במהלך הפעלת סרטונים. המדדים האלה מתייחסים לכל חשיפה של מודעה, וכל הפעלה של סרטון יכולה להניב כמה חשיפות.

מדדי הביצועים של המודעות שמבוססים על חשיפות הם:

בנוסף, חלק מדוחות הווידאו תומכים במדדי הביצועים הבאים של מודעות שמבוססים על הפעלה. עם זאת, המדדים האלה לא נכללים בדוחות ביצועי המודעות.

ביצועי המודעות לפי סוג המודעה

תוכן עניינים
מאפיינים:
חובה adType
אופציונלי day
מדדים:
משתמשים ב-1 או יותר grossRevenue, ‏ adImpressions, ‏ cpm
מסננים:
משתמשים ב-0 או ב-1 video, ‏ group
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent