Dimensions

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

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

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

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

מאפייני ליבה

אמנם ממשק YouTube Analytics API כפוף למדיניות ההוצאה משימוש שהוגדרה ב תנאים והגבלות, מאפיינים שאינם ליבה (ומדדים שאינם ליבה) אינם בכפוף למדיניות. בהגדרות שבדף הזה, כל מאפיין שהוא מאפיין ליבה זוהה במפורש ככזו.

ברשימה הבאה מפורטות מאפייני הליבה של ה-API.

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

מסננים

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

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

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

מידות

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

משאבים

המאפיינים האלה מתייחסים למשאבים שמנהלים ערוצים ובעלי תוכן ב-YouTube:

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

video (מאפיין ליבה)
המזהה של סרטון ב-YouTube. ב-YouTube Data API, זהו הערך של video של המשאב 'id'. This is a core dimension and is subject to the Deprecation Policy.
פלייליסט
המזהה של פלייליסט ב-YouTube. ב-YouTube Data API, זהו הערך של המאפיין id של משאב playlist.
channel (מאפיין ליבה) (משמש רק בדוחות של בעלי התוכן)
המזהה של ערוץ YouTube. ב-YouTube Data API, זהו הערך של המאפיין id של משאב channel. This is a core dimension and is subject to the Deprecation Policy.

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

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים או במסננים של ישויות הדיווח:

  • דוגמאות לערוצים

    • נתונים סטטיסטיים בסיסיים
      • 10 המובילים – הסרטונים הנצפים ביותר בערוץ
      • עשרת המובילים – שיעורי קליקים על הערות לסרטונים הנצפים ביותר בערוץ
      • נתונים סטטיסטיים לגבי פלייליסט ספציפי
      • 10 המובילים – הפלייליסטים הנצפים ביותר בערוץ
    • גיאוגרפי
      • 10 המובילים – הסרטונים הנצפים ביותר במדינה מסוימת
      • 10 המובילים – הסרטונים הנצפים ביותר באירופה

  • דוגמאות של בעלי התוכן

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

אזורים גיאוגרפיים

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

country [מדינה] (מאפיין ליבה)
המדינה שמשויכת למדדים בשורת הדוח. ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן ISO-3166-1, כמו US, CN (סין) או FR (צרפת). קוד המדינה ZZ משמש לדיווח על מדדים שעבורם המערכת של YouTube לא הצליחה לזהות את המדינה המשויכת. This is a core dimension and is subject to the Deprecation Policy.
province
המדינה או הטריטוריה בארה"ב שמשויכים למדדים בשורה בדוח. ערך המאפיין הוא קוד לפי תקן ISO 3166-2 שמזהה מדינה בארה"ב או מחוז קולומביה, למשל US-MI (מישיגן) או US-TX (טקסס). קוד המחוז US-ZZ משמש לדיווח על מדדים שעבורם המערכת של YouTube לא הצליחה לזהות את המדינה המשויכת בארה"ב. כשבקשת API כוללת את province בערך הפרמטר dimensions, הבקשה חייבת להגביל גם את הנתונים לארצות הברית על ידי הכללת country==US בערך הפרמטר filters.

הערה: המאפיין הזה לא תומך בערכי ISO 3166-2 שמזהים אזורים מרוחקים של ארה"ב, כי גם לאזורים האלה יש קודי מדינה לפי תקן ISO 3166-1. הוא גם לא תומך בחלוקות משנה של מדינות מחוץ לארה"ב.

dma
המזהה בן 3 הספרות שמשמש את Nielsen לזיהוי אזור השוק הייעודי (DMA) שמשויכים לאירועי הצפייה שמתוארים בשורת הנתונים.
city
העיר המשוערת שמשויכת למדדים בשורת הדוח. הנתונים של המאפיין הזה זמינים לתאריכים החל מ-1 בינואר 2022.
continent (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם (UN). ה-API תומך בערכים הבאים:
ערכים
002 אפריקה
019 אמריקה (צפון אמריקה, אמריקה הלטינית, דרום אמריקה והקריביים)
142 אסיה
150 אירופה
009 אוקיאניה
המאפיין הזה יכול לשמש רק לסינון נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את הערך של המאפיין הפרמטר filters של continent==REGION_CODE, מציין ערך של REGION_CODE מהטבלה.
subContinent (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם, שמזהה אזור משנה גיאוגרפי. המחלקה לסטטיסטיקה של האומות המאוחדות מפרטת אזורי משנה וכן המדינות שהיא משייכת לכל אזור.

המאפיין הזה יכול לשמש רק לסינון נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את הערך של הפרמטר filters כ-subContinent==REGION_CODE, ולציין ערך של REGION_CODE מהרשימה של UN.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים או במסננים גיאוגרפיים:

  • דוגמאות לערוצים

    • נתונים סטטיסטיים בסיסיים: ספירת צפיות ספציפית למדינה (ועוד) בערוץ
    • גיאוגרפי
      • מדדי זמן צפייה ספציפיים למדינה בסרטונים של ערוץ
      • מדדי הערות ספציפיים למדינה לגבי סרטונים בערוץ
      • מדדים ספציפיים לפרובינציה של מדינות בארה"ב ווושינגטון הבירה
      • מדדי זמן צפייה ספציפיים למדינה בפלייליסטים של ערוץ
      • 10 המובילים – הפלייליסטים המתחילים ביותר בארצות הברית
    • מיקום ההפעלה: מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
    • מקור תנועה: ספירת צפיות וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
    • דמוגרפיה: מידע דמוגרפי על צופים בקליפורניה (קבוצת גיל ומגדר)
    • סרטונים מובילים
      • 10 המובילים – הסרטונים הנצפים ביותר במדינה מסוימת
      • 10 המובילים – הסרטונים הנצפים ביותר באירופה

  • דוגמאות של בעלי התוכן

    • נתונים סטטיסטיים בסיסיים: ספירת צפיות ספציפית למדינה (ועוד) בכל הסרטונים שהעליתם בעצמכם
    • גיאוגרפי
      • מדדים של זמן צפייה בתוכן שהעליתם בעצמכם לפי מדינה
      • מדדי הערות ספציפיים למדינה לגבי תוכן בהעלאה עצמית
      • מדדים ספציפיים לפרובינציה של מדינות בארה"ב ווושינגטון הבירה
      • מדדי זמן צפייה ספציפיים למדינה בפלייליסטים של בעלי תוכן
      • 10 המובילים – הפלייליסטים המתחילים ביותר בארצות הברית
    • מיקום ההפעלה: מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
    • דמוגרפיה: מידע דמוגרפי על צופים בקליפורניה (קבוצת גיל ומגדר)
    • הסרטונים המובילים: 10 הסרטונים המובילים – הסרטונים הנצפים ביותר באירופה לבעלי תוכן
    • הכנסות/ביצועי מודעות: מדדים ספציפיים של הכנסות וביצועי מודעות לפי מדינה.

תקופות זמן

המאפיינים האלה מציינים שבדוח צריך לצבור נתונים לפי תקופה, כמו יום, שבוע או חודש. הפרמטרים של הבקשה startDate ו-endDate מציינים את תקופת הזמן שבה הדוח כולל נתונים. שימו לב שהדוח מחזיר בפועל נתונים עד ליום האחרון שעבורו כל המדדים שצוינו בבקשה זמינים בזמן השאילתה. בדוחות, התאריכים מפורטים בפורמט YYYY-MM-DD.

חשוב: כל התאריכים מתייחסים לתקופה שמתחילה בשעה 00:00 לפי שעון החוף המערבי (UTC-7 או UTC-8) ומסתיימת בשעה 23:59 לפי שעון החוף המערבי בארה"ב, ביום, בחודש ובשנה שצוינו. כתוצאה מכך, התאריכים שבהם השעונים מותאמים לשעון קיץ מייצגים תקופה של 23 שעות, והתאריכים שבהם משנים את השעון לאחור מייצגים פרק זמן של 25 שעות.

המאפיין חודש מתייחס לתקופה שמתחילה ב-00:00 לפי שעון החוף המערבי של ארה"ב (UTC-7 או UTC-8) ביום הראשון של החודש והשנה שצוינו.

day (מאפיין ליבה)
כשמשתמשים במאפיין הזה, הנתונים בדוח נצברים על בסיס יומי, וכל שורה מכילה נתונים מיום אחד. תוכלו להשתמש במאפיינים אחרים כדי להציג פירוט נוסף של הנתונים. לדוגמה, דוח מקורות התנועה יכול לצבור נתונים סטטיסטיים של צפיות יומיות על סמך האופן שבו משתמשים מגיעים לסרטונים שלכם. This is a core dimension and is subject to the Deprecation Policy.
month (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. בדומה לדוחות יומיים, ניתן להשתמש במסננים אחרים כדי לפלח עוד יותר את הנתונים. בדוח, התאריכים מפורטים בפורמט YYYY-MM.

הערה: אם בשאילתת ה-API שלך נעשה שימוש במאפיין month, צריך להגדיר את הפרמטרים start-date ו-end-date ליום הראשון בחודש. This is a core dimension and is subject to the Deprecation Policy.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים או במסננים של זמן:

  • דוגמאות לערוצים

    • מבוסס-זמן
      • מדדים יומיים של זמן צפייה בסרטונים בערוץ
      • מדדים יומיים של הערות לסרטונים בערוץ
      • צפיות יומיות בפלייליסט של ערוץ
    • מיקום ההפעלה: מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
    • מקור תנועה: ספירות צפיות יומיות וזמן צפייה ממקורות תנועה שונים
    • מכשיר/מערכת הפעלה
      • מדדים יומיים של סוגי מכשירים במערכת ההפעלה Android
      • מדדים יומיים של מערכת ההפעלה לגבי מכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי מכשירים

  • דוגמאות של בעלי התוכן

    • מבוסס-זמן
      • מדדים יומיים של זמן צפייה בתוכן שהעליתם בעצמכם
      • מדדי הערות לתוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
      • צפיות יומיות בפלייליסט של בעלי התוכן
    • מיקום ההפעלה: מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
    • מקור תנועה: ספירות צפיות יומיות וזמן צפייה ממקורות תנועה שונים
    • מכשיר/מערכת הפעלה
      • מדדים יומיים של סוגי מכשירים בסרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים
      • מדדים יומיים של מערכת ההפעלה עבור סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים ונצפו במכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי מכשירים
    • הכנסות/ביצועי מודעות: מדדים של הכנסה יומית וביצועי מודעות

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

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

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

  • BROWSE – הנתונים מתארים צפיות בדף הבית או במסך הבית של YouTube, בפיד המינויים של המשתמש או בתכונת גלישה אחרת ב-YouTube.

  • CHANNEL – הנתונים מתארים צפיות שהתרחשו בדף ערוץ.

  • EMBEDDED – הנתונים מתארים צפיות שהתרחשו באתר או באפליקציה אחרים שבהם הסרטון הוטמע באמצעות הטמעה של <iframe> או <object>.

  • EXTERNAL_APP – הנתונים מתארים צפיות שהתרחשו באפליקציה של צד שלישי שבה הסרטון הופעל בשיטה שונה מהטמעה של <iframe> או <object>. לדוגמה, הפעלות באפליקציות שמשתמשות ב-YouTube Android Player API יסווגו לפי הערך הזה.

  • MOBILE – הנתונים מתארים צפיות באתר לנייד של YouTube או בלקוחות YouTube API מאושרים, כולל מכשירים ניידים.

    החל מ-10 בספטמבר 2013, ההפעלות כבר לא מסווגות בתור MOBILE הפעלות בדוחות של YouTube Analytics. הערך עשוי להישאר בדוחות כי נתונים קודמים עדיין משתייכים לקטגוריה הזו. עם זאת, לאחר התאריך הזה, הפעלות בנייד יסווגו כהפעלות WATCH, EMBEDDED או EXTERNAL_APP, בהתאם לסוג האפליקציה שבה מתרחשות ההפעלות.

  • SEARCH – הנתונים מתארים צפיות שהתרחשו ישירות בדף תוצאות החיפוש ב-YouTube.

  • WATCH – הנתונים מתארים צפיות בדף הצפייה של הסרטון ב-YouTube או באפליקציה רשמית של YouTube, כמו אפליקציית YouTube ל-Android.

  • YT_OTHER – הנתונים מתארים צפיות שלא מסווגות אחרת.

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

דוגמאות

הבקשות לדוגמה הבאות משתמשות במימדים של מיקום ההפעלה:

  • דוגמאות לערוצים

    • מקומות שבהם הסרטון הופעל
      • ספירת צפיות וזמן צפייה ממיקומי הפעלה שונים
      • ספירת צפיות יומית וזמן צפייה ממיקומי הפעלה שונים
      • 10 המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגבוה ביותר בסרטון מוטמע
      • ספירת צפיות בפלייליסט וזמן צפייה ממיקומי הפעלה שונים
      • ספירת צפיות יומית בפלייליסט וזמן צפייה ממיקומי הפעלה שונים

  • דוגמאות של בעלי התוכן

    • מקומות שבהם הסרטון הופעל
      • ספירת צפיות וזמן צפייה ממיקומי הפעלה שונים
      • ספירת צפיות יומית וזמן צפייה ממיקומי הפעלה שונים
      • 10 המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגבוה ביותר בסרטון מוטמע
      • ספירת צפיות בפלייליסט וזמן צפייה ממיקומי הפעלה שונים
      • ספירת צפיות יומית בפלייליסט וזמן צפייה ממיקומי הפעלה שונים

פרטי ההפעלה

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

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
LIVE_STREAM התוכן שנצפה היה שידור חי ב-YouTube.
SHORTS התוכן שנצפה היה סרטון YouTube Shorts.
STORY התוכן שנצפה היה סטורי ב-YouTube.
VIDEO_ON_DEMAND התוכן שנצפה היה סרטון YouTube שלא משתייך לאחד מערכי המאפיינים האחרים.
UNSPECIFIED סוג התוכן של התוכן שנצפה לא ידוע.
liveOrOnDemand
המאפיין הזה מציין אם מדדי פעילות המשתמש בשורת הנתונים משויכים לצפיות בשידור חי. הנתונים של המאפיין הזה זמינים לתאריכים החל מ-1 באפריל 2014.

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
LIVE נתוני השורה מתארים פעילות משתמש שהתרחשה במהלך שידור חי.
ON_DEMAND נתוני השורה מתארים פעילות משתמש שלא התרחשה במהלך שידור חי.
subscribedStatus
המאפיין הזה מציין אם מדדי פעילות המשתמשים בשורת הנתונים משויכים לצופים שנרשמו כמנויים לערוץ של הסרטון או הפלייליסט. הערכים האפשריים הם SUBSCRIBED ו-UNSUBSCRIBED.

חשוב לשים לב שהערך של המאפיין מדויק נכון לזמן שבו מתרחשת פעילות המשתמש. לדוגמה, נניח שמשתמש לא נרשם לערוץ וצופה באחד מהסרטונים של אותו ערוץ, ואז נרשם לערוץ וצופה בסרטון אחר. כל זאת באותו יום. דוח הערוץ מציין שצפייה אחת כוללת subscribedStatus ערך של SUBSCRIBED, ושל צפייה אחת יש subscribedStatus ערך של UNSUBSCRIBED.
youtubeProduct
מאפיין זה מזהה את שירות YouTube שבו התרחשה פעילות המשתמש. הנתונים של המאפיין הזה זמינים החל מ-18 ביולי 2015.

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
CORE פעילות משתמש שלא התרחשה באחת מהאפליקציות המיוחדות של YouTube (YouTube Gaming, YouTube Kids או YouTube Music). חריג: פעילות משתמשים שהתרחשה ב-YouTube Music לפני 1 במרץ 2021 נכללת בCORE.
GAMING פעילות המשתמש התרחשה ב-YouTube Gaming.
KIDS פעילות המשתמש התרחשה ב-YouTube Kids.
MUSIC פעילות המשתמש התרחשה ב-YouTube Music ב-1 במרץ 2021 או לאחר מכן. נתונים מלפני 1 במרץ 2021 כלולים ב-CORE. נתונים בזמן אמת לא מתועדים.
UNKNOWN פעילות המשתמש התרחשה לפני 18 ביולי 2015.

מקורות תנועה

insightTrafficSourceType
הנתונים בדוח נצברים על סמך סוג הגורם המפנה, שמתאר את האופן שבו המשתמשים הגיעו לסרטון. ערכים אפשריים למאפיין הזה הם:
  • ADVERTISING – פרסומת הפנתה את הצופה לסרטון. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מזהה את סוג המודעה.
  • ANNOTATION – הצופים הגיעו לסרטון אחרי שלחצו על הערה בסרטון אחר.
  • CAMPAIGN_CARD – הצפיות הגיעו מסרטונים שהעלו משתמשים והצהירו על זכויות יוצרים בהם, ובעלי התוכן השתמשו בהם כדי לקדם את התוכן שנצפה. מקור התנועה הזה נתמך רק בדוחות של בעלי התוכן.
  • END_SCREEN – הצפיות הופנו ממסך הסיום של סרטון אחר.
  • EXT_URL – הצפיות בסרטונים הופנו מקישור באתר אחר. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מזהה את דף האינטרנט. מקור התנועה הזה כולל הפניות מתוצאות חיפוש ב-Google.
  • HASHTAGS – הצפיות הגיעו מדפי hashtag של VOD או מדפי מעבר ב-hashtag של Shorts.
  • LIVE_REDIRECT – הצפיות בסרטונים הופנו מהפניות אוטומטיות בזמן אמת.
  • NO_LINK_EMBEDDED – הסרטון הוטמע באתר אחר בזמן הצפייה בו.
  • NO_LINK_OTHER – המערכת של YouTube לא זיהתה גורם מפנה לתנועה. קטגוריה זו כוללת תנועה ישירה לסרטון, וכן תנועה באפליקציות לנייד.
  • NOTIFICATION – הצפיות בסרטונים הופנו מאימייל או מהתראה מ-YouTube.
  • PLAYLIST – הצפיות בסרטון התרחשו בזמן שהסרטון הופעל כחלק מפלייליסט. הנתון הזה כולל תנועה שמגיעה מדף הפלייליסט.
  • PRODUCT_PAGE – הצפיות בסרטונים הופנו מדף מוצר.
  • PROMOTED – הצפיות בסרטון הופנו מקידום מכירות ב-YouTube ללא תשלום, כגון 'סרטונים מומלצים' ב-YouTube הדף הזה.
  • RELATED_VIDEO – הצפיות בסרטונים הופנו מדף פרטי של סרטון קשור בדף צפייה אחר של סרטון. אם מסננים לפי מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את מזהה הסרטון של הסרטון.
  • SHORTS – הפנה את הצופה על ידי החלקה אנכית מהסרטון הקודם בחוויית הצפייה ב-Shorts.
  • SOUND_PAGE – הצפיות הגיעו מדפי צירי אודיו של סרטוני Shorts.
  • SUBSCRIBER – הצפיות בסרטונים הופנו מפידים בדף הבית של YouTube או מתכונות המינויים של YouTube. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את הפריטים בפיד של דף הבית או דף אחר שממנו הופנו לצפיות.
  • YT_CHANNEL – הצפיות בסרטון התרחשו בדף הערוץ. אם מסננים לפי מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את מזהה הערוץ של הערוץ.
  • YT_OTHER_PAGE – הצפיות בסרטון הופנו מקישור שאינו תוצאת חיפוש או קישור לסרטון קשור שהופיעו בדף של YouTube. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מזהה את הדף.
  • YT_SEARCH – הצפיות בסרטונים הופנו מתוצאות החיפוש ב-YouTube. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את מונח החיפוש.
  • VIDEO_REMIXES – הצפיות בסרטונים הופנו דרך הקישור לסרטון שעבר רמיקס בנגן Shorts. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את הסרטון שממנו הופנה הצופה.
insightTrafficSourceDetail
הנתונים בדוח נצברים על סמך הגורמים המפנים שהניבו את מספר הצפיות הגדול ביותר בסרטון מסוים, ועל סמך סוג מקור התנועה שצוין. ברשימה הבאה מפורטים מקורות התנועה שעבורם הדוח הזה זמין. הרשימה מזהה את המידע שהמאפיין insightTrafficSourceDetail מספק לכל מקור תנועה.
  • ADVERTISING – סוג הפרסומת שהובילה לצפיות. הערכים האפשריים הם:
    • מודעה אינטראקטיבית מסוג 'קליק להפעלה'
    • מודעה שיוצרת מעורבות
    • מודעות לרשת החיפוש של Google
    • מודעת סרטון בדף הבית
    • מודעות וידאו In-stream שמורות שניתן לדלג עליהן
    • TrueView בחיפוש וברשת המדיה
    • TrueView בתוך ההפעלה
    • פרסום ב-YouTube ללא שיוך לקטגוריה
    • קיר סרטונים
  • CAMPAIGN_CARD – הסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים שהוביל צופים לסרטון שזוהה בדוח.
  • END_SCREEN – הסרטון שהוביל צופים לסרטון שזוהה בדוח.
  • EXT_URL – האתר שהפנה את הצופים לסרטון.
  • HASHTAGS – ה-hashtag שהוביל לצפיות.
  • NOTIFICATION – האימייל או ההתראה שהפנו את התנועה.
  • RELATED_VIDEO – הסרטון הקשור שהוביל את הצופים לסרטון שנכלל בדוח.
  • SOUND_PAGE – הסרטון שהוביל לצפיות.
  • SUBSCRIBER – הפריט בפיד של דף הבית או תכונת המינוי ל-YouTube שהובילה את הצופים לסרטון שנכלל בדוח. הערכים החוקיים הם:
    • activity – צפיות מפריטים בפידים של מינויים בדף הבית, שנבעו מפעילות ערוץ ללא העלאות ובערוצים שאינם רשתות חברתיות, כולל לייקים, מועדפים, פוסטים במבזקים והוספות לפלייליסטים.
    • blogged – צפיות מפריטים בפידים של המינויים בדף הבית שנבעו מקישורים מבלוגים מובילים.
    • mychannel – צפיות מפריטים בפידים אחרים שרשומים בדף הבית, כמו 'לייקים', "היסטוריית צפייה," ו"לצפייה בהמשך".
    • podcasts – צפיות שמגיעות מפריטים בדף היעד של פודקאסטים.
    • sdig – צפיות שמגיעות מאימיילים לגבי עדכונים של מינויים.
    • uploaded – צפיות מ-uploaded הפריטים בפידים של המינויים של דף הבית.
    • / – צפיות אחרות שמקורן בדף הבית של YouTube.
    • /my_subscriptions – צפיות שמגיעות ממשתמשים הדפים המינויים שלי ב-YouTube.
  • YT_CHANNEL – דף הערוץ שבו אנשים צפו בסרטון.
  • YT_OTHER_PAGE – הדף ב-YouTube שממנו הצופים הופנו לסרטון.
  • YT_SEARCH – מונח החיפוש שהוביל צופים לסרטון.
  • VIDEO_REMIXES – הסרטון שהוביל לצפיות.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים של מקורות תנועה:

  • דוגמאות לערוצים

    • מקור תנועה
      • ספירת צפיות וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
      • ספירות צפיות יומיות וזמן צפייה ממקורות תנועה שונים
      • עשרת המובילים – מונחי חיפוש ב-YouTube שמושכים את מירב התנועה לסרטון
      • 10 המובילים – מונחי חיפוש ב-Google שמושכים הכי הרבה תנועה לסרטון
      • ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
      • ספירת צפיות יומית בפלייליסט וזמן צפייה ממקורות תנועה שונים

  • דוגמאות של בעלי התוכן

    • מקור תנועה
      • ספירת צפיות וזמן צפייה ממקורות תנועה שונים
      • ספירות צפיות יומיות וזמן צפייה ממקורות תנועה שונים
      • עשרת המובילים – מונחי חיפוש ב-YouTube שמושכים את מירב התנועה לסרטון
      • 10 המובילים – מונחי חיפוש ב-Google שמושכים הכי הרבה תנועה לסרטון
      • ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
      • ספירת צפיות יומית בפלייליסט וזמן צפייה ממקורות תנועה שונים

מכשירים

deviceType
מאפיין זה מזהה את גורם הצורה הפיזי של המכשיר שבו התרחשה הצפייה. ברשימה הבאה מפורטים סוגי המכשירים שעבורם ה-API מחזיר נתונים. אפשר גם להשתמש במאפיין deviceType כמסנן כדי להגביל את הדוח של מערכת ההפעלה כך שיכלול נתונים רק לגבי סוג מסוים של מכשיר.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
המאפיין הזה מזהה את מערכת התוכנה במכשיר שבו התרחשה הצפייה. ברשימה הבאה מפורטות מערכות ההפעלה שעבורן ה-API מחזיר נתונים. אפשר גם להשתמש ב-operatingSystem כמסנן כדי להגביל דוח של סוגי מכשירים כך שיכלול נתונים רק לגבי מערכת הפעלה מסוימת.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

דוגמאות

הבקשות לדוגמה הבאות משתמשות במידות המכשיר:

  • דוגמאות לערוצים

    • מכשיר/מערכת הפעלה
      • מדדים יומיים של סוגי מכשירים במערכת ההפעלה Android
      • מדדים יומיים של מערכת ההפעלה לגבי מכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי מכשירים
      • מדדים יומיים של סוגי מכשירים לגבי צפיות בפלייליסט במערכת ההפעלה של Android
      • מדדים יומיים של מערכת ההפעלה לגבי צפיות בפלייליסט במכשירים ניידים

  • דוגמאות של בעלי התוכן

    • מכשיר/מערכת הפעלה
      • מדדים יומיים של סוגי מכשירים בסרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים
      • מדדים יומיים של מערכת ההפעלה עבור סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים ונצפו במכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי מכשירים
      • מדדים יומיים של סוגי מכשירים לגבי צפיות בפלייליסט במערכת ההפעלה של Android
      • מדדים יומיים של מערכת ההפעלה לגבי צפיות בפלייליסט במכשירים ניידים

דמוגרפיה

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

ageGroup (מאפיין ליבה)
המאפיין הזה מזהה את קבוצת הגיל של המשתמשים המחוברים המשויכים לנתוני הדוח. ה-API משתמש בקבוצות הגיל הבאות:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (מאפיין ליבה)
המאפיין הזה מזהה את המגדר של המשתמשים המחוברים ומשויכים לנתוני הדוח. הערכים החוקיים הם female, male ו-user_specified. This is a core dimension and is subject to the Deprecation Policy.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים דמוגרפיים:

  • דוגמאות לערוצים

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

  • דוגמאות של בעלי התוכן

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

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

sharingService (מאפיין ליבה)
מאפיין זה מזהה את השירות ששימש לשיתוף סרטונים. ניתן לשתף סרטונים ב-YouTube (או באמצעות הנגן של YouTube) באמצעות האפשרות "שיתוף" לחצן. This is a core dimension and is subject to the Deprecation Policy.

בטבלה הבאה מפורטים ערכים חוקיים של מאפיינים:
שירות שיתוף ערך API
Ameba AMEBA
אימייל Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
העברת הודעות ב-Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
העתק ללוח COPY_PASTE
עולם הים CYWORLD
Digg DIGG
Dropbox DROPBOX
הטמעה EMBED
אימייל MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
דפי Facebook FACEBOOK_PAGES
פוטקה FOTKA
Gmail GMAIL
goo, גו GOO
Google+‎ GOOGLEPLUS
שליחת SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
הודעת טקסט של HTC HTC_MMS
תיבת הדואר הנכנס של Google INBOX
תיבת דו-שיח של הפעילות במערכת iOS IOS_SYSTEM_ACTIVITY_DIALOG
סיפור ב-KAKAO KAKAO_STORY
קקאו (קקאו דיבור) KAKAO
Kik KIK
אימייל LGE LGE_EMAIL
קו LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
תפריט MENEAME
mixi MIXI
העברת הודעות ב-Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
שיתוף בקרבת מקום NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
אחר OTHER
Pinterest PINTEREST
Rakuten (楽天 שולחים場) RAKUTEN
reddit, רדיט, ראדיט REDDIT
Skype SKYPE
Skyrock SKYBLOG
שיחות של Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
טלגרם TELEGRAM
הודעת טקסט TEXT_MESSAGE
Tuenti TUENTI
טמבלר. TUMBLR
Twitter TWITTER
לא ידוע UNKNOWN
הודעות Verizon VERIZON_MMS
Viber VIBER
VKontakte (Вонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo!‎ יפן YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

למידע נוסף, אפשר לעיין במסמכי העזרה.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים חברתיים:

  • דוגמאות לערוצים

  • דוגמאות של בעלי התוכן

שימור קהל

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

ה-API מחזיר 100 נקודות על הגרף לכל סרטון עם ערכי יחס בטווח שבין 0.01 ל-1.0. הזמנים שבהם הנתונים נמדדים במהלך הפעלות סרטונים מרווחים באופן שווה לכל סרטון. כלומר, עבור סרטון באורך שתי דקות, המרווח בין נקודות על הגרף הוא 1.2 שניות. עם זאת, בסרטון של שעתיים, המרווח בין נקודות על הגרף הוא 72 שניות. ערך המאפיין מציין את הסוף הבלעדי של המרווח.
audienceType (מסנן בלבד)
ערך המאפיין מזהה את סוג התנועה המשויכת לנתוני הדוח. הערכים הנתמכים הם ORGANIC, AD_INSTREAM ו-AD_INDISPLAY. במרכז העזרה של YouTube יש הסברים על סוגי מקורות התנועה האלה.

לתשומת ליבך: הנתונים של המסנן audienceType זמינים החל מ-25 בספטמבר 2013. ה-API לא מחזיר נתונים לשאילתות שבהן נעשה שימוש במסנן כדי לנסות לאחזר נתונים מתאריכים מוקדמים יותר. שאילתות שלא משתמשות במסנן פועלות באף תאריך אחרי 1 ביולי 2008.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים של שימור קהל:

  • דוגמאות לערוצים

  • דוגמאות של בעלי התוכן

סטרימינג בשידור חי

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

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

membershipsCancellationSurveyReason
מספר הסקרים שהושלמו על ידי משתמשי YouTube שביטלו את החברות שלהם במועדון של הערוץ עבור ערוץ ספציפי במהלך תקופת הדיווח. בטבלה הבאה מפורטים ערכים חוקיים של מאפיינים:
ערך API הסבר
UNKNOWN המשתמש לא השלים את הסקר.
DISLIKE_PERKS המשתמש לא אהב את ההטבות של החברות במועדון.
PERKS_NOT_DELIVERED המשתמש אמר שההטבות שהובטחו לחברי המועדון לא התקבלו.
CANNOT_ACCESS_PERKS המשתמש לא הצליח לגשת להטבות.
NO_LONGER_INTERESTED המשתמש כבר לא מעוניין במועדון החברים של הערוץ.
FEEL_UNAPPRECIATED המשתמש לא הרגיש שהוא לא מעריכים את החברות במועדון של הערוץ.
FINANCIAL_REASONS המשתמש ביטל מסיבות כספיות.
JOIN_LIMITED_TIME המשתמש התכוון להצטרף רק לזמן מוגבל.
OTHER למשתמש הייתה סיבה נוספת לביטול.

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

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

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

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

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

  • auctionTrueviewInslate – הצופה בוחר אחת מתוך כמה מודעות וידאו מתוך מגוון האפשרויות שמוצגות לפני הסרטון. See the TrueView documentation for more information.

  • auctionTrueviewInstream – מודעות וידאו שניתן לדלג עליהן שמוצגות לפני או במהלך הסרטון הראשי. מידע נוסף זמין במסמכי התיעוד בנושא TrueView.

  • auctionUnknown – מודעה שנרכשה דרך המכרז של Google Ads אבל לא סווגה לאחד מסוגי המודעות האחרים.

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

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

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

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

  • reservedInstreamSelect

  • reservedMasthead – מודעה גדולה, שיכולה לכלול רכיבי וידאו וגרפיקה, שמופיעה בדף הבית.

  • reservedUnknown – מודעה שנמכרה על בסיס שמור שלא ניתן לסווג לאחד מסוגי המודעות האחרים.

  • unknown – המערכת של YouTube לא הצליחה לסווג את סוג המודעה הזה.

דוגמאות

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

  • דוגמאות לערוצים

    • הכנסות/מודעות
      • המדדים של הכנסות הערוץ וביצועי המודעות
      • הכנסות יומיות ומדדים של ביצועי מודעות
      • מדדים ספציפיים למדינה של הכנסות וביצועי מודעות
      • 10 המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
      • מדדי ביצועים של מודעות לסוגים שונים של מודעות

  • דוגמאות של בעלי התוכן

    • הכנסות/מודעות
      • מדדים של ביצועי מודעות והכנסות לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
      • הכנסות יומיות ומדדים של ביצועי מודעות
      • מדדים ספציפיים למדינה של הכנסות וביצועי מודעות
      • 10 המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
      • מדדי ביצועים של מודעות לסוגים שונים של מודעות

פלייליסטים

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

דוגמאות

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

המאפיינים של בעלי התוכן

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

חשוב: בקשות API לאחזור דוחות של בעלי תוכן חייבות לסנן נתונים לפי אחד מהמאפיינים הבאים:
  • video
  • channel
  • שילוב נתמך של המאפיינים claimedStatus ו-uploaderType כפי שמוגדר בהמשך.
שהוגשה לגביו תלונה על הפרת זכויות יוצרים (משמש רק בדוחות של בעלי התוכן)
המאפיין הזה מאפשר לך לציין שתגובת API צריכה להכיל מדדים רק לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים. הערך החוקי היחיד למאפיין הזה הוא claimed. אם הפרמטר filters מגביל את השאילתה ל-claimedStatus==claimed, ה-API יאחזר נתונים רק לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים. הטבלה בהגדרה של המאפיין uploaderType מספקת פרטים נוספים על אופן השימוש במאפיין הזה.
UploadType (מאפיין ליבה) (משמש רק בדוחות של בעלי התוכן)
המאפיין הזה מאפשר לך לציין אם תגובת API צריכה להכיל מדדים לגבי תוכן שהועלה על ידי בעלי התוכן שצוין ו/או תוכן שהועלה על ידי גורמי צד שלישי, כמו סרטונים שהועלו על ידי משתמשים. הערכים החוקיים הם self ו-thirdParty. זהו מאפיין ליבה והוא כפוף למדיניות בנושא הוצאה משימוש.

בטבלה שבהמשך מוצגים השילובים הנתמכים של המאפיינים claimedStatus ו-uploaderType, שנעשה בהם שימוש שניהם בפרמטר filters:

ערך של claimedStatus ערך של uploaderType תיאור
[לא מוגדר] עצמי אחזור נתונים של YouTube Analytics לגבי תוכן שהועלה על ידי בעלי התוכן ולא נתבעה עליו בעלות.
הוגשה דרישת בעלות [לא מוגדר] אחזור נתונים לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלו על ידי בעלי התוכן או על ידי צד שלישי.
הוגשה דרישת בעלות עצמי אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלו על ידי בעלי התוכן.
הוגשה דרישת בעלות thirdParty אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, והועלה על ידי צד שלישי.

דוגמאות

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