בקשות API לדוגמה

בדף הזה מוצגות דוגמאות של בקשות 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.

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

מיון בקשות לפי מספר מאפיינים/מדדים

ה-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