במסמך הזה מוגדרים המאפיינים שנתמכים ב-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כמסנן כדי להגביל דוח של מערכת הפעלה כך שיכיל רק נתונים של סוג מכשיר ספציפי.DESKTOPGAME_CONSOLEMOBILETABLETTVAUTOMOTIVEWEARABLEUNKNOWN_PLATFORM
- operatingSystem
- המאפיין הזה מזהה את התוכנה במכשיר שבו התרחשה הצפייה.
ברשימה הבאה מפורטות מערכות ההפעלה שה-API מחזיר נתונים לגביהן. אפשר גם להשתמש ב
operatingSystemכמסנן כדי להגביל דוח של סוג מכשיר כך שיכיל רק נתונים של מערכת הפעלה ספציפית.ANDROIDBADABLACKBERRYCHROMECASTDOCOMOFIREFOXHIPTOPIOSKAIOSLINUXMACINTOSHMEEGONINTENDO_3DSOTHERPLAYSTATIONPLAYSTATION_VITAREALMEDIASMART_TVSYMBIANTIZENVIDAAWEBOSWIIWINDOWSWINDOWS_MOBILEXBOX
דוגמאות
בבקשות לדוגמה הבאות נעשה שימוש במאפייני מכשיר:
דוגמאות לערוצים
-
מכשיר/מערכת הפעלה
- מדדים יומיים של סוגי מכשירים עם מערכת ההפעלה Android
- מדדים יומיים של מערכת ההפעלה במכשירים ניידים
- מדדים יומיים של מערכת ההפעלה וסוג המכשיר
- מדדים יומיים של סוגי מכשירים לצפיות בפלייליסטים במערכת ההפעלה Android
- מדדים יומיים של מערכת ההפעלה לצפיות בפלייליסטים במכשירים ניידים
-
מכשיר/מערכת הפעלה
דוגמאות לבעלי תוכן
-
מכשיר/מערכת הפעלה
- מדדים יומיים של סוגי מכשירים בסרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים
- מדדים יומיים של מערכת ההפעלה בסרטונים שהוגשה לגביהם הצהרת זכויות יוצרים ונצפו במכשירים ניידים
- מדדים יומיים של מערכת ההפעלה וסוג המכשיר
- מדדים יומיים של סוגי מכשירים לצפיות בפלייליסטים במערכת ההפעלה Android
- מדדים יומיים של מערכת ההפעלה לצפיות בפלייליסטים במכשירים ניידים
-
מכשיר/מערכת הפעלה
דמוגרפיה
מאפיינים דמוגרפיים עוזרים לכם להבין את טווח הגילאים ואת התפלגות המגדר של הקהל שלכם. במרכז העזרה של YouTube יש מידע נוסף על נתונים דמוגרפיים בדוחות של YouTube Analytics.
- ageGroup (מאפיין ליבה)
- המאפיין הזה מזהה את קבוצת הגיל של המשתמשים המחוברים שמשויכים לנתוני הדוח, וכולל משתמשים ש-YouTube מעריכה שהם מתחת לגיל 18. ה-API משתמש בקבוצות הגיל הבאות:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- מגדר (מאפיין ליבה)
- המאפיין הזה מזהה את המגדר של המשתמשים המחוברים שמשויכים לנתוני הדוח.
הערכים התקינים הם
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 ALLOAmeba AMEBAאימייל ב-Android ANDROID_EMAILAndroid Messenger ANDROID_MESSENGERהודעות ב-Android ANDROID_MMSתיבת הדו-שיח לשיתוף של מערכת Android ANDROID_SYSTEM_SHARE_DIALOGBlackberry Messenger BBMקבלת תגובה BLIND_REACTBlogger BLOGGERהעתק ללוח COPY_PASTECyworld CYWORLDDigg DIGGתיבת דו-שיח ישירה של פעילות המערכת DIRECT_SYSTEM_ACTIVITY_DIALOGDiscord DISCORDקוד ה-QR שמוצג DISPLAYED_QR_CODEDropbox DROPBOXהטמעה EMBEDאימייל MAILFacebook FACEBOOKFacebook Lite FACEBOOK_LITEFacebook Messenger FACEBOOK_MESSENGERדפי פייסבוק FACEBOOK_PAGESשיתוף בקבוצה בפייסבוק FACEBOOK_SHARE_TO_GROUPסטוריז ב-Facebook FACEBOOK_STORIESFotka FOTKAGmail GMAILgoo, גו GOOאפליקציית Google GOOGLE_APPGoogle Chat GOOGLE_CHATGoogle Chrome GOOGLE_CHROMEתיבת הדואר הנכנס של Google INBOXGoogle Keep GOOGLE_KEEPGoogle+ GOOGLEPLUSGo SMS GO_SMSGroupMe GROUPMEHangouts HANGOUTShi5 HI5הודעת SMS של HTC HTC_MMSIMO IMOאינסטגרם INSTAGRAMסטוריז באינסטגרם INSTAGRAM_STORIESקישור להזמנה (Android) INVITE_LINK_ANDROIDקישור להזמנה (iOS) INVITE_LINK_IOSהזמנת שותפי עריכה לפלייליסט INVITE_PLAYLIST_COLLABORATORSתיבת דו-שיח של פעילות המערכת ב-iOS IOS_SYSTEM_ACTIVITY_DIALOGKAKAO Story KAKAO_STORYKakao (Kakao Talk) KAKAOהודעות ב-KaiOS KAIOS_MESSAGESKik KIKאימייל של LGE LGE_EMAILקו LINEלינקדאין LINKEDINLiveJournal LIVEJOURNALהעתקה והדבקה במפות Google MAPS_COPY_PASTEשיתוף בזמן אמת ב-Meet MEET_LIVE_SHARINGmenéame MENEAMEmixi MIXIMotorola Messaging MOTOROLA_MESSAGINGMyspace MYSPACENaver NAVERשיתוף בקרבת מקום NEARBY_SHARENUjij NUJIJOdnoklassniki (Одноклассники) ODNOKLASSNIKIאחר OTHERפינטרסט PINTERESTשיתוף מהיר QUICK_SHAREשיתוף מהיר (סמסונג) QUICK_SHARE_SAMSUNGRakuten (楽天市場) RAKUTENreddit, רדיט, ראדיט REDDITרמיקס REMIXSamsung Messages SAMSUNG_MESSAGESSamsung Notes SAMSUNG_NOTESשמירה בתמונות במכשיר SAVE_TO_DEVICE_PHOTOSשיתוף ללא פרסומות SHARE_AD_FREEשיתוף עם מצלמת Snapchat SHARE_TO_SNAPCHAT_CAMERAשיתוף עם ילדים SHARE_WITH_KIDSSkype SKYPESkyrock SKYBLOGסנאפצ'ט SNAPCHATSony Conversations SONY_CONVERSATIONSStumbleUpon STUMBLEUPONטלגרם TELEGRAMהודעת טקסט TEXT_MESSAGETuenti TUENTItumblr. TUMBLRTwitter TWITTERלא ידוע UNKNOWNVerizon Messages VERIZON_MMSViber VIBERVKontakte (ВКонтакте) VKONTAKTEתיבת דו-שיח של פעילות במערכת באינטרנט WEB_SYSTEM_ACTIVITY_DIALOGWeChat WECHATWeibo WEIBOוואטסאפ WHATS_APPWhatsApp Business WHATS_APP_BUSINESSWykop WYKOPYahoo! יפן YAHOOפוסט לקהילה ב-YouTube YOUTUBE_COMMUNITY_POSTפרסום מחדש בקהילת YouTube YOUTUBE_COMMUNITY_REPOSTYouTube Gaming YOUTUBE_GAMINGYouTube Kids YOUTUBE_KIDSYouTube Mango YOUTUBE_MANGOYouTube Music YOUTUBE_MUSICתצוגה מקדימה של שיתוף מ-YouTube Music ל-Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEWמסך ירוק ב-YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREENYouTube 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 המובילים – הסרטונים עם ההכנסה הגבוהה ביותר
- מדדי ביצועים של סוגי מודעות שונים
-
הכנסות/מודעות
מאפיינים של בעלי התוכן
המאפיינים הבאים נתמכים רק בדוחות של בעלי תוכן.
- claimedStatus (בשימוש רק בדוחות של בעלי תוכן)
- המאפיין הזה מאפשר לציין שתגובה מה-API צריכה להכיל רק מדדים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים. הערך החוקי היחיד למאפיין הזה הוא
claimed. אם הפרמטרfiltersמגביל את השאילתה ל-claimedStatus==claimed, ה-API יאחזר רק נתונים של תוכן שהוגשה לגביו תלונה. בטבלה שבהגדרה של המאפייןuploaderTypeמפורט מידע נוסף על השימוש במאפיין הזה.
- uploaderType (מאפיין ליבה) (בשימוש רק בדוחות של בעלי תוכן)
- המאפיין הזה מאפשר לציין אם תגובה מה-API צריכה להכיל מדדים לגבי תוכן שהועלה על ידי בעלי התוכן שצוינו ו/או תוכן שהועלה על ידי צדדים שלישיים, כמו סרטונים שהועלו על ידי משתמשים. הערכים התקינים הם
selfו-thirdParty. זהו מאפיין ליבה והוא כפוף למדיניות ההוצאה משימוש.
בטבלה הבאה מוצגים השילובים הנתמכים של המאפייניםclaimedStatusו-uploaderType, ששניהם משמשים בפרמטרfilters:
ערך של claimedStatusערך של uploaderTypeתיאור [לא מוגדר] עצמי אחזור נתונים מ-YouTube Analytics לגבי תוכן שהועלה על ידי בעלי התוכן, בין אם הוגשה לגביו תלונה על הפרת זכויות יוצרים ובין אם לא. הוגשה דרישת בעלות [לא מוגדר] אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי בעלי התוכן או על ידי צד שלישי. הוגשה דרישת בעלות עצמי אחזור נתונים לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי בעלי התוכן. הוגשה דרישת בעלות thirdParty אחזור נתונים של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים והועלה על ידי צד שלישי.
דוגמאות
רבות מבקשות ה-API לדוגמה של דוחות בעלי תוכן משתמשות בשילוב נתמך של המאפיינים claimedStatus ו-uploaderType כדי לסנן נתונים.