בדף הזה מוצגות דוגמאות של בקשות API של YouTube Analytics. כל דוגמה מתארת בקצרה את הדוח שמאוחזר, ואז מציגה את ערכי הפרמטרים 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
במזהה של בעלי התוכן שלך.
בנוסף, עליכם לעבור אימות כערוץ או כבעלי התוכן שצוינו כדי ש-APIs 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 הסרטונים הנצפים ביותר בערוץ. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. המשמעות היא שהסרטון הנצפה ביותר יוצג ראשון.
הערה: הדוח הזה מחייב לציין ערך לפרמטר של הבקשה 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
10 המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגבוה ביותר בסרטון מוטמע
השאילתה הזו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטון מסוים או בקבוצת סרטונים מסוימת. התוצאות מקובצות לפי האתר של הצד השלישי שבו הסרטון הוטמע. התוצאות ממוינות בסדר יורד לפי מספר הצפיות. הערה: כדי להריץ את השאילתה הזו ב-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 המובילים – אתרים חיצוניים שמושכים את רוב התנועה לסרטון
השאילתה הזו מאחזרת את 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 המובילים – הסרטונים הנצפים ביותר לבעלי תוכן
השאילתה הזו מאחזרת את 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 הסרטונים הנצפים ביותר בערוץ מסוים או בקבוצת ערוצים מסוימת. התוצאות ממוינות לפי מספר הצפיות בסדר יורד. המשמעות היא שהסרטון הנצפה ביותר יוצג ראשון. חשוב לשים לב שכדי להריץ את השאילתה הזו ב-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
ולהגדיר גם את הערך th
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
10 המובילים – אתרי צד שלישי שמניבים את מספר הצפיות הגבוה ביותר בסרטון מוטמע
השאילתה הזו מאחזרת את מספר הצפיות ואת זמן הצפייה המשוער בסרטון מסוים או בקבוצת סרטונים מסוימת. התוצאות מקובצות לפי האתר של הצד השלישי שבו הסרטון הוטמע. התוצאות ממוינות בסדר יורד לפי מספר הצפיות. הערה: כדי להריץ את השאילתה הזו ב-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 המובילים – אתרים חיצוניים שמושכים את רוב התנועה לסרטון
השאילתה הזו מאחזרת את 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
ספירת צפיות בפלייליסט וזמן צפייה ממקורות תנועה שונים
הבקשה הזו מאחזרת את הצפיות בפלייליסט, ההתחלות של הפלייליסט וזמן הצפייה המשוער בפלייליסט
עבור פלייליסטים באחד או יותר מהערוצים של בעלי התוכן. המדדים נצברים לפי
מקור התנועה. חשוב לשים לב שכדי להריץ את השאילתה הזו ב-APIs 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