Dimensions

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

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

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

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

מאפייני ליבה

ממשק ה-API של YouTube Analytics כפוף למדיניות ההוצאה משימוש שהוגדרה בתנאים והגבלות, אבל מאפיינים שאינם ערכי ליבה (ומדדים שאינם ליבה) לא כפופים למדיניות. בהגדרות שבדף הזה, כל מאפיין שהוא מאפיין מרכזי מזוהה באופן מפורש ככזה.

ברשימה הבאה מפורטים מאפייני הליבה של ה-API.

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

מסננים

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

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

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

מאפיינים

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

משאבים

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

דוגמאות

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

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

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

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

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

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

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

country (מאפיין ליבה)
המדינה המשויכת למדדים בשורת הדוח. ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן ISO-3166-1, כגון US, CN (סין) או FR (צרפת). קוד המדינה ZZ משמש לדיווח על מדדים שלגביהם המערכת של YouTube לא הצליחה לזהות את המדינה המשויכת. This is a core dimension and is subject to the Deprecation Policy.
province
המדינה או האזור בארה"ב המשויכים למדדים בשורת הדוח. ערך המאפיין הוא קוד ISO 3166-2 שמזהה מדינה בארה"ב או את מחוז קולומביה, כגון US-MI (מישיגן) או US-TX (טקסס). קוד המחוז US-ZZ משמש לדיווח על מדדים שלגביהם YouTube לא הצליח לזהות את המדינה המשויכת בארה"ב. כשבקשת API כוללת את province בערך הפרמטר dimensions, הבקשה חייבת גם להגביל את הנתונים לארצות הברית. לשם כך, צריך לכלול את country==US בערך הפרמטר filters.

הערה: המאפיין הזה לא תומך בערכי ISO 3166-2 שמזהים את האזורים המרוחקים של ארה"ב, כי לאזורים האלה יש גם קודי מדינה משלהם לפי תקן ISO 3166-1. היא גם לא תומכת בחלוקות משנה של מדינות מחוץ לארה"ב.

city
העיר המשוערת שמשויכת למדדים בשורת הדוח. הנתונים של המאפיין הזה זמינים החל מ-1 בינואר 2022.
יבשת (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם (UN). ה-API תומך בערכים הבאים:
ערכים
002 אפריקה
019 יבשת אמריקה (צפון אמריקה, אמריקה הלטינית, דרום אמריקה והקריביים)
142 אסיה
150 אירופה
009 אוקיאניה
ניתן להשתמש במאפיין הזה רק לצורך סינון נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את ערך הפרמטר filters ל-continent==REGION_CODE, ולציין ערך REGION_CODE מהרשימה שלמעלה.
subContinent (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם שמזהה אזור משנה גיאוגרפי. החטיבה לסטטיסטיקה של האו"ם מונה אזורי משנה ואת המדינות שמשויכות לכל אזור.

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

דוגמאות

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

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

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

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

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

תקופות זמן

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

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

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

day (מאפיין ליבה)
כשמשתמשים במאפיין הזה, הנתונים בדוח נצברים על בסיס יומי וכל שורה מכילה נתונים של יום אחד. תוכלו להשתמש במאפיינים אחרים כדי להציג פירוט נוסף של הנתונים. לדוגמה, דוח מקור תנועה יכול לצבור נתונים סטטיסטיים יומיים של צפייה על סמך האופן שבו משתמשים מגיעים לסרטונים שלכם. This is a core dimension and is subject to the Deprecation Policy.
month (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. כמו בדוחות יומיים, אפשר להשתמש במסננים אחרים כדי לפלח את הנתונים עוד יותר. התאריכים בדוח מוצגים בפורמט YYYY-MM.

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

דוגמאות

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

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

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

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

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

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

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

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

  • BROWSE – הנתונים מתארים צפיות בדף הבית או במסך הבית של YouTube, בפיד המינויים של המשתמש או בתכונת גלישה אחרת של YouTube.

  • CHANNEL – הנתונים מתארים צפיות שהתרחשו בדף ערוץ.

  • EMBEDDED – הנתונים מתארים צפיות שהתרחשו באפליקציה או באתר אחרים שבהם הסרטון הוטמע באמצעות הטמעה של <iframe> או <object>.

  • EXTERNAL_APP – הנתונים מתארים צפיות שהתרחשו באפליקציה של צד שלישי שבה הסרטון הופעל בשיטה שאינה הטמעה של <iframe> או <object>. לדוגמה, הפעלות באפליקציות שמשתמשות ב-YouTube Android Player API יסווגו לפי הערך הזה.

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

    החל מ-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 או מדפי מעבר ב-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
    • מודעת וידאו בדף הבית
    • מודעות וידאו In-stream שמורות שניתן לדלג עליהן
    • 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 שמניבים את התנועה הרבה ביותר לסרטון
      • עשרת המובילים – מונחי חיפוש ב-Google שמניבים את התנועה הרבה ביותר לסרטון
      • ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
      • מספר הצפיות היומיות בפלייליסט וזמן הצפייה ממקורות תנועה שונים

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

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

מכשירים

deviceType
המאפיין הזה מזהה את גורם הצורה הפיזי של המכשיר שבו התרחשה הצפייה. הרשימה הבאה מציינת את סוגי המכשירים שעבורם ה-API מחזיר נתונים. אפשר גם להשתמש במאפיין deviceType כמסנן כדי להגביל דוח של מערכת הפעלה כך שיכיל רק נתונים מסוג מסוים של מכשיר.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
המאפיין הזה מזהה את מערכת התוכנה של המכשיר שבו התרחשה הצפייה. הרשימה הבאה מציינת את מערכות ההפעלה שעבורן ה-API מחזיר נתונים. אפשר גם להשתמש ב-operatingSystem כמסנן כדי להגביל דוח של סוגי מכשירים כך שיכלול רק נתונים של מערכת הפעלה ספציפית.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

דוגמאות

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

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

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

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

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

דמוגרפיה

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

ageGroup (מאפיין הליבה)
המאפיין הזה מזהה את קבוצת הגיל של המשתמשים המחוברים, המשויכים לנתוני הדוח. ה-API משתמש בקבוצות הגיל הבאות:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (מאפיין ליבה)
המאפיין הזה מזהה את המגדר של המשתמשים המחוברים ומשויכים לנתוני הדוח. הערכים החוקיים הם female, male ו-user_specified. This is a core dimension and is subject to the Deprecation Policy.

דוגמאות

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

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

    • דמוגרפיה
      • מידע דמוגרפי של צופים בקליפורניה (קבוצת גיל ומגדר)
      • מידע דמוגרפי של צופים בפלייליסט בקליפורניה (קבוצת גיל ומגדר)

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

    • דמוגרפיה
      • מידע דמוגרפי של צופים בקליפורניה (קבוצת גיל ומגדר)
      • מידע דמוגרפי של צופים בפלייליסט בקליפורניה (קבוצת גיל ומגדר)

מעורבות ושיתוף תוכן

sharingService (מאפיין ליבה)
המאפיין הזה מזהה את השירות ששימש לשיתוף סרטונים. ניתן לשתף סרטונים ב-YouTube (או דרך נגן YouTube) באמצעות הלחצן "שיתוף". This is a core dimension and is subject to the Deprecation Policy.

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

דוגמאות

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

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

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

ביצועי מודעות

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 – לא הצלחנו לסווג את סוג המודעה הזה.

דוגמאות

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

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

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

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

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

פלייליסטים

isCurated (מסנן בלבד)
המסנן הזה מציין שהבקשה מאחזרת נתונים על צפיות בסרטונים שהתרחשו בהקשר של פלייליסט.

דוגמאות

כל הבקשות לדוגמה שמאחזרות את דוחות הפלייליסטים משתמשים במסנן isCurated.

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

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

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

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

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

דוגמאות

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