YouTube Analytics API: Channel Reports

אנחנו מוציאים משימוש את המאפיינים 7DayTotals ו-30DayTotals. אפשר לקרוא פרטים נוספים בהיסטוריית הגרסאות.

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

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

אחזור דוח

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

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

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

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

הרשאה

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

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

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

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

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

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
[ללא]
מדדים:
יש להשתמש באחד או יותר במצבים של ערוץ 2 שלד מציעיםד קהלדד מציעיםד מציעים צפייה בנושאים בסרטונים בנוסף של למצבים כזו של כן כן כן כן כן כן כן ההודעה שלו כ שלו אפשר יהיה אפשר אפשר כדאי בסרטונים של כדאי בסרטונים אפשר צריך אפשר בסרטונים אפשר אפשר אפשר צריך לעשות אפשר לעשות לעשות לעשות
מסננים:
יש להשתמש ב-0 או 1 country, יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה

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

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

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

מבוססת זמן

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

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

תוכן עניינים
מאפיינים:
שימוש בערך 1 day , month
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר במצב מתאים ק
מסננים:
יש להשתמש ב-0 או 1 country, יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש country
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר במצבים של ערוץ 2 שלד מציעיםד קהלדד מציעיםד מציעים צפייה בנושאים בסרטונים בנוסף של למצבים כזו של כן כן כן כן כן כן כן ההודעה שלו כ שלו אפשר יהיה אפשר אפשר כדאי בסרטונים של כדאי בסרטונים אפשר צריך אפשר בסרטונים אפשר אפשר אפשר צריך לעשות אפשר לעשות לעשות לעשות
מסננים:
יש להשתמש ב-0 או 1 יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה

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

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

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

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

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

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

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

הערה: אם תכללו את המאפיין מחוז, תצטרכו להשתמש גם במסנן country==US.
יש להשתמש ב-0 או 1 day, month
מדדים:
יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched, dailyViewDuration, הממוצעViewPercentage
מסננים:
יש להשתמש ב-0 או 1 מדינה, מחוז, יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה
אפשרויות מיון: -צפיות
-estimatedMinutesWatched

פרטי ההפעלה

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

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

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

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

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

תוכן עניינים
מאפיינים:
צריך להזין 0 או יותר creatorContentType, subscribedStatus
יש להשתמש ב-0 או 1 day , month
מדדים:
יש להשתמש באחד או יותר 1111ים של התוכנית התוכנית כזה רמת המוצר המוצר ' המאפיינים בשל בשל בשל התכונה התכונה המוצר ' המאפיינים for כש בצד בשל בשל בשל המכירות נו שוק נתונים כ החל כ החל כ לד החל כ היעד היעד או היעד רשימת או של החל של החל של התוכניות החל של החל של או כ רשימת או של החל החל כ של עוד החל של של או של לחץ או אור ודאור. של של של של של. של. בקטגוריה. בקטגוריה. בקטגוריה. דרוש. הייתה. הייתה. ודא בחר בחר בחר של לחץ שלך לחץ ודא כ בחר כ הרישום ודאו התכונה 1 1 1 החל של החל של שצוין התוכנית שצוין החל החל החל נותנים של שהוספת כ ערוץ כ אפליקציה כ פרקים המתאים המתאים פורמט המתאים כ המוצר המתאים המוצר המתאים כ המוצר המתאים המוצר המתאים ודאו המתאים for הפעלה באזור שצוין בשל התוכנית ודאו בשל בשל בשל התוכנית התוכנית בחרו בחרו אפליקציה בחרו בחרו החל החל בחר שוק החל החל אפליקציה ודאו ודאו בשבילך
מסננים:
יש להשתמש ב-0 או 1 country, יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה
אופציונלי סטטוס מנוי

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מיקומי הפעלה

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש insightplayLocationDetail
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched
מסננים:
נדרש insightplayLocationType==EMBEDDED
יש להשתמש ב-0 או 1 מדינה, מחוז, יבשת, subContinent
יש להשתמש ב-0 או 1 סרטון, קבוצה
צריך להזין 0 או יותר liveOrOnDemand, subscribedStatus
אפשרויות מיון: -צפיות
-estimatedMinutesWatched

מקורות תנועה

מקור תנועה

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

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

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

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

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

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

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

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

סוג מכשיר

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

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

מערכת הפעלה

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

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

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

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

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

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

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

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

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

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

אינטראקציה ראשונית ושיתוף תוכן

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

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

שימור קהל

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש סרטון
אופציונלי creatorContentType
מדדים:
יש להשתמש באחד או יותר במצבים של ערוץ 2 שלד מציעיםד קהלדד מציעיםד מציעים צפייה בנושאים בסרטונים בנוסף של למצבים כזו של כן כן כן כן כן כן כן ההודעה שלו כ שלו אפשר יהיה אפשר אפשר כדאי בסרטונים של כדאי בסרטונים אפשר צריך אפשר בסרטונים אפשר אפשר אפשר צריך לעשות אפשר לעשות לעשות לעשות
מסננים:
יש להשתמש ב-0 או 1 country, יבשת, subContinent
אפשרויות מיון: -צפיות
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-מנויים שעזבו

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מבוססת זמן

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

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש province
צריך להזין 0 או יותר subscribedStatus, youtubeProduct
מדדים:
יש להשתמש באחד או יותר צפיות, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, dailyViewDuration, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
מסננים:
נדרש isCurate==1;country==US
יש להשתמש ב-0 או 1 פלייליסט, קבוצה
צריך להזין 0 או יותר subscribedStatus , youtubeProduct

מיקומי הפעלה

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש insightplayLocationDetail
מדדים:
יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
מסננים:
נדרש isCurate==1;insightPlayLocationType==EMBEDDED
יש להשתמש ב-0 או 1 מדינה, מחוז, יבשת, subContinent
יש להשתמש ב-0 או 1 פלייליסט, קבוצה
אופציונלי סטטוס מנוי
אפשרויות מיון: -צפיות
-estimatedMinutesWatched
-playlistStarts

מקורות תנועה

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש insightTrafficSourceDetail
מדדים:
יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, AverageTimeInPlaylist
מסננים:
נדרש isCurate==1;insightTrafficSourceType
יש להשתמש ב-0 או 1 מדינה, מחוז, יבשת, subContinent
יש להשתמש ב-0 או 1 פלייליסט, קבוצה
אופציונלי סטטוס מנוי
אפשרויות מיון: -צפיות
-estimatedMinutesWatched
-playlistStarts

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

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

סוג מכשיר

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

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

מערכת הפעלה

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

תוכן עניינים
מאפיינים:
נדרש adType
אופציונלי day
מדדים:
יש להשתמש באחד או יותר grossRevenue, adimpression, cpm
מסננים:
יש להשתמש ב-0 או 1 סרטון, קבוצה
יש להשתמש ב-0 או 1 country, יבשת, subContinent