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 המובילים – הסרטונים שצברו הכי הרבה צפיות במדינה מסוימת
      • ‫10 המובילים – הסרטונים הנצפים ביותר באירופה

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

    • נתונים סטטיסטיים בסיסיים
      • ‫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 המובילים – הסרטונים שצברו הכי הרבה צפיות במדינה מסוימת
      • ‫10 המובילים – הסרטונים הנצפים ביותר באירופה

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

    • נתונים סטטיסטיים בסיסיים: ספירת צפיות ספציפית למדינה (ועוד) לכל הסרטונים שהועלו באופן עצמאי
    • מיקום גיאוגרפי
      • מדדים של זמן צפייה בתוכן שהועלה באופן עצמאי במדינות ספציפיות
      • מדדים של הערות במדינות ספציפיות לגבי תוכן שהועלה באופן עצמאי
      • מדדים ספציפיים למחוזות במדינות בארה"ב ובוושינגטון הבירה
      • מדדי זמן צפייה ספציפיים למדינה בפלייליסטים של בעל תוכן
      • ‫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.
‫month (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. בדומה לדוחות יומיים, אפשר להשתמש במסננים אחרים כדי לפלח את הנתונים עוד יותר. בדוח, התאריכים מופיעים בפורמט YYYY-MM.

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

דוגמאות

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

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

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

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

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

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

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

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 או האפליקציות שמשויכות לנגני הווידאו המובילים להטמעה.

דוגמאות

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

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

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

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

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

פרטי ההפעלה

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 או מדפי pivot של 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 – ה-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
  • 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 (מאפיין ליבה)
המאפיין הזה מזהה את קבוצת הגיל של המשתמשים המחוברים שמשויכים לנתוני הדוח. ה-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
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 כדי לסנן נתונים.