Dimensions

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

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

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

כדי לאחזר דוח של שאילתה, צריך לקרוא לשיטה 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, זהו הערך של המאפיין id של משאב video. This is a core dimension and is subject to the Deprecation Policy.
playlist
המזהה של פלייליסט ב-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 המובילים – הפלייליסטים הנצפים ביותר בערוץ
    • גיאוגרפי
      • Top 10 – הסרטונים שצברו הכי הרבה צפיות במדינה ספציפית
      • 10 המובילים – הסרטונים הנצפים ביותר באירופה

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

    • נתונים סטטיסטיים בסיסיים
      • 10 המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • 10 המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • 10 המובילים – הסרטונים הנצפים ביותר בערוץ של בעלי התוכן
      • 10 המובילים – שיעור הקליקים על ההערות בסרטונים הנצפים ביותר בערוץ
      • Top 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 מרשימת האומות המאוחדות.

דוגמאות

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

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

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

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

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

תקופות זמן

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

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

המאפיין month מתייחס לתקופה שמתחילה בשעה 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 ללא תשלום, כמו הדף 'סרטוני Spotlight' ב-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
    • מודעת סרטון בדף הבית
    • מודעות וידאו שמורות בסרטון שניתן לדלג עליהן
    • TrueView בחיפוש וברשת המדיה
    • TrueView בתוך ההפעלה
    • פרסום ב-YouTube ללא שיוך לקטגוריה
    • קיר סרטונים
  • CAMPAIGN_CARD – הסרטון שהוגשה לגביו תלונה ועל סמך הצפייה בו הצופים הגיעו לסרטון שצוין בדוח.
  • END_SCREEN – הסרטון שהוביל את הצופים לסרטון שצוין בדוח.
  • EXT_URL – האתר שהפנה את הצופים לסרטון.
  • HASHTAGS – ה-hashtag שהוביל לצפיות.
  • NOTIFICATION – האימייל או ההתראה שהפנו את התנועה.
  • RELATED_VIDEO – הסרטון הקשור שהוביל את הצופים לסרטון שמצוין בדוח.
  • SOUND_PAGE – הסרטון שהוביל לצפיות.
  • SUBSCRIBER – פריט הפיד בדף הבית או תכונת המינוי ב-YouTube שהובילו את הצופים לסרטון שמתואר בדוח. הערכים התקינים הם:
    • activity – צפיות מפריטים בעדכוני המינויים של דף הבית שנבעו מפעילות ערוץ ללא העלאות ושאינו חברתי, כולל לייקים, מועדפים, פרסום מבזקים והוספת פלייליסטים.
    • blogged – צפיות מפריטים בפידים של המינויים בדף הבית שנבעו מקישורים מבלוגים מובילים.
    • mychannel – צפיות מפריטים בפידים אחרים שמופיעים בדף הבית, כמו 'סרטונים שאהבתי', 'היסטוריית הצפייה' ו'לצפייה בהמשך'.
    • podcasts – צפיות שמקורן בפריטים בדף היעד של Podcasts.
    • sdig – צפיות שמקורן באימיילים עם עדכונים לגבי מינויים.
    • uploaded – צפיות מ-uploaded פריטים בפידים של המינויים בדף הבית.
    • / – צפיות אחרות שמקורן בדף הבית של YouTube.
    • /my_subscriptions – צפיות שמקורן בדפים המינויים שלי של המשתמשים ב-YouTube.
  • YT_CHANNEL – דף הערוץ שבו הצופים צפו בסרטון.
  • YT_OTHER_PAGE – הדף ב-YouTube שממנו הצופים הופנו לסרטון.
  • YT_SEARCH – מונח החיפוש שהובילו צופים אל הסרטון.
  • VIDEO_REMIXES – הסרטון שהוביל לצפיות.

דוגמאות

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

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

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

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

    • מקור תנועה
      • מספר הצפיות וזמן הצפייה ממקורות תנועה שונים
      • מספר הצפיות היומי וזמן הצפייה ממקורות תנועה שונים
      • 10 המובילים – מונחי החיפוש ב-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 Email ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
הודעות ב-Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
העתק ללוח COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
הטמעה EMBED
אימייל MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
דפי Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo, גו GOO
Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
הודעת טקסט מ-HTC HTC_MMS
Google Inbox INBOX
תיבת דו-שיח של פעילות מערכת ב-iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao‏ (Kakao Talk) KAKAO
Kik KIK
LGE Email LGE_EMAIL
קו LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
שיתוף בקרבת מקום NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki‏ (Одноклассники) ODNOKLASSNIKI
אחר OTHER
Pinterest PINTEREST
Rakuten‏ (楽天市場) RAKUTEN
reddit, רדיט, ראדיט REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
טלגרם TELEGRAM
הודעת טקסט TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
לא ידוע UNKNOWN
Verizon Messages VERIZON_MMS
Viber VIBER
VKontakte‏ (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
וואטסאפ 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 – מודעה שנרכשה במכרז של AdWords אבל לא סווגה לאחד מסוגי המודעות האחרים.

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

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

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

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

  • reservedInstreamSelect

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

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

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

דוגמאות

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

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

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

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

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

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

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

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

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

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

דוגמאות

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