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 מזהים.

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

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

דוגמאות

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

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

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

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

תקופות זמן

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

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

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

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

  • IMMERSIVE_LIVE_FEED – הנתונים מתארים צפיות שהתרחשו בפיד של שידורים חיים אנכיים.

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

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

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

  • SHORTS_FEED – הנתונים מתארים צפיות שהתרחשו בפיד YouTube Shorts.

  • 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 – צפיות שמקורן בדפי האשטאג של VOD או בדפי מעבר של האשטאג ב-Shorts.
  • LIVE_REDIRECT – הצפיות בסרטון הופנו מ-Live Redirects.
  • 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 מציין את הסרטון שממנו הצופה הופנה.
  • ‫WATCH_WITH – הצפיות בסרטון הגיעו משידור של "צפייה עם פרשנות" או "צפייה עם". אם אתם מסננים לפי מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את הסרטון שממנו הצופה הופנה.
insightTrafficSourceDetail
הנתונים בדוח נצברים על סמך מקורות ההפניה שיצרו הכי הרבה צפיות בסרטון מסוים ובסוג מסוים של מקור תנועה. ברשימה הבאה מפורטים מקורות התנועה שהדוח הזה זמין לגביהם. לכל מקור תנועה, הרשימה מזהה את המידע שהמאפיין insightTrafficSourceDetail מספק.
  • ADVERTISING – סוג המודעה שהובילה לצפיות. הערכים האפשריים הם:
    • מודעה אינטראקטיבית מסוג "קליק להפעלה"
    • מודעה שיוצרת מעורבות
    • מודעות לרשת החיפוש של Google
    • מודעת וידאו בדף הבית
    • מודעות וידאו In-stream שניתן לדלג עליהן בהזמנה
    • מודעות 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 – הסרטון שהוביל לצפיות.
  • ‫WATCH_WITH – הסרטון שהוביל לצפיות.

דוגמאות

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

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

    • מקור תנועה
      • מספר הצפיות וזמן הצפייה ממקורות תנועה שונים במדינה מסוימת
      • מספר הצפיות היומי וזמן הצפייה ממקורות תנועה שונים
      • ‫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
Allo ALLO
Ameba AMEBA
אימייל ב-Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
הודעות ב-Android ANDROID_MMS
תיבת הדו-שיח לשיתוף של מערכת Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
קבלת תגובה BLIND_REACT
Blogger BLOGGER
העתק ללוח COPY_PASTE
Cyworld CYWORLD
Digg DIGG
תיבת דו-שיח ישירה של פעילות המערכת DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
קוד ה-QR שמוצג DISPLAYED_QR_CODE
Dropbox DROPBOX
הטמעה EMBED
אימייל MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
דפי פייסבוק FACEBOOK_PAGES
שיתוף בקבוצה בפייסבוק FACEBOOK_SHARE_TO_GROUP
סטוריז ב-Facebook FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo, גו GOO
אפליקציית Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
תיבת הדואר הנכנס של Google INBOX
Google Keep GOOGLE_KEEP
Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
הודעת SMS של HTC HTC_MMS
IMO IMO
אינסטגרם INSTAGRAM
סטוריז באינסטגרם INSTAGRAM_STORIES
קישור להזמנה (Android) INVITE_LINK_ANDROID
קישור להזמנה (iOS) INVITE_LINK_IOS
הזמנת שותפי עריכה לפלייליסט INVITE_PLAYLIST_COLLABORATORS
תיבת דו-שיח של פעילות המערכת ב-iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
‫Kakao‏ (Kakao Talk) KAKAO
הודעות ב-KaiOS KAIOS_MESSAGES
Kik KIK
אימייל של LGE LGE_EMAIL
קו LINE
לינקדאין LINKEDIN
LiveJournal LIVEJOURNAL
העתקה והדבקה במפות Google MAPS_COPY_PASTE
שיתוף בזמן אמת ב-Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
שיתוף בקרבת מקום NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
אחר OTHER
פינטרסט PINTEREST
שיתוף מהיר QUICK_SHARE
שיתוף מהיר (סמסונג) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit, רדיט, ראדיט REDDIT
רמיקס REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
שמירה בתמונות במכשיר SAVE_TO_DEVICE_PHOTOS
שיתוף ללא פרסומות SHARE_AD_FREE
שיתוף עם מצלמת Snapchat SHARE_TO_SNAPCHAT_CAMERA
שיתוף עם ילדים SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
סנאפצ'ט SNAPCHAT
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
טלגרם TELEGRAM
הודעת טקסט TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
לא ידוע UNKNOWN
Verizon Messages VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
תיבת דו-שיח של פעילות במערכת באינטרנט WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
וואטסאפ WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo!‎ יפן YAHOO
פוסט לקהילה ב-YouTube YOUTUBE_COMMUNITY_POST
פרסום מחדש בקהילת YouTube YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
תצוגה מקדימה של שיתוף מ-YouTube Music ל-Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEW
מסך ירוק ב-YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
צפייה משותפת ב-YouTube YOUTUBE_WATCH_WITH_FRIENDS

מידע נוסף זמין במסמכי העזרה.

דוגמאות

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

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

    • רשתות חברתיות: מדדי שיתוף, נתונים נצברים לפי השירות שבו הסרטונים שותפו
  • דוגמאות לבעלי תוכן

    • רשתות חברתיות: מדדי שיתוף, נתונים נצברים לפי השירות שבו הסרטונים שותפו

שימור קהל

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 תיאור
[לא מוגדר] עצמי אחזור נתונים מ-YouTube Analytics לגבי תוכן שהועלה על ידי בעלי התוכן, בין אם הוגשה לגביו תלונה על הפרת זכויות יוצרים ובין אם לא.
הוגשה דרישת בעלות [לא מוגדר] אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי בעלי התוכן או על ידי צד שלישי.
הוגשה דרישת בעלות עצמי אחזור נתונים לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי בעלי התוכן.
הוגשה דרישת בעלות thirdParty אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים והועלה על ידי צד שלישי.

דוגמאות

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