בדף הזה מוצגות בקשות לדוגמה של YouTube Analytics API. כל דוגמה מתארת בקצרה את הדוח שמאוחזר ומציגה את ערכי הפרמטרים dimensions
, metrics
, filters
ו-sort
המתאימים. (המסמכים של דוחות הערוצים ודוחות של בעלי התוכן מזהים את הדוחות שנתמכים על ידי ה-API).
כל דוגמה מקשרת אל Google APIs Explorer ומאכלסת את הערכים המוצגים. בדוגמאות נעשה שימוש גם בתאריכי ההתחלה והסיום (YYYY-MM-DD
) שמוגדרים כברירת מחדל ב-2023-09-01
וב-2024-03-31
.
אחרי שמקשרים ל-APIs Explorer, עדיין צריך לציין את הערוץ או את בעלי התוכן שעבורם מאחזרים דוחות. APIs Explorer יאכלס את ערך הפרמטר ids
ב-channel==MINE
או ב-contentOwner==CONTENT_OWNER_ID
, בהתאם לשאילתה שלחצתם עליה. בדוחות ערוצים, אפשר לשנות את MINE
למזהה הערוץ של המשתמש המאומת. בדוחות של בעלי תוכן, עליך להחליף את CONTENT_OWNER_ID
במזהה בעלי התוכן שלך.
בנוסף, צריך לעבור אימות בתור הערוץ או בעלי התוכן שצוינו כדי ש-API Explorer יוכל לאשר את בקשות ה-API באמצעות OAuth 2.0.
מיון בקשות לפי מאפיינים/מדדים מרובים
ה-API תומך במיון נתוני התגובות באמצעות כמה מאפיינים או מדדים. לדוגמה, הבקשה למטה מאחזרת נתונים של מקורות תנועה יומיים עבור סרטונים בערוץ מסוים. כל שורה בקבוצת התוצאות מזהה את מספר הצפיות ואת זמן הצפייה המשוער שמקורם בסוג מסוים של מקור תנועה (למשל, EXT_URL
) ביום מסוים.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
התוצאות ממוינות בסדר כרונולוגי בתשובה. התוצאות בקבוצת התוצאות של כל יום ממוינות בסדר יורד לפי מספר הצפיות. לכן, השורה הראשונה בקבוצת התוצאות מכילה נתונים לגבי מקור התנועה שהניב את הצפיות הרבות ביותר ביום הראשון בטווח התאריכים המבוקש. השורה השנייה מכילה נתונים לגבי מקור התנועה שיצר את מספר הצפיות הגבוה ביותר הבא ביום הראשון.
דוחות ערוצים
דוחות סרטונים
ספירת הצפיות הכוללת, זמן צפייה משוער ועוד בערוץ
השאילתה הזו מאחזרת מדדים נצברים של תוכן הערוץ. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
ספירת צפיות ספציפיות למדינה (ועוד) בערוץ
השאילתה הזו מאחזרת מדדים של סרטונים בערוץ מסוים במדינה מסוימת. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 הסרטונים המובילים – הסרטונים הנצפים ביותר בערוץ
השאילתה הזו מאחזרת את 10 הסרטונים הנצפים ביותר בערוץ, כפי שנמדד לפי אומדן דקות הצפייה במהלך טווח התאריכים שצוין. התוצאות ממוינות לפי אומדן הדקות שנצפו בסדר יורד.
הערה: בדוח הזה צריך לציין ערך לפרמטר הבקשה sort
ולהגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
או פחות.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
10 המובילים – שיעורי הקליקים על הערות לסרטונים הנצפים ביותר בערוץ
הבקשה הזו מאחזרת ספירת צפיות, שיעורי קליקים של הערות, שיעורי סגירת הערות וחשיפות של הערות ל-10 הסרטונים הנצפים ביותר בערוץ. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. על כן, הסרטון הנצפה ביותר יוצג ראשון.
הערה: בדוח הזה צריך לציין ערך לפרמטר הבקשה sort
ולהגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
או פחות.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
דוחות פלייליסטים
סה"כ צפיות בפלייליסט של ערוץ
הבקשה מאחזרת את סך כל ההתחלות של הפלייליסט, מספר הדקות המשוער שנצפו, צפיות (מדד וידאו מצטבר), צפיות בפלייליסט (מדד בפלייליסט) וצפיות לכל פלייליסט בערוץ של המשתמש המאומת.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
נתונים סטטיסטיים לגבי פלייליסט ספציפי
הבקשה מאחזרת את סך כל ההתחלות של הפלייליסט, מספר הדקות המשוער שנצפו, צפיות (מדד וידאו מצטבר),
צפיות בפלייליסט (מדד בפלייליסט)
וצפיות לכל פלייליסט בפלייליסט ספציפי. הערה: כדי להריץ את השאילתה הזו ב-API
Explorer, צריך להחליף את המחרוזת PLAYLIST_ID
בערך הפרמטר filters
במזהה הפלייליסט של פלייליסט בערוץ של המשתמש המאומת.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
כדי לאחזר נתונים סטטיסטיים מצטברים לגבי מספר פלייליסטים, אפשר גם להחליף את המחרוזת PLAYLIST_ID
ברשימה מופרדת בפסיקים של עד 500 מזהים של פלייליסטים לפלייליסטים בערוץ של המשתמש המאומת.
10 הפלייליסטים המובילים – הפלייליסטים הנצפים ביותר בערוץ
השאילתה הזו מאחזרת את 10 הפלייליסטים הנצפים ביותר בערוץ, כפי שנמדד לפי צפיות בפלייליסט במהלך טווח התאריכים שצוין. מתבצע גם אחזור של מספר מדדים נוספים של פלייליסט, כמו מספר הפעמים שבהן משתמשים יזמו הפעלה של כל פלייליסט ומשך הזמן הממוצע שבו מישהו צפה בסרטונים בפלייליסט אחרי שהוא התחיל. התוצאות ממוינות לפי מספר הצפיות בפלייליסט בסדר יורד.
הערה: בדוח הזה נעשה שימוש במאפיין playlist
, ולכן צריך לציין ערך לפרמטר הבקשה sort
וגם להגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
דוחות סרטונים
מדדים של זמן צפייה יומי בסרטונים בערוץ
השאילתה הזו מאחזרת ספירת צפיות יומית, מדדים של זמן צפייה ומספר מנויים חדשים בסרטונים בערוץ. הדוח מחזיר שורה אחת של נתונים לכל יום בטווח התאריכים המבוקש. השורות ממוינות בסדר כרונולוגי.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
מדדים יומיים של הערות לסרטונים בערוץ
הבקשה הזו מאחזרת ספירות של צפיות יומיות, שיעורי קליקים של הערות, שיעורי סגירה של הערות וחשיפות של הערות עבור תוכן הערוץ. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
דוחות פלייליסטים
צפיות יומיות בפלייליסט של ערוץ
הבקשה הזו מאחזרת ספירות של צפיות יומיות (מדד וידאו מצטבר), צפיות בפלייליסט (מדד בפלייליסט), מספר ההפעלות של הפלייליסט, מספר הדקות המשוער של צפייה וצפיות לכל פלייליסט בערוץ של המשתמש המאומת. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
דוחות סרטונים
מדדים של זמן צפייה בסרטונים בערוץ לפי מדינות
השאילתה הזו מאחזרת מספרי צפיות ספציפיים למדינה, מדדים של זמן צפייה ונתוני מינויים עבור הסרטונים בערוץ. הדוח מציג שורה אחת של נתונים לכל מדינה שבה צפו בסרטונים בערוץ. השורות ממוינות בסדר יורד לפי מספר הדקות שנצפו.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
מדדים ספציפיים של הערות לסרטונים בערוץ
הבקשה הזו מאחזרת ספירות של צפיות ספציפיות למדינה, שיעורי קליקים של הערות, שיעורי סגירת הערות וחשיפות של הערות עבור הסרטונים בערוץ. התוצאות ממוינות לפי שיעור הקליקים של ההערות בסדר יורד. המשמעות היא שהמדינה עם שיעור הקליקים הגבוה ביותר עם הערות תופיע ראשונה.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
מדדים ספציפיים לפרובינציה בארצות הברית ובוושינגטון
בקשה זו מאחזרת פירוט לפי פרובינציה של צפיות, מספר משוער של דקות צפייה ומשך צפייה ממוצע בסרטונים בערוץ. הנתונים מתייחסים למדינות ארה"ב ולוושינגטון. התוצאות ממוינות בסדר אלפביתי לפי קודי ISO 3166-2 של המחוזות.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 הסרטונים המובילים – הסרטונים הנצפים ביותר במדינה מסוימת
שאילתה זו מאחזרת את 10 הסרטונים הנצפים ביותר בערוץ, כפי שנמדד לפי מספר הצפיות במהלך טווח התאריכים שצוין, במדינה מסוימת. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
הערה: בדוח הזה צריך לציין ערך לפרמטר הבקשה sort
ולהגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
או פחות.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 הערים המובילות בארה"ב לפי מספר הצפיות הכולל
השאילתה הזו מאחזרת רשימה של 10 הערים בארה"ב שהניבו את הצפיות הרבות ביותר בתוכן הערוץ במהלך טווח התאריכים שצוין. כדי לבקש נתונים לגבי מדינה אחרת, צריך לבחור ערך חוקי אחר למסנן הזה, כדי לשנות את השאילתה. באופן דומה, ניתן לשנות את השאילתה כדי לאחזר נתונים עבור תת-יבשת, כגון מערב אירופה או דרום-מזרח אסיה, באמצעות המסנן subContinent ועל אחד מהערכים החוקיים שלו. קיימת תמיכה גם במסננים אחרים. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
10 הערים המובילות בארה"ב לפי סך הצפיות לכל סוג תוכן
השאילתה הזו מאחזרת רשימה של 10 הערים בארה"ב שהניבו את הצפיות הרבות ביותר בתוכן הערוץ במהלך טווח התאריכים שצוין, לכל creatorContentType נתמך. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
10 הערים המובילות בארה"ב לפי זמן הצפייה הכולל
השאילתה הזו מאחזרת רשימה של 10 הימים המובילים במהלך טווח התאריכים שצוין, כאשר עיר כלשהי בארה"ב הייתה אחראית לזמן הצפייה הכולל הארוך ביותר בתוכן הערוץ. תוצאות השאילתה מזהות את זמן הצפייה הכולל, את התאריך שבו התרחש זמן הצפייה ואת העיר שבה התוכן נצפה המשוער. התוצאות ממוינות בסדר יורד של זמן הצפייה הכולל.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
10 הסרטונים המובילים – הסרטונים הנצפים ביותר באירופה
השאילתה הזו מאחזרת את 10 הסרטונים הנצפים ביותר בערוץ באירופה, כפי שנמדד לפי מספר הצפיות בטווח התאריכים שצוין. כדי לבקש נתונים לגבי יבשת אחרת, ניתן לשנות את השאילתה על ידי בחירת ערך חוקי אחר למסנן הזה. באופן דומה, ניתן לשנות את השאילתה כדי לאחזר נתונים עבור תת-יבשת, כגון מערב אירופה או דרום-מזרח אסיה, באמצעות המסנן subContinent ועל אחד מהערכים החוקיים שלו. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
הערה: בדוח הזה צריך לציין ערך לפרמטר הבקשה sort
ולהגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
או פחות.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
דוחות פלייליסטים
מדדים של זמן צפייה ספציפיים למדינה בפלייליסטים של ערוץ
השאילתה הזו מאחזרת ספירות של צפיות ספציפיות למדינה (מדד וידאו מצטבר), צפיות בפלייליסט (מדד בפלייליסט) ומדדים של זמן צפייה בפלייליסטים של הערוץ. הדוח מציג שורה אחת של נתונים לכל מדינה שבה צפו בפלייליסטים של הערוץ. השורות ממוינות בסדר יורד לפי מספר הדקות שנצפו.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 הפלייליסטים המובילים – הפלייליסטים הפותחים ביותר בארצות הברית
השאילתה הזו מאחזרת את 10 הפלייליסטים שצופים בארצות הברית התחילו לצפות בהם בתדירות הגבוהה ביותר במהלך טווח התאריכים שצוין. התוצאות ממוינות לפי מספר התחלת הפלייליסט בסדר יורד.
הערה: בדוח הזה נעשה שימוש במאפיין playlist
, ולכן צריך לציין ערך לפרמטר הבקשה sort
וגם להגדיר לפרמטר maxResults
ערך של מספר שלם עד 10
.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
דוחות סרטונים
ספירת צפיות וזמן צפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטונים של ערוץ מסוים. התוצאות מצטברות על סמך סוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים, והתוצאות ממוינות בסדר יורד לפי מספר הצפיות.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספרי הצפיות היומיים וזמן הצפייה המשוער בארצות הברית בסרטונים של ערוץ מסוים. התוצאות מקובצות לפי יום עבור כל סוג של דף או אפליקציה שבהם התרחשו הפעלות של סרטונים. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
עשרת המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגדול ביותר בסרטון מוטמע
השאילתה הזו מאחזרת את ספירת הצפיות ואת זמן הצפייה המשוער בסרטון מסוים או בקבוצת סרטונים. התוצאות מקובצות לפי האתר של הצד השלישי שבו הסרטון הוטמע. התוצאות ממוינות בסדר יורד לפי מספר הצפיות. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של מזהה וידאו אחד או יותר לסרטונים שהעליתם.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
דוחות פלייליסטים
מספר הצפיות בפלייליסט וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספר הצפיות (מדד מצטבר של סרטונים), את הצפיות בפלייליסט (מדד בפלייליסט), את זמן הצפייה המשוער ואת מספר ההפעלות של הפלייליסט בפלייליסטים של ערוץ מסוים. התוצאות נצברות לפי סוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים, והתוצאות ממוינות בסדר יורד לפי התחלת הפלייליסט.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
מספר הצפיות היומיות בפלייליסט וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספר ההפעלות היומיות של פלייליסטים, את מספר הצפיות (מדד מצטבר של סרטונים), את הצפיות בפלייליסט (מדד בפלייליסט) ואת זמן הצפייה המשוער בארצות הברית בפלייליסטים של ערוץ מסוים. התוצאות מקובצות לפי יום לפי כל סוג דף או אפליקציה שבהם התרחשו צפיות בפלייליסט. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
דוחות סרטונים
סימוני לייק ודיסלייק לפי סוג התוכן
השאילתה הזו מאחזרת את מספר הלייקים והדיסלייקים לכל סוג תוכן בערוץ.
dimensions=creatorContentType metrics=likes,dislikes
דוחות סרטונים
ספירת צפיות וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
הבקשה הזו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטונים של הערוץ במדינה מסוימת. המדדים נצברים לפי מקור תנועה, שמתאר את האופן שבו המשתמשים הגיעו לסרטון.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
ספירת צפיות יומית וזמן צפייה ממקורות תנועה שונים
הבקשה הזו מאחזרת את מספרי הצפיות היומיים וזמן הצפייה המשוער היומי בסרטונים של הערוץ. המדדים נצברים על בסיס יומי לפי מקור התנועה, וממוינים בסדר כרונולוגי.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
עשרת המובילים – מונחי חיפוש ב-YouTube שמניבים את התנועה הרבה ביותר לסרטון
השאילתה הזו מאחזרת את 10 מונחי החיפוש שהניבו את מספר הצפיות הגבוה ביותר מתוצאות החיפוש ב-YouTube לסרטון ספציפי אחד או יותר. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה של עד 500 מזהי וידאו שמופרדים בפסיקים.
לדוגמה, אתם יכולים להריץ שאילתה עבור סרטון יחיד או להחליף את VIDEO_ID
כדי לזהות את מונחי החיפוש שמניבים את נפח התנועה הגבוה ביותר לסרטון הזה. אתם יכולים גם לרשום את כל הסרטונים בפלייליסט מסוים כדי לקבוע אילו מונחי חיפוש מייצרים את התנועה הגדולה ביותר לכל אחד מהסרטונים באותו פלייליסט.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
עשרת המובילים – אתרים חיצוניים שמניבים את נפח התנועה הגדול ביותר לסרטון
השאילתה הזו מאחזרת את 10 האתרים החיצוניים שהניבו את מספר הצפיות הגדול ביותר בסרטון מסוים או בקבוצת סרטונים מסוימת. התוצאות ממוינות לפי זמן צפייה משוער בסדר יורד. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי וידאו לסרטונים שהעליתם.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
דוחות פלייליסטים
ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
הבקשה הזו מאחזרת את מספר הצפיות (מדד מצטבר של סרטונים), את הצפיות בפלייליסט (מדד בפלייליסט), את מספר התחלות הפלייליסט ואת זמן הצפייה המשוער בצפיות בפלייליסט במדינה מסוימת. המדדים נצברים לפי מקור התנועה, שמתאר את האופן שבו המשתמשים הגיעו לפלייליסט.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
מספר הצפיות היומיות בפלייליסט וזמן הצפייה ממקורות תנועה שונים
הבקשה הזו מאחזרת את הצפיות היומיות בפלייליסט של ערוץ (מדד בפלייליסט), את התחלת הפלייליסט ואת זמן הצפייה המשוער. מאחזר גם את סך הצפיות (מדד וידאו מצטבר). המדדים נצברים על בסיס יומי לפי מקור התנועה, וממוינים בסדר כרונולוגי.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
דוחות סרטונים
מדדים יומיים של סוג המכשיר למערכת ההפעלה Android
השאילתה הזו מאחזרת את מספרי הצפיות היומיים וזמן הצפייה המשוער בסרטונים של ערוץ מסוים במכשירי Android. התוצאות מקובצות לפי יום עבור כל סוג מכשיר שבו התרחשו סרטונים. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
מדדים יומיים של מערכת ההפעלה במכשירים ניידים
השאילתה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער בסרטונים של ערוץ מסוים במכשירים ניידים. התוצאות מקובצות לפי יום עבור כל מערכת הפעלה שבה התרחשו הפעלות של סרטונים. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
מדדים יומיים של מערכת ההפעלה וסוג המכשיר
השאילתה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער בערוץ. הנתונים הסטטיסטיים מקובצים לפי מערכת הפעלה וסוג מכשיר. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
דוחות פלייליסטים
מדדים יומיים של סוגי מכשירים בשביל צפיות בפלייליסט במערכת ההפעלה Android
השאילתה הזו מאחזרת צפיות יומיות (מדד וידאו מצטבר), צפיות בפלייליסט (מדד בפלייליסט) וזמן צפייה משוער בפלייליסטים של ערוץ מסוים במכשירי Android. התוצאות מקובצות לפי יום עבור כל סוג מכשיר שבו התרחשו צפיות בפלייליסט. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
מדדים יומיים של מערכת ההפעלה עבור צפיות בפלייליסט במכשירים ניידים
השאילתה הזו מאחזרת צפיות יומיות (מדד וידאו מצטבר), צפיות בפלייליסט (מדד בפלייליסט) וזמן צפייה משוער בפלייליסטים של ערוץ מסוים במכשירים ניידים. התוצאות מקובצות לפי יום עבור כל מערכת הפעלה שבה התרחשו צפיות בפלייליסט. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
דוחות סרטונים
מידע דמוגרפי של צופים בקליפורניה (קבוצת גיל ומגדר)
הדוח הזה מאחזר נתונים סטטיסטיים לגבי קבוצת הגיל והמגדר של צופים בקליפורניה שצפו בסרטונים של הערוץ. התוצאות ממוינות לפי מגדר ואחר כך לפי קבוצת גיל. אפשר לשנות את השאילתה הזו כדי לאחזר את אותם נתונים סטטיסטיים לכל הצופים ברחבי העולם או לכל הצופים במדינה, ביבשת, בתת-יבשת או במדינה אחרת בארה"ב, על ידי התאמת ערך הפרמטר filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
דוחות פלייליסטים
מידע דמוגרפי של צופים בפלייליסט בקליפורניה (קבוצת גיל ומגדר)
בדוח הזה מאחזרים נתונים סטטיסטיים לגבי קבוצת הגיל והמגדר של צופים בקליפורניה
שצפו בפלייליסטים של הערוץ. התוצאות ממוינות לפי מגדר ואחר כך לפי קבוצת גיל. אפשר לשנות את השאילתה הזו כדי לאחזר את אותם נתונים סטטיסטיים לגבי כל הצופים ברחבי העולם או לכל
הצופים במדינה, ביבשת, בתת-יבשת או במדינה אחרת בארה"ב, על ידי התאמת ערך הפרמטר filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
מדדי שיתוף, נצברים לפי השירות שבו שותפו הסרטונים
הבקשה הזו מאחזרת את מספר הפעמים שמשתמשים השתמשו בלחצן Share
כדי לשתף סרטונים של ערוץ. התוצאות מצטברות לפי שירות השיתוף (Google+ , Twitter וכו') וממוינות בסדר יורד של מספר השיתופים.
dimensions=sharingService metrics=shares sort=-shares
מדדי שימור קהל בסרטון
הדוח מודד את היכולת של סרטון לשמר את הקהל שלו. ניתן לאחזר את הדוח לגבי סרטון אחד בלבד בכל פעם. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
במזהה הווידאו של אחד מהסרטונים שהעליתם. לתשומת ליבך, דוחות שימור קהל לא תומכים באפשרות לציין ערכים מרובים למסנן video
.
בדוגמה הזו, הדוח משתמש במסנן audienceType
כדי להגביל את התגובה, כך שיכלול רק נתונים של צפיות אורגניות, שנובעות מפעולה ישירה של המשתמש, כמו חיפוש סרטון או קליק על סרטון מוצע. לכן הדוח לא כולל נתונים על צפיות ממודעות וידאו TrueView In-stream או ממודעות TrueView ברשת המדיה. אפשר להסיר את המסנן כדי לאחזר את נתוני שימור הקהל של הסרטון מכל סוגי הקהלים.
לתשומת ליבכם: נתונים עבור המסנן audienceType
זמינים החל מ-25 בספטמבר 2013. ה-API לא יחזיר נתונים לשאילתות שבהן נעשה שימוש במסנן כדי לנסות לאחזר נתונים מתאריכים קודמים. שאילתות שלא נעשה בהן שימוש במסנן יפעלו עבור כל תאריך שחל אחרי 1 ביולי 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
מדדים של ביצועי המודעות והכנסות מהערוץ
הבקשה הזו מאחזרת את מדדי ההכנסות וביצועי המודעות של ערוץ. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
הכנסות יומיות ומדדי ביצועי מודעות
הבקשה הזו מאחזרת את ההכנסות היומיות ואת מדדי ביצועי המודעות של ערוץ.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
ערכים של הכנסות וביצועי מודעות ספציפיות למדינה
הבקשה הזו מאחזרת את מדדי ההכנסות וביצועי המודעות של ערוץ ספציפי למדינה. התוצאות ממוינות בסדר יורד לפי סכום ההכנסה. כלומר, המדינה הראשונה ברשימה תהיה המדינה שבה השותף הניב את ההכנסה נטו הגבוהה ביותר.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 הסרטונים המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
הבקשה הזו מאחזרת את ההכנסות ומדדי ביצועי המודעות של 10 הסרטונים של הערוץ שהניבו את ההכנסות הגבוהות ביותר. התוצאות ממוינות בסדר יורד לפי סכום ההכנסה. כלומר, הסרטון הראשון יהיה הסרטון עם ההכנסות המשוערות הגבוהות ביותר.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
מדדי ביצועים של מודעות מסוגים שונים
בקשה זו מאחזרת מדדי ביצועים של מודעות עבור תוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. התוצאות מקובצות לפי סוג מודעה וכך ניתן להשוות בין ערכי ההכנסה והעלות לאלף חשיפות בסוגים שונים של מודעות.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
דוחות של בעלי התוכן
דוחות סרטונים
ספירת הצפיות הכוללת, זמן צפייה משוער ועוד לגבי כל התוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
השאילתה הזו מאחזרת מדדים נצברים של התוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
ספירת צפיות לפי מדינה (ועוד) בכל הסרטונים שהעליתם בעצמכם
השאילתה הזו מאחזרת מדדים של מדינה ספציפית לגבי סרטונים שבעלי התוכן העלו. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
ספירת הצפיות הכוללת (ועוד) בכל התוכן של צד שלישי שהוגשה לגביו תלונה על הפרת זכויות יוצרים
השאילתה הזו מאחזרת מדדים נצברים של סרטונים שבעלי התוכן הצהירו על זכויות יוצרים לגביהם, אבל לא העלו אותם. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
ספירת הצפיות הכוללת (ועוד) בכל התוכן שהועלה בעצמכם
השאילתה הזו מאחזרת מדדים נצברים של סרטונים שבעלי התוכן העלו. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
ספירת הצפיות הכוללת (ועוד) בכל התוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהעליתם בעצמכם
השאילתה הזו מאחזרת מדדים נצברים של סרטונים שבעלי התוכן העלו וגם הגישו לגביהם הצהרה על זכויות יוצרים. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 הסרטונים הנצפים ביותר – הסרטונים הנצפים ביותר של בעלי תוכן
שאילתה זו מאחזרת את 10 הסרטונים הנצפים ביותר, כפי שנמדד על ידי מספר הצפיות במהלך טווח התאריכים שצוין, שהעלה בעל התוכן. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
עשרת הסרטונים המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
שאילתה זו מאחזרת את 10 הסרטונים הנצפים ביותר, כפי שנמדד על ידי אומדן דקות הצפייה במהלך טווח התאריכים שצוין, שהעלה בעלי התוכן. התוצאות ממוינות לפי אומדן הדקות שנצפו בסדר יורד.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 הסרטונים המובילים – הסרטונים הנצפים ביותר בערוץ של בעלי התוכן
השאילתה הזו מאחזרת את 10 הסרטונים הנצפים ביותר בערוץ ספציפי או בקבוצת ערוצים ספציפית שבעלי התוכן מנהל. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 המובילים – שיעורי הקליקים על הערות לסרטונים הנצפים ביותר בערוץ
הבקשה הזו מאחזרת ספירת צפיות, שיעורי קליקים של הערות, שיעורי סגירת הערות וחשיפות של הערות ל-10 הסרטונים הנצפים ביותר בערוץ מסוים או בקבוצת ערוצים ספציפית. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. על כן, הסרטון הנצפה ביותר יוצג ראשון. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
דוחות פלייליסטים
צפיות בפלייליסט בערוצים של בעלי התוכן
הבקשה הזו מאחזרת את סך כל ההתחלות של הפלייליסט, את מספר הדקות המשוער שנצפו, את מספר הצפיות בפלייליסט ואת מספר הצפיות בכל הפעלת פלייליסט בפלייליסטים של בעלי התוכן. המדד
playlistViews
סופר רק צפיות בסרטונים שהתרחשו בהקשר של
פלייליסט. מכיוון שכל המדדים המבוקשים הם מדדים בתוך הפלייליסט, הבקשה
לא צריכה לכלול גם את המסנן פלייליסט או קבוצה.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
נתונים סטטיסטיים לגבי פלייליסט ספציפי
הבקשה מאחזרת את סך כל ההתחלות של הפלייליסט, מספר הדקות המשוער שנצפו, צפיות (מדד וידאו מצטבר),
צפיות בפלייליסט (מדד בפלייליסט)
וצפיות לכל פלייליסט בפלייליסט ספציפי. הערה: כדי להריץ את השאילתה הזו ב-API
Explorer, צריך להחליף את המחרוזת PLAYLIST_ID
בערך הפרמטר filters
במזהה הפלייליסט של פלייליסט באחד מהערוצים של בעלי התוכן.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
כדי לאחזר נתונים סטטיסטיים מצטברים עבור מספר פלייליסטים, ניתן גם להחליף את המחרוזת PLAYLIST_ID
ברשימה מופרדת בפסיקים של עד 500 מזהי פלייליסטים לפלייליסטים בערוצים של בעלי התוכן.
דוחות סרטונים
מדדים יומיים של זמן צפייה בתוכן שהעלית בעצמך
השאילתה הזו מאחזרת מדדים יומיים של זמן צפייה, כמו גם ספירת צפיות, ספירות של הפעלות שמייצרות הכנסות וספירת חשיפות של סרטונים שבעלי התוכן העלו. הדוח מחזיר שורה אחת של נתונים לכל יום בטווח התאריכים המבוקש, והשורות ממוינות בסדר כרונולוגי.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
מדדים של הערות לגבי תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
בקשה זו מאחזרת ספירות יומיות של צפיות, שיעורי קליקים של הערות, שיעורי סגירת הערות וחשיפות של הערות עבור התוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
דוחות פלייליסטים
צפיות יומיות בפלייליסט של בעלי התוכן
הבקשה הזו מאחזרת מדדים של אינטראקציות יומיות של משתמשים עם סרטונים בפלייליסטים של בעלי התוכן. המדדים שמאוחזרים בדוח הם playlistViews, playlistStarts, playlistEstimatedMinutesWatched ו-viewsPerPlaylistStart. כל המדדים האלה הם מדדים בתוך הפלייליסט. מכיוון שכל המדדים המבוקשים הם מדדים בתוך הפלייליסט, הבקשה לא צריכה לכלול גם את המסנן פלייליסט או קבוצה.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
דוחות סרטונים
מדדים של זמן צפייה ספציפיים למדינה עבור תוכן שהועלה בעצמכם
השאילתה הזו מאחזרת את ספירת הצפיות, המדדים של זמן הצפייה וההכנסות המשוערות מפרסום בכל מדינה. המדדים רלוונטיים לסרטונים שבעל התוכן העלה. בדוח מוצגת שורה אחת של נתונים לכל מדינה שבה הסרטונים נצפו, והשורות ממוינות בסדר יורד של מספר הדקות שנצפו.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
מדדים של הערות ספציפיות למדינה עבור תוכן שהועלה בעצמכם
בקשה זו מאחזרת ספירות של צפיות ספציפיות למדינה, שיעורי קליקים של הערות, שיעורי סגירת הערות וחשיפות של הערות עבור הסרטונים שהועלו על ידי בעלי התוכן. התוצאות ממוינות לפי שיעור הקליקים של ההערות בסדר יורד. המשמעות היא שהמדינה עם שיעור הקליקים הגבוה ביותר עם הערות תופיע ראשונה.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
מדדים ספציפיים לפרובינציה בארצות הברית ובוושינגטון
בקשה זו מאחזרת פירוט לפי פרובינציה של ספירת צפיות, אומדן דקות הצפייה ומשך הצפייה הממוצע בסרטונים שבעלי התוכן הגישו לגביהם הצהרה על זכויות יוצרים. הנתונים מתייחסים למדינות ארה"ב ולוושינגטון. התוצאות ממוינות בסדר אלפביתי לפי קודי ISO 3166-2 של המחוזות.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 הערים המובילות בארה"ב לפי מספר הצפיות הכולל
השאילתה הזו מאחזרת רשימה של 10 הערים בארה"ב שהניבו את הצפיות הרבות ביותר בסרטונים שהוגשה לגביהם תלונה על ידי בעלי התוכן בטווח התאריכים שצוין. כדי לבקש נתונים לגבי מדינה אחרת, צריך לבחור ערך חוקי אחר למסנן הזה, כדי לשנות את השאילתה. באופן דומה, ניתן לשנות את השאילתה כדי לאחזר נתונים עבור תת-יבשת, כגון מערב אירופה או דרום-מזרח אסיה, באמצעות המסנן subContinent ועל אחד מהערכים החוקיים שלו. קיימת תמיכה גם במסננים אחרים. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
10 הערים המובילות בארה"ב לפי סך הצפיות לכל סוג תוכן
השאילתה הזו מאחזרת רשימה של 10 הערים בארה"ב שהניבו את מספר הצפיות הגבוה ביותר בתוכן שהוגשה לגביו תלונה על ידי בעלי התוכן במהלך טווח התאריכים שצוין לכל creatorContentType נתמך. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
10 הערים המובילות בארה"ב לפי זמן הצפייה הכולל
השאילתה הזו מאחזרת רשימה של 10 הימים המובילים במהלך טווח התאריכים שצוין, כאשר כל עיר בארה"ב הייתה אחראית לזמן הצפייה הכולל הארוך ביותר בתוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. תוצאות השאילתה מזהות את זמן הצפייה הכולל, את התאריך שבו התרחש זמן הצפייה ואת העיר שבה התוכן נצפה המשוער. התוצאות ממוינות בסדר יורד של זמן הצפייה הכולל.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
10 הסרטונים המובילים – הסרטונים הנצפים ביותר באירופה
שאילתה זו מאחזרת את 10 הסרטונים הנצפים ביותר באירופה, בין סרטונים שבעלים של התוכן הצהיר עליהם, כפי שנמדד לפי מספר הצפיות במהלך טווח התאריכים שצוין. כדי לבקש נתונים לגבי יבשת אחרת, ניתן לשנות את השאילתה על ידי בחירת ערך חוקי אחר למסנן הזה. באופן דומה, ניתן לשנות את השאילתה כדי לאחזר נתונים עבור תת-יבשת, כגון מערב אירופה או דרום-מזרח אסיה, באמצעות המסנן subContinent ועל אחד מהערכים החוקיים שלו. התוצאות ממוינות לפי מספר הצפיות בסדר יורד.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
דוחות פלייליסטים
ערכים ספציפיים למדינה של זמן צפייה בפלייליסטים של בעלי תוכן
השאילתה הזו מאחזרת את מספר הצפיות בפלייליסט הספציפי למדינה ומדדים של זמן הצפייה בפלייליסט עבור כל הפלייליסטים בערוצים של בעלי התוכן. הדוח מחזיר שורה אחת של נתונים לכל מדינה שבה נצפו הפלייליסטים. השורות ממוינות בסדר יורד לפי מספר הדקות שנצפו.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 הפלייליסטים המובילים – הפלייליסטים הפותחים ביותר בארצות הברית
השאילתה הזו מאחזרת את 10 הפלייליסטים מהערוצים של בעלי התוכן שבהם צופים בארצות הברית התחילו לצפות בתדירות הגבוהה ביותר בטווח התאריכים שצוין. התוצאות ממוינות לפי מספר התחלות הפלייליסט בסדר יורד.
הערה: בדוח הזה נעשה שימוש במאפיין playlist
, ולכן צריך
לציין ערך לפרמטר הבקשה sort
וגם להגדיר
לפרמטר maxResults
ערך מספר שלם של 10
או פחות.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
דוחות סרטונים
סימוני לייק ודיסלייק לפי סוג התוכן
השאילתה הזו מאחזרת את מספר הלייקים והדיסלייקים לכל סוג תוכן בערוץ מסוים או בקבוצת ערוצים מסוימת. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
דוחות סרטונים
ספירת צפיות וזמן צפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטונים שהועלו לערוץ מסוים או לקבוצת ערוצים מסוימת. התוצאות מצטברות על סמך סוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים, והתוצאות ממוינות בסדר יורד לפי מספר הצפיות. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
מספר הצפיות היומי וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער בארצות הברית בסרטונים שהועלו לערוץ מסוים או לקבוצה מסוימת של ערוצים. התוצאות מקובצות לפי יום עבור כל סוג של דף או אפליקציה שבהם התרחשו הפעלות של סרטונים. התוצאות ממוינות בסדר כרונולוגי הפוך. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
עשרת המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגדול ביותר בסרטון מוטמע
השאילתה הזו מאחזרת את ספירת הצפיות ואת זמן הצפייה המשוער בסרטון מסוים או בקבוצת סרטונים. התוצאות מקובצות לפי האתר של הצד השלישי שבו הסרטון הוטמע. התוצאות ממוינות בסדר יורד לפי מספר הצפיות. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי וידאו לסרטונים שהעליתם.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
דוחות פלייליסטים
מספר הצפיות בפלייליסט וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את מספר הצפיות בפלייליסט, את זמן הצפייה המשוער בפלייליסט ואת מספר ההפעלות של הפלייליסט בכל הפלייליסטים בערוצים של בעלי התוכן. התוצאות נצברות על סמך סוג הדף או האפליקציה שבהם התרחשו הפעלות של סרטונים, והתוצאות ממוינות בסדר יורד לפי התחלת הפלייליסט.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
מספר הצפיות בפלייליסט וזמן הצפייה ממיקומי הפעלה שונים
השאילתה הזו מאחזרת את ההתחלות היומיות של הפלייליסטים, את מספר הצפיות בפלייליסט ואת זמן הצפייה המשוער בפלייליסט בארצות הברית בכל הפלייליסטים בערוצים של בעלי התוכן. התוצאות מוחזרות עבור כל סוג של דף או אפליקציה שבהם התרחשו צפיות בפלייליסט.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
דוחות סרטונים
ספירות זמן צפייה וזמן צפייה ממקורות תנועה שונים
בקשה זו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטונים של בעלי התוכן. המדדים נצברים לפי מקור תנועה, שמתאר את האופן שבו המשתמשים הגיעו לסרטון.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
ספירת צפיות יומית וזמן צפייה ממקורות תנועה שונים
הבקשה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער היומי בסרטונים של בעלי התוכן. המדדים נצברים על בסיס יומי לפי מקור התנועה וממוינים בסדר כרונולוגי הפוך.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
הערה: שני הדוחות לדוגמה הבאים נתמכים רק עבור מקורות תנועה ספציפיים. לדוגמה, למקור התנועה NO_LINK_EMBEDDED
אין פרטים נוספים, ולכן הדוחות האלה אינם זמינים עבור מקור זה. פרטים על מקורות התנועה שלגביהם סוגי הדוחות האלה זמינים בהגדרה insightTrafficSourceType.
עשרת המובילים – מונחי חיפוש ב-YouTube שמניבים את התנועה הרבה ביותר לסרטון
השאילתה הזו מאחזרת את 10 מונחי החיפוש שהניבו את מספר הצפיות הגבוה ביותר מתוצאות החיפוש ב-YouTube לסרטון ספציפי או לקבוצה ספציפית של סרטונים. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי וידאו לסרטונים שהעליתם.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
עשרת המובילים – אתרים חיצוניים שמניבים את נפח התנועה הגדול ביותר לסרטון
השאילתה הזו מאחזרת את 10 האתרים החיצוניים שהניבו את מספר הצפיות הגדול ביותר מתוצאות החיפוש של Google בסרטון ספציפי או בקבוצה של סרטונים. התוצאות ממוינות לפי זמן צפייה משוער בסדר יורד. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי וידאו לסרטונים שהעליתם.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
דוחות פלייליסטים
ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים במדינה מסוימת
הבקשה הזו מאחזרת את מספר הצפיות בפלייליסט, את מספר ההתחלות של הפלייליסט ואת זמן הצפייה המשוער בפלייליסט לצפיות בפלייליסט במדינה מסוימת. המדדים נצברים לפי מקור התנועה, שמתאר את האופן שבו המשתמשים הגיעו לפלייליסט.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים
בקשה זו מאחזרת צפיות בפלייליסט, מספר ההפעלות המשוער של הפלייליסט וזמן הצפייה המשוער
בפלייליסטים בערוץ אחד או יותר של בעלי התוכן. המדדים נצברים לפי
מקור התנועה. הערה: כדי להריץ את השאילתה הזו ב-API Explorer, צריך להחליף את המחרוזת
CHANNEL_ID
בערך הפרמטר filters
ברשימה
מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
דוחות סרטונים
מדדים יומיים של סוג המכשיר לגבי סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים
השאילתה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער לפי סוג מכשיר בסרטונים שבעלים של תוכן מסוים הגישו לגביהם הצהרת זכויות יוצרים. התוצאות מקובצות לפי יום עבור כל סוג מכשיר שבו התרחשו סרטונים. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
מדדים יומיים של מערכת ההפעלה לגבי סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים שנצפו במכשירים ניידים
השאילתה הזו מאחזרת ספירת צפיות יומית וזמן צפייה משוער לפי מערכת הפעלה עבור צפיות בסרטונים שהוגשה לגביהם הצהרת זכויות יוצרים על ידי בעלי תוכן מסוימים, שבוצעו בניידים. התוצאות מקובצות לפי יום עבור כל מערכת הפעלה שבה התרחשו הפעלות של סרטונים. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
מדדים יומיים של מערכת ההפעלה וסוג המכשיר
השאילתה הזו מאחזרת את ספירת הצפיות היומית ואת זמן הצפייה המשוער בסרטונים שבעלים של תוכן מסוים הגישו לגביהם הצהרה על זכויות יוצרים. הנתונים הסטטיסטיים מקובצים לפי מערכת הפעלה וסוג מכשיר. התוצאות ממוינות בסדר כרונולוגי.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
דוחות פלייליסטים
מדדים של סוג המכשיר לצפיות בפלייליסט במערכת ההפעלה Android
השאילתה הזו מאחזרת את מספר הצפיות בפלייליסט ואת זמן הצפייה המשוער בפלייליסט במכשירי Android
בפלייליסטים בערוץ אחד או יותר של בעלי התוכן. התוצאות מוצגות לגבי
כל סוג מכשיר שבו התרחשו צפיות בפלייליסט. הערה: כדי להריץ את השאילתה הזו ב-API
Explorer, צריך להחליף את המחרוזת CHANNEL_ID
בערך הפרמטר filters
ברשימה מופרדת בפסיקים של עד 500 מזהי ערוצים של הערוצים.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
מדדים של מערכת ההפעלה לצפיות בפלייליסט במכשירים ניידים
השאילתה הזו מאחזרת את מספר הצפיות בפלייליסט ואת זמן הצפייה המשוער בפלייליסט במכשירים ניידים בפלייליסטים בכל אחד מהערוצים של בעלי התוכן. התוצאות מוחזרות לגבי כל מערכת הפעלה שבה התרחשו צפיות בפלייליסט.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
דוחות סרטונים
מידע דמוגרפי של צופים בקליפורניה (קבוצת גיל ומגדר)
דוח זה מאחזר נתונים סטטיסטיים לגבי קבוצת הגיל והמגדר של צופים בקליפורניה שצפו בתוכן שהוגשה לגביו תלונה על ידי בעלי התוכן. התוצאות ממוינות לפי מגדר ואחר כך לפי קבוצת גיל. אפשר לשנות את השאילתה הזו כדי לאחזר את אותם נתונים סטטיסטיים לכל הצופים ברחבי העולם או לכל הצופים במדינה, ביבשת, בתת-יבשת או במדינה אחרת בארה"ב, על ידי התאמת ערך הפרמטר filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
מדדי שיתוף, נצברים לפי השירות שבו שותפו הסרטונים
הבקשה הזו מאחזרת את מספר הפעמים שמשתמשים השתמשו בלחצן Share
כדי לשתף סרטונים שבעלי התוכן העלו. התוצאות מצטברות לפי שירות השיתוף (Google+ , Twitter וכו') וממוינות בסדר יורד של מספר השיתופים.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
מדדי שימור קהל בסרטון
הדוח מודד את היכולת של סרטון לשמר את הקהל שלו. ניתן לאחזר את הדוח לגבי סרטון אחד בלבד בכל פעם. הערה: כדי להריץ את השאילתה הזו ב-APIs Explorer, צריך להחליף את המחרוזת VIDEO_ID
בערך הפרמטר filters
במזהה הווידאו של אחד מהסרטונים שהעליתם. לתשומת ליבך, דוחות שימור קהל לא תומכים באפשרות לציין ערכים מרובים למסנן video
.
בדוגמה הזו, הדוח משתמש במסנן audienceType
כדי להגביל את התגובה, כך שיכלול רק נתונים של צפיות אורגניות, שנובעות מפעולה ישירה של המשתמש, כמו חיפוש סרטון או קליק על סרטון מוצע. לכן הדוח לא כולל נתונים על צפיות ממודעות וידאו TrueView In-stream או ממודעות TrueView ברשת המדיה. אפשר להסיר את המסנן כדי לאחזר את נתוני שימור הקהל של הסרטון מכל סוגי הקהלים.
לתשומת ליבכם: נתונים עבור המסנן audienceType
זמינים החל מ-25 בספטמבר 2013. ה-API לא יחזיר נתונים לשאילתות שבהן נעשה שימוש במסנן כדי לנסות לאחזר נתונים מתאריכים קודמים. שאילתות שלא נעשה בהן שימוש במסנן יפעלו עבור כל תאריך שחל אחרי 1 ביולי 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
מדדים של הכנסות וביצועי מודעות עבור תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
הבקשה הזו מאחזרת את ההכנסות ומדדי ביצועי המודעות של התוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. הדוח מחזיר שורה אחת של נתונים שמכילה סכומים כוללים לכל אחד מהמדדים המבוקשים במהלך טווח התאריכים שצוין.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
הכנסות יומיות ומדדי ביצועי מודעות
בקשה זו מאחזרת את ההכנסות היומיות ואת מדדי ביצועי המודעות עבור התוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
ערכים של הכנסות וביצועי מודעות ספציפיות למדינה
בקשה זו מאחזרת ערכים של הכנסות וביצועי מודעות ספציפיות למדינה עבור התוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. התוצאות ממוינות בסדר יורד לפי סכום ההכנסה. כלומר, המדינה הראשונה ברשימה תהיה המדינה שבה השותף הניב את ההכנסה המשוערת הגבוהה ביותר.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 הסרטונים המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
הבקשה הזו מאחזרת את ההכנסות ומדדי ביצועי המודעות של 10 הסרטונים שהוגשה לגביהם תלונה על ידי בעלי התוכן, ושהניבו את ההכנסות הגבוהות ביותר. התוצאות ממוינות בסדר יורד לפי סכום ההכנסה. כלומר, הסרטון הראשון יהיה הסרטון עם ההכנסות המשוערות הגבוהות ביותר.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
מדדי ביצועים של מודעות מסוגים שונים
בקשה זו מאחזרת מדדי ביצועים של מודעות עבור תוכן שבעלי התוכן הצהירו על זכויות יוצרים לגביו. התוצאות מקובצות לפי סוג מודעה וכך ניתן להשוות בין ערכי ההכנסה והעלות לאלף חשיפות בסוגים שונים של מודעות.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType