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

דוגמאות

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

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

    • נתונים סטטיסטיים בסיסיים
      • ‫Top 10 – Most watched videos for a channel
      • 10 המובילים – שיעורי קליקים על הערות בסרטונים הנצפים ביותר בערוץ
      • נתונים סטטיסטיים של פלייליסט ספציפי
      • ‫10 המובילים – הפלייליסטים הנצפים ביותר בערוץ
    • מיקום גיאוגרפי
      • ‫10 המובילים – הסרטונים שצברו הכי הרבה צפיות במדינה מסוימת
      • ‫10 המובילים – הסרטונים הנצפים ביותר באירופה

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

    • נתונים סטטיסטיים בסיסיים
      • ‫10 הסרטונים המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • ‫10 הסרטונים המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • ‫10 הסרטונים המובילים – הסרטונים הנצפים ביותר בערוץ של בעלי תוכן
      • 10 המובילים – שיעורי קליקים על הערות בסרטונים הנצפים ביותר בערוץ
      • 10 המובילים – הפלייליסטים שזכו לזמן הצפייה הגבוה ביותר אצל בעלי תוכן
    • מיקום גיאוגרפי
      • ‫Top 10 - Most watched videos in Europe for a content owner
      • ‫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.
חודש (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. בדומה לדוחות יומיים, אפשר להשתמש במסננים אחרים כדי לפלח את הנתונים עוד יותר. בדוח, התאריכים מופיעים בפורמט 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 או האפליקציות שמשויכות לנגני הווידאו המובילים שמוטמעים באתרים.

דוגמאות

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

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

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

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

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

פרטי ההפעלה

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

בטבלה הבאה מפורטים ערכי המאפיין:
ערכים
LIVE_STREAM התוכן שנצפה היה שידור חי ב-YouTube.
SHORTS התוכן שנצפה היה סרטון YouTube Shorts.
STORY התוכן שנצפה היה סרטון ל-YouTube Stories.
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 מציין את הסרטון שממנו הצופה הופנה.
  • ‫WATCH_WITH – הצפיות בסרטון הגיעו משידור של פרשנות יוצרים או משידור של "צפייה עם". אם מסננים לפי מקור התנועה הזה, השדה 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 – הסרטון שהוביל לצפיות.
  • ‫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 Email 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 FACEBOOK_PAGES
שיתוף בקבוצה ב-Facebook FACEBOOK_SHARE_TO_GROUP
סטוריז בפייסבוק FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo, גו GOO
אפליקציית Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
הודעת טקסט של 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 Email 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
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 תיאור
[Not set] עצמי אחזור נתונים מ-YouTube Analytics לגבי תוכן שהועלה על ידי בעלי התוכן והוגשה לגביו הצהרה על זכויות יוצרים, וגם לגבי תוכן שלא הוגשה לגביו הצהרה כזו.
הוגשה דרישת בעלות [Not set] אחזור נתונים לגבי תוכן עם תלונות על זכויות יוצרים שהועלה על ידי בעל התוכן או על ידי צד שלישי.
הוגשה דרישת בעלות עצמי אחזור נתונים לגבי תוכן שדווח על הפרת זכויות יוצרים בו והועלה על ידי בעל התוכן.
הוגשה דרישת בעלות thirdParty שליפת נתונים לגבי תוכן עם תלונות על זכויות יוצרים שהועלה על ידי צד שלישי.

דוגמאות

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