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 כדי לאחזר אסימוני הרשאה.

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

רמות
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. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים ב-YouTube Analytics.

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

מסננים

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

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

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

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

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

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

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

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

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

דיווח על מונחים בטבלה

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
יש להשתמש באחד או יותר <brise-Terms-ונים <brise-לדוגמה, <brise-כים <brise-כים <brise-לדוגמה, <br למתק 1-{4} " <brations- המתוארים' <brations-Conversions- < }<brise-ונות ו-< ; <brise- שעדייןו <br class=" <br למתק 1 " <brise- שעדייןו <br class=" <brise- תבוטל" <brations- המתוארים' <br class="ph-estimated-impressions-העמודה "> <br class="Phil-1-7">redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
מסננים:
צריך להשתמש ב-0 או ב-1 country, continent, subContinent
צריך להשתמש ב-0 או ב-1 video, group

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

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

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
יש להשתמש באחד או יותר Views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
מסננים:
חובה province
צריך להשתמש ב-0 או ב-1 video, group

מבוסס זמן

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

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

תוכן עניינים
מאפיינים:
יש להשתמש בשדה אחד בדיוק day, חודש
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר 6 YouTubeClick כבר {9השגת {/9 הכיסויים {/9Clicks {/9 יצירה} {/9 יצירה {/9 יצירה {/9 יצירה { כמות הסרה{/9 הצגה כמות מודעה {/9 { 5 { יצירה} {/9 יצירה {/9 יצירה} {/9 שניות {/9 יצירה}אירוע {השגתי{/9 מסגרותכמות הסרההשגת} הש השיטה { 9 מסגרות {השגת {/9 הקבוצה') מיניםredViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
מסננים:
צריך להשתמש ב-0 או ב-1 country, continent, subContinent
צריך להשתמש ב-0 או ב-1 video, group

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

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

תוכן עניינים
מאפיינים:
יש להשתמש בשדה אחד בדיוק day, חודש
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר Views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
מסננים:
חובה province
צריך להשתמש ב-0 או ב-1 video, group

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

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

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

תוכן עניינים
מאפיינים:
חובה country
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר <brise-Terms-ונים <brise-לדוגמה, <brise-כים <brise-כים <brise-לדוגמה, <br למתק 1-{4} " <brations- המתוארים' <brations-Conversions- < }<brise-ונות ו-< ; <brise- שעדייןו <br class=" <br למתק 1 " <brise- שעדייןו <br class=" <brise- תבוטל" <brations- המתוארים' <br class="ph-estimated-impressions-העמודה "> <br class="Phil-1-7">redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
מסננים:
צריך להשתמש ב-0 או ב-1 יבשת, subContinent
צריך להשתמש ב-0 או ב-1 video, group

פעילות משתמשים לפי פרובינציה

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

תוכן עניינים
מאפיינים:
חובה province
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר Views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
מסננים:
חובה country==US
צריך להשתמש ב-0 או ב-1 video, group

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

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

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

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

הערה: אם כוללים את המאפיין מחוז, צריך להשתמש גם במסנן country==US.
צריך להשתמש ב-0 או ב-1 day, חודש
מדדים:
יש להשתמש באחד או יותר Views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
מסננים:
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
צריך להשתמש ב-0 או ב-1 video, group
אפשרויות מיון: -צפיות
-estimatedMinutesWatched

פרטי הפעלה

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

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
יש להשתמש ב-0 או יותר creatorContentType, subscribedStatus
צריך להשתמש ב-0 או ב-1 day, חודש
מדדים:
יש להשתמש באחד או יותר Views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
מסננים:
צריך להשתמש ב-0 או ב-1 video, group
יש להשתמש ב-0 או יותר מחוז, subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

פרטי הפעלה לפי מחוז

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

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

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

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

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

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

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

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

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

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

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

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

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

מקורות תנועה

מקור תנועה

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

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

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

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

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

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

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

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

סוג מכשיר

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

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

מערכת הפעלה

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

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

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

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

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

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

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

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

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

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

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

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

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

שימור קהל

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר <brise-Terms-ונים <brise-לדוגמה, <brise-כים <brise-כים <brise-לדוגמה, <br למתק 1-{4} " <brations- המתוארים' <brations-Conversions- < }<brise-ונות ו-< ; <brise- שעדייןו <br class=" <br למתק 1 " <brise- שעדייןו <br class=" <brise- תבוטל" <brations- המתוארים' <br class="ph-estimated-impressions-העמודה "> <br class="Phil-1-7">redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
מסננים:
צריך להשתמש ב-0 או ב-1 country, continent, subContinent
אפשרויות מיון: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר Views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
מסננים:
חובה province
אופציונלי subscribedStatus
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

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

  • בכרטיסייה Recommended (מומלץ) בכל קטע, מתואר הפורמט המועדף של בקשת ה-API לאחזור הדוח המתאים. הדוחות המומלצים תומכים בקבוצה מורחבת של מדדים שכוללים גם מדדי וידאו נצברים וגם מדדים בפלייליסט. בפורמט הבקשה הזה לא נעשה שימוש במאפיין isCurated.
  • בכרטיסייה שימוש ב-isCurated בכל קטע מתוארים פורמט ישן יותר של בקשות API, שבו נדרש המאפיין isCurated. הדוחות האלה תומכים רק במדדים בתוך הפלייליסט. חשוב לשים לב שהמאפיין isCurated הוצא משימוש בכל הדוחות. הערת האזהרה הבאה מסבירה את לוח הזמנים להוצאה משימוש.

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

מדדי וידאו מצטברים

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

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

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

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

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

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

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
[ללא]
מדדים:
יש להשתמש באחד או יותר views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct

מבוסס זמן

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
יש להשתמש בשדה אחד בדיוק day, חודש
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct

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

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

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה country
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 יבשת, subContinent
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct

פעילות בפלייליסט לפי מחוז

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

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

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationType
יש להשתמש ב-0 או יותר day, subscribedStatus
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
אופציונלי subscribedStatus

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

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

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

מומלץ
תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationDetail
מדדים:
יש להשתמש באחד או יותר Views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
מסננים:
חובה insightPlaybackLocationType==EMBEDDED
יש להשתמש בשדה אחד בדיוק פלייליסט, קבוצה
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה insightPlaybackLocationDetail
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1;insightPlaybackLocationType==EMBEDDED
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
אופציונלי subscribedStatus
אפשרויות מיון: -views
-estimatedMinutesWatched
-playlistStarts

מקורות תנועה

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה insightTrafficSourceType
יש להשתמש ב-0 או יותר day, subscribedStatus
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
אופציונלי subscribedStatus

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

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

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

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

מומלץ
תוכן עניינים
מאפיינים:
חובה insightTrafficSourceDetail
מדדים:
יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
מסננים:
חובה insightTrafficSourceType==ADVERTISING (או ערך נתמך אחר)
יש להשתמש בשדה אחד בדיוק פלייליסט, קבוצה
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה insightTrafficSourceDetail
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1;insightTrafficSourceType==ADVERTISING (או ערך נתמך אחר)
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
אופציונלי subscribedStatus
אפשרויות מיון: -views
-estimatedMinutesWatched
-playlistStarts

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

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

סוג מכשיר

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה deviceType
יש להשתמש ב-0 או יותר day, subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר operatingSystem, subscribedStatus, youtubeProduct

מערכת הפעלה

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה operatingSystem
יש להשתמש ב-0 או יותר day, subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר deviceType, subscribedStatus, youtubeProduct

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

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה deviceType, operatingSystem
יש להשתמש ב-0 או יותר day, subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר subscribedStatus, youtubeProduct

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
יש להשתמש באחד או יותר ageGroup, gender
יש להשתמש ב-0 או יותר subscribedStatus
מדדים:
חובה viewerPercentage
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 פלייליסט, קבוצה
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
אופציונלי subscribedStatus
הערה: ערכי viewerPercentage בדוח הזה לא מנורמלים לערכים שונים של מאפיין פרטי ההפעלה subscribedStatus.

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

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

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

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

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

באמצעות isCurated
תוכן עניינים
מאפיינים:
חובה פלייליסט
מדדים:
יש להשתמש באחד או יותר views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
מסננים:
חובה isCurated==1
צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
יש להשתמש ב-0 או יותר פלייליסט, subscribedStatus, youtubeProduct
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

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

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

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

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

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

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

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