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:

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

סרטון (מאפיין מרכזי)
המזהה של סרטון ב-YouTube. ב-YouTube Data API, זהו הערך של המאפיין id של משאב video. 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 המובילים – הסרטונים שצברו הכי הרבה צפיות במדינה מסוימת
      • ‫Top 10 – Most viewed videos in Europe

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

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

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

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

מדינה (מאפיין מרכזי)
המדינה שמשויכת למדדים בשורת הדוח. ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן 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 (סינון בלבד)
קוד סטטיסטי של אזור באו"ם. ה-API תומך בערכים הבאים:
ערכים
002 אפריקה
019 אמריקה (אמריקה הצפונית, אמריקה הלטינית, דרום אמריקה והאיים הקריביים)
142 אסיה
150 אירופה
009 אוקיאניה
אפשר להשתמש במאפיין הזה רק כדי לסנן נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את הערך של הפרמטר filters ל-continent==REGION_CODE, ולציין ערך REGION_CODE מהטבלה.
‫subContinent (סינון בלבד)
קוד סטטיסטי של אזור באו"ם שמזהה אזור גיאוגרפי משני. החטיבה לסטטיסטיקה של האו"ם מפרטת גם אזורי משנה, וגם את המדינות שהיא משייכת לכל אזור.

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

דוגמאות

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

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

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

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

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

תקופות זמן

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

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

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

‫day (מאפיין ליבה)
כשמשתמשים במאפיין הזה, הנתונים בדוח מצטברים על בסיס יומי, ובכל שורה מופיעים נתונים של יום אחד. אפשר להשתמש במאפיינים אחרים כדי לפרט את הנתונים עוד יותר. לדוגמה, בדוח על מקורות תנועה אפשר לראות נתונים סטטיסטיים יומיים על צפיות, שמבוססים על האופן שבו המשתמשים מגיעים לסרטונים שלכם. This is a core dimension and is subject to the Deprecation Policy.
חודש (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. בדומה לדוחות יומיים, אפשר להשתמש במסננים אחרים כדי לפלח את הנתונים עוד יותר. בדוח, התאריכים מופיעים בפורמט 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
    • מודעת סרטון בדף הבית
    • מודעות וידאו שמורות בסרטון שניתן לדלג עליהן
    • TrueView בחיפוש וברשת המדיה
    • מודעת וידאו TrueView In-stream
    • פרסום ב-YouTube ללא שיוך לקטגוריה
    • קיר סרטונים
  • ‫CAMPAIGN_CARD – הסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהוביל את הצופים לסרטון שמצוין בדוח.
  • ‫END_SCREEN – הסרטון שהוביל את הצופים לסרטון שמזוהה בדוח.
  • ‫EXT_URL – האתר שהפנה את הצופים לסרטון.
  • ‫HASHTAGS – ההאשטאג שהוביל לצפיות.
  • ‫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 – הסרטון שהוביל לצפיות.

דוגמאות

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

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

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

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

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

מכשירים

deviceType
המאפיין הזה מזהה את גורם הצורה הפיזי של המכשיר שבו התרחשה הצפייה. הרשימה הבאה מציגה את סוגי המכשירים שעבורם ה-API מחזיר נתונים. אפשר גם להשתמש במימד deviceType כמסנן כדי להגביל את דוח מערכת ההפעלה כך שיכיל רק נתונים של סוג מכשיר ספציפי.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • 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 (מאפיין ליבה)
במאפיין הזה מפורטת קבוצת הגיל של המשתמשים המחוברים שמשויכים לנתוני הדוח, כולל משתמשים שלפי ההערכה של YouTube הם מתחת לגיל 18. ה-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.
‫מגדר (מאפיין מרכזי)
המאפיין הזה מזהה את המגדר של המשתמשים המחוברים שמשויכים לנתוני הדוח. הערכים התקינים הם 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
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
שיתוף בקרבת מקום NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
אחר OTHER
פינטרסט PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit, רדיט, ראדיט REDDIT
Skype SKYPE
Skyrock SKYBLOG
שיחות של Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
טלגרם TELEGRAM
הודעת טקסט TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
לא ידוע UNKNOWN
הודעות Verizon 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 לא הצליחה לסווג את סוג המודעה הזה.

דוגמאות

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

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

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

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

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

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

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

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

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

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

דוגמאות

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