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

דוחות סרטונים

מדדי זמן הצפייה היומי בסרטונים של ערוץ

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

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=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 האתרים המובילים – אתרים של צד שלישי שמניבים את רוב הצפיות בסרטון מוטמע

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

מדדי שימור קהל של סרטון

הדוח הזה מודד את היכולת של סרטון לשמר את הקהל שלו. אפשר לאחזר את הדוח רק לגבי סרטון אחד בכל פעם. הערה: כדי להריץ את השאילתה הזו ב-API Explorer, צריך להחליף את המחרוזת VIDEO_ID בערך הפרמטר filters במזהה הסרטון של אחד מהסרטונים שהועלו. לתשומת ליבכם: בדוחות שימור קהל אין אפשרות לציין כמה ערכים למסנן video.

בדוגמה הזו, הדוח משתמש במסנן audienceType כדי להגביל את התשובה כך שתכיל רק נתונים לגבי צפיות אורגניות, שהן תוצאה של פעולה ישירה של המשתמש, כמו חיפוש סרטון או קליק על סרטון מוצע. לכן, הדוח לא כולל נתונים על צפיות ממודעות TrueView בסרטון או ממודעות 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

דוחות סרטונים

מדדים יומיים של זמן צפייה בתוכן שהעליתם בעצמכם

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

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

דוחות על פלייליסטים

מספר הצפיות היומי בפלייליסט של בעלי תוכן

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

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

דוחות סרטונים

לייקים ודיסלייקים לפי סוג תוכן

השאילתה הזו מאחזרת את מספר הלייקים והדיסלייקים לכל סוג תוכן בערוץ מסוים או בקבוצה מסוימת של ערוצים. שימו לב: כדי להריץ את השאילתה הזו ב-API Explorer, צריך להחליף את המחרוזת CHANNEL_ID בערך של הפרמטר filters ברשימה של עד 500 מזהי ערוצים של הערוצים שלכם, מופרדים בפסיקים.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

דוחות סרטונים

ספירת צפיות וזמן צפייה ממיקומי הפעלה שונים

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

הערה: יש תמיכה בשני הדוחות לדוגמה הבאים רק לגבי מקורות תנועה ספציפיים. מקורות התנועה VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ו-NO_LINK_EMBEDDED הם חלק ממקורות התנועה שלא נתמכים.

10 המובילים – מונחי החיפוש ב-YouTube שמניבים את נפח התנועה הגבוה ביותר לסרטון

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

מדדי שימור קהל של סרטון

הדוח הזה מודד את היכולת של סרטון לשמר את הקהל שלו. אפשר לאחזר את הדוח רק לגבי סרטון אחד בכל פעם. הערה: כדי להריץ את השאילתה הזו ב-API Explorer, צריך להחליף את המחרוזת VIDEO_ID בערך הפרמטר filters במזהה הסרטון של אחד מהסרטונים שהועלו. חשוב לדעת: בדוחות שימור הקהל אין אפשרות לציין כמה ערכים למסנן video.

בדוגמה הזו, הדוח משתמש במסנן audienceType כדי להגביל את התגובה כך שתכלול רק נתונים לגבי צפיות אורגניות, שהן תוצאה של פעולה ישירה של משתמש, כמו חיפוש סרטון או לחיצה על סרטון מוצע. לכן, הדוח לא כולל נתונים לגבי צפיות ממודעות וידאו TrueView In-stream או ממודעות TrueView In-display. אפשר להסיר את המסנן כדי לאחזר את נתוני שימור הקהל של הסרטון מכל סוגי הקהלים.

חשוב לדעת: הנתונים של המסנן 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