YouTube Analytics API: Content Owner Reports

הערה: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

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

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

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

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

אחזור דוח

כדי לאחזר דוח של בעלי תוכן דיגיטלי, קוראים לשיטה reports.query של ה-API ומגדירים את ערך הפרמטר ids בבקשת ה-API ל-contentOwner==OWNER_NAME, כאשר OWNER_NAME מציין את המזהה של בעלי התוכן הדיגיטלי. אם אתם לא בטוחים מה הערך, אתם יכולים לשאול את מנהל השותפים שלכם.

אישור

כל הבקשות ל-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.

מסננים

כל בקשות ה-API לאחזור דוחות של בעלי תוכן חייבות לסנן את הנתונים באמצעות המאפיין video, המאפיין channel או שילוב נתמך של המאפיינים claimedStatus ו-uploaderType. (השילובים הנתמכים מפורטים בהגדרה של מאפיין uploaderType).

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

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

בקטע 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 או יותר: יש לכם אפשרות לכלול את כל הערכים מהקבוצה או חלק מהם.
חשוב: כל בקשות ה-API לאחזור דוחות על סרטונים של בעלי תוכן צריכות לסנן את הנתונים באמצעות המאפיין video, המאפיין channel, המאפיין group או שילוב נתמך של המאפיינים claimedStatus ו-uploaderType. (חלק מהדוחות לא תומכים בכל האפשרויות האלה). השילובים הנתמכים, שמופיעים גם בהגדרה של מאפיין uploaderType, הם:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

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

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

נתונים סטטיסטיים בסיסיים (כולל מספר המנויים)

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

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

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

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

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

מבוסס-זמן

פעילות בתקופות זמן

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

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

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

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

תוכן עניינים
מאפיינים:
שימוש בערך 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
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
חובה province

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

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

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

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

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

בדוח הזה מוצגות סטטיסטיקות של פעילות המשתמשים במדינות בארה"ב ובמחוז קולומביה. בדוח הזה, צריך להגדיר את ערך הפרמטר 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
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
חובה ‫country==US

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

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

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

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

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

פרטי הפעלה

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

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

מבחינה טכנית, כל המאפיינים של פרטי ההפעלה שנתמכים בדוחות האלה הם אופציונליים. אם לא תכללו בבקשה מאפיינים של פרטי ההפעלה, הדוח שיוחזר יהיה דומה לאחד מהדוחות basic stats,‏ time-based או user geography.

הערה: אי אפשר להשתמש במאפיין 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
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
משתמשים ב-0 או ב-1 ‫country, ‏ continent, ‏ subContinent
אופציונלי 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
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
חובה province
אופציונלי subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מקורות תנועה

מקור תנועה

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
חובה insightTrafficSourceDetail
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר ‫engagedViews, ‏ views, ‏ estimatedMinutesWatched
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
חובה ‫insightTrafficSourceType (ראו הערה מתחת לטבלה)
משתמשים ב-0 או ב-1 ‫country, ‏ province, ‏ continent, ‏ subContinent
אפשר להשתמש ב-0 או יותר ‫liveOrOnDemand, ‏ subscribedStatus
אפשרויות מיון: -engagedViews
-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
מסננים:
שימוש בערך 1 בלבד ‫video,‏ channel,‏ group או שילוב נתמך של uploaderType ו-claimedStatus
משתמשים ב-0 או ב-1 ‫country, ‏ province, ‏ continent, ‏ subContinent
אפשר להשתמש ב-0 או יותר ‫operatingSystem, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct

מערכת הפעלה

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

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

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

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

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

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

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

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

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

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

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

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

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

שימור קהל

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר adImpressions
מסננים:
שימוש בערך 1 בלבד channel או שילוב נתמך של uploaderType ו-claimedStatus
משתמשים ב-0 או ב-1 ‫country, ‏ continent, ‏ subContinent
אפשרויות מיון: -engagedViews
-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
מסננים:
שימוש בערך 1 בלבד channel או שילוב נתמך של uploaderType ו-claimedStatus
חובה province
אפשרויות מיון: -engagedViews
-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
מסננים:
שימוש בערך 1 בלבד channel או שילוב נתמך של uploaderType ו-claimedStatus
אופציונלי subscribedStatus
משתמשים ב-0 או ב-1 ‫country, ‏ continent, ‏ subContinent
אפשרויות מיון: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

תוכן עניינים
מאפיינים:
חובה סרטון
אופציונלי creatorContentType
מדדים:
משתמשים ב-1 או יותר ‫engagedViews, ‏ views, ‏ redViews, ‏ estimatedMinutesWatched, ‏ estimatedRedMinutesWatched, ‏ averageViewDuration
מסננים:
שימוש בערך 1 בלבד channel או שילוב נתמך של uploaderType ו-claimedStatus
משתמשים ב-0 או ב-1 ‫country, ‏ province, ‏ continent, ‏ subContinent
אפשר להשתמש ב-0 או יותר ‫liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
אפשרויות מיון: -engagedViews
-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
מסננים:
שימוש ב-0 או ב-1* ‫playlist, ‏ group

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

מבוסס-זמן

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
משתמשים ב-0 או ב-1 ‫continent, ‏ subContinent
אופציונלי channel

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel
אפשרויות מיון: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

מקורות תנועה

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel
אפשרויות מיון: -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
מסננים:
שימוש ב-0 או ב-1* ‫playlist, ‏ group

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

מערכת הפעלה לפלייליסטים

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel

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

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

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

הערה: אם מבקשים בדוח את אחד מהמדדים views, ‏ estimatedMinutesWatched או averageViewDuration, צריך לציין בדיוק אחד מהמסננים האלה.
אופציונלי channel
הערה: הערכים של viewerPercentage בדוח הזה לא מנורמלים עבור ערכים שונים או שילובים שונים של ערכים של מאפייני פרטי ההפעלה (subscribedStatus ו-youtubeProduct).

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

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

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

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

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

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

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

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

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

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

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

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

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