YouTube Analytics API: Channel Reports

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

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

  • דוחות ביצועי מודעות מכילים מדדים שקשורים להכנסות ולביצועי המודעות. הם משתמשים במאפיין 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. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים מקובצים ב-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 או יותר צפיות, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, 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.

מונחים של טבלת דוחות

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
צריך להשתמש ב-1 או יותר views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

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

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

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
יש להשתמש ב-1 או יותר 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 או יותר views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

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

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

תוכן עניינים
מאפיינים:
שימוש ב-1 בלבד day, ‏ month
אופציונלי creatorContentType
מדדים:
יש להשתמש ב-1 או יותר 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 או יותר views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
מסננים:
משתמשים ב-0 או ב-1 continent, ‏ subContinent
משתמשים ב-0 או ב-1 video, ‏ group

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

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

תוכן עניינים
מאפיינים:
חובה province
אופציונלי creatorContentType
מדדים:
יש להשתמש ב-1 או יותר 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 או יותר צפיות, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, subContinent
משתמשים ב-0 או ב-1 video, ‏ group
אפשרויות מיון: -צפיות
-estimatedMinutesWatched

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

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

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

פרטי ההפעלה

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

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

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

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

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

תוכן עניינים
מאפיינים:
צריך להשתמש ב-0 או יותר creatorContentType, ‏ subscribedStatus
משתמשים ב-0 או ב-1 day, ‏ month
מדדים:
צריך להשתמש ב-1 או יותר צפיות, redViews, לייקים, תגובות 'לא אהבתי', videosAddedToPlaylists, videosRemovedFromPlaylists, שיתופים, 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 או יותר 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 או יותר views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, subContinent
משתמשים ב-0 או ב-1 video, ‏ group
צריך להשתמש ב-0 או יותר liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
פרטי ההפעלה עם מאפיין זמן אופציונלי והמדד averageViewPercentage

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מקורות תנועה

מקור תנועה

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

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

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

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

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

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

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

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

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

סוג מכשיר

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

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

מערכת הפעלה

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
יש להשתמש ב-1 או יותר ageGroup, ‏ gender
צריך להשתמש ב-0 או יותר creatorContentType, ‏ liveOrOnDemand, ‏ subscribedStatus
מדדים:
יש להשתמש ב-1 או יותר viewerPercentage
מסננים:
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, 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 או יותר מניות
מסננים:
משתמשים ב-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 או יותר views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
מסננים:
משתמשים ב-0 או ב-1 country, ‏ continent, ‏ subContinent
אפשרויות מיון: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
יש להשתמש ב-1 או יותר 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 או יותר צפיות, redViews, לייקים, תגובות 'לא אהבתי', videosAddedToPlaylists, videosRemovedFromPlaylists, שיתופים, 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 או יותר צפיות, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
מסננים:
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, subContinent
צריך להשתמש ב-0 או יותר subscribedStatus, ‏ youtubeProduct
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מבוסס זמן

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מקורות תנועה

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

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

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

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

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

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

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

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

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

סוג מכשיר

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

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

מערכת הפעלה

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

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

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

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

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

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

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

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

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

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

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

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

שימוש ב-isCurated
תוכן עניינים
מאפיינים:
חובה playlist
מדדים:
צריך להשתמש ב-1 או יותר views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration, ‏ playlistStarts, ‏ viewsPerPlaylistStart, ‏ averageTimeInPlaylist
מסננים:
חובה isCurated==1
משתמשים ב-0 או ב-1 מדינה, מחוז, יבשת, subContinent
צריך להשתמש ב-0 או יותר playlist, ‏ subscribedStatus, ‏ youtubeProduct
אפשרויות מיון: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-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