הערה:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
בדף הזה מפורטים דוחות שבעלי תוכן יכולים לאחזר באמצעות YouTube Analytics API. הדוחות של בעלי התוכן כוללים מדדים לגבי ערוצים המקושרים לבעלי תוכן מסוימים ב-YouTube. מדדים הם אומדנים בודדים של פעילות משתמשים, ביצועי מודעות או הכנסה משוערת.
דוחות של סרטונים כוללים מדדי פעילות משתמשים, ביצועי מודעות והכנסות משוערות מסרטונים בערוצים של בעלי התוכן.
דוחות הפלייליסט מספקים נתונים סטטיסטיים שקשורים ספציפית לצפיות בסרטונים שמתרחשות בהקשר של פלייליסט. דוחות פלייליסטים משתמשים ברבים מאותם מאפיינים ומסננים כמו בדוחות וידאו.
דוחות ביצועי מודעות כוללים מדדים שקשורים להכנסות ולביצועי המודעות. הן משתמשות במאפיין adType כדי לקבץ מדדים על סמך סוגי המודעות שהוצגו במהלך הפעלות של סרטונים. בקטע דוחות ביצועי מודעות מוסברים שני הסוגים של מדדי ביצועי מודעות שנתמכים על ידי ה-API.
אחזור דוח
כדי לאחזר דוח של בעלי תוכן, צריך להפעיל את השיטה reports.query של ה-API ולהגדיר את ערך הפרמטר ids בבקשת ה-API כ-contentOwner==OWNER_NAME, כאשר OWNER_NAME מציין את המזהה של בעלי התוכן. אם אתם לא בטוחים לגבי הערך שאתם מציעים, שואלים את מנהל השותפים שלכם.
אישור
כל הבקשות של YouTube Analytics API חייבות להיות מאושרות. במדריך ההרשאות מוסבר איך משתמשים בפרוטוקול OAuth 2.0 כדי לאחזר אסימוני הרשאה.
בקשות API של YouTube Analytics משתמשות בהיקפי ההרשאה הבאים:
הצג דוחות כספיים של YouTube Analytics עבור התוכן שלך ב-YouTube. ההיקף הזה נותן גישה למדדים של פעילות המשתמשים ולמדדים של ההכנסות המשוערות ושל ביצועי המודעות.
https://www.googleapis.com/auth/youtube
ניהול חשבון YouTube שלך. ב-YouTube Analytics API, בעלי ערוצים משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים ב-YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
הצגה וניהול של נכסי YouTube ותוכן משויך ב-YouTube. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים ב-YouTube Analytics.
כל בקשות ה-API לאחזור דוחות של בעלי התוכן חייבות לסנן נתונים באמצעות המאפיין video, המאפיין channel או המאפיין isCurated, או באמצעות שילוב נתמך של המאפיינים claimedStatus ו-uploaderType. (השילובים הנתמכים מפורטים בהגדרת המאפיין uploaderType).
בטבלאות שמכילות הסבר על הדוחות הנתמכים, אפשר לזהות את המסננים שבהם אפשר להשתמש בכל דוח נתון. בתיאורים, מסננים שמופיעים בסוגריים הם אופציונליים. לדוגמה: אם בדוח מסוים מופיעה אפשרות סינון לפי video(,country), אפשר לסנן את הדוח כך שיכלול רק נתונים של סרטון ספציפי או רק נתונים לגבי סרטון ספציפי במדינה מסוימת.
ממשק ה-API תומך גם באפשרות לציין ערכים מרובים עבור המסננים video, playlist ו-channel. אם תציינו ערכים מרובים לאחד מהמסננים האלה, תוכלו גם להוסיף את המסנן הזה לרשימת המאפיינים שציינתם לבקשה. הדבר נכון גם אם המסנן לא רשום כמאפיין נתמך בדוח מסוים.
הסבר מלא על סינון תוצאות ה-API לפי ערך ספציפי או קבוצת ערכים ספציפית זמין בהגדרת הפרמטר filters.
הסבר על טבלאות של דוחות
בקטע הזה מוסבר על הפורמט והטרמינולוגיה של הטבלאות שמגדירות דוחות שנתמכים על ידי ה-API. בטבלה הבאה מפורטים המאפיינים, המדדים והמסננים הנתמכים בדוח הסרטונים עם פרטי ההפעלה, באמצעות מאפיין הזמן והמדד averageViewPercentage.
הטבלה מכילה שתי שורות למאפיינים, שורה אחת למדדים ושלוש שורות למסננים. עבור מאפיינים ומסננים, אפשר לשלב ערכים מכל שורה בבקשת API, כל עוד השילוב תואם לכללי השימוש בטבלה. לדוגמה, ערכי הפרמטרים dimensions החוקיים של הדוח כוללים:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
עם זאת, ערך הפרמטר day,month אינו חוקי כי הוא משתמש בשני מאפיינים
מבוססי-זמן, אבל הבקשה יכולה להשתמש ב-0 או ב-1. במקרה כזה, ערך הפרמטר subscribedStatus,youtubeProduct למעשה מחזיר דוח, אבל המדדים לא נצברים לפי יום, שבוע, חודש וכו' (הדוח הזה מתועד בנפרד במסמכי התיעוד).
דיווח על מונחים בטבלה
בטבלאות נעשה שימוש במונחים הבאים כדי לציין אם המאפיינים הם חובה או אופציונליים:
המשמעות של המונחים האלה היא שחובה ערך:
חובה:חובה לכלול את הערך.
יש להשתמש בערך 1: צריך לכלול ערך אחד מהקבוצה.
יש להשתמש ב-1 או יותר: אפשר לכלול כל ערך מהקבוצה או את כולם, אבל צריך לכלול לפחות ערך אחד.
המשמעות של המונחים האלה היא שהערך שלהם הוא אופציונלי:
אופציונלי: אפשר לכלול את הערך.
משתמשים ב-0 או ב-1: אפשר לכלול ערך אחד מהקבוצה.
משתמשים ב-0 או יותר: אפשר לכלול את כל הערכים מהקבוצה או את כולם.
חשוב: כל בקשות ה-API לאחזור דוחות וידאו של בעלי התוכן חייבות לסנן את הנתונים באמצעות המאפיין סרטון, המאפיין ערוץ, המאפיין קבוצה או שילוב נתמך של המאפיינים claimedStatus ו-uploaderType. (חלק מהדוחות לא תומכים בכל האפשרויות האלה). השילובים הנתמכים מפורטים גם בהגדרת המאפיין uploaderType:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
דוחות סרטונים
נתונים סטטיסטיים בסיסיים
נתונים סטטיסטיים בסיסיים (כולל ספירת מנויים)
דוח זה מספק נתונים סטטיסטיים הקשורים לפעולות משתמש בכל הערוצים של בעלי התוכן. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי מדינה או סרטון ספציפיים. ניתן להשתמש בו גם כדי לאחזר נתונים סטטיסטיים על תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, כולל תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים שהועלו על ידי בעלי התוכן, צדדים שלישיים או שניהם.
דוח זה מספק נתונים סטטיסטיים עבור מדינה ספציפית בארה"ב או מחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
דוח זה מספק נתונים סטטיסטיים הקשורים לפעולות משתמש בכל הערוצים של בעלי תוכן במרווחי זמן ספציפיים. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי מדינה או סרטון ספציפיים.
פעילות משתמשים במדינות בארה"ב בתקופות זמן ספציפיות
דוח זה מספק נתונים סטטיסטיים עבור מדינה ספציפית בארה"ב או מחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
הדוח מספק נתונים סטטיסטיים הקשורים לפעילות המשתמשים בכל מדינה בנפרד, עבור כל הערוצים של בעלי התוכן. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי סרטון או ערוץ ספציפיים.
הדוח הזה מספק מדדי פעילות משתמשים עבור צופים מנויים וצופים לא רשומים. אפשר לקבץ את הנתונים הסטטיסטיים לפי תקופה (יום או חודש), ואפשר לסנן את הדוח גם לפי מדינה, יבשת או subContinent.
מאפיין הזמן – יום או חודש – הוא אופציונלי בדוחות האלה, כי בכל מקרה, צריך להשתמש בפרמטרים של הבקשה startDate ו-endDate כדי לציין את טווח התאריכים שהדוח יכסה. אם המאפיין קיים, הוא מציין שאתם רוצים שהנתונים בדוח יצטברו לפי יום, חודש וכו'.
פרטי הפעלה עם מאפיין זמן אופציונלי ונתונים סטטיסטיים של liveOrOnDemand
דוח זה מספק נתונים סטטיסטיים של פרטי ההפעלה עבור מרווחי זמן ספציפיים. הוא תומך במאפיין liveOrOnDemand (והמסנן).
הערה: בדוח הזה צריך להגדיר את הפרמטר maxResults לערך מספר שלם עד 25. בניגוד לרוב הדוחות האחרים, הדוח הזה מחייב גם לציין ערך לפרמטר הבקשה sort.
דוח זה מזהה את נגני הווידאו המוטמעים שהניבו את מספר הצפיות או את זמן הצפייה הרב ביותר בתוכן של בעלי התוכן. בזמן אחזור הדוח צריך להגדיר את המסנן insightPlaybackLocationType לערך EMBEDDED.
דוח זה צובר נתונים סטטיסטיים על צפייה, בהתבסס על האופן שבו הצופים הגיעו לתוכן הווידאו שלך. לדוגמה, הוא מזהה את מספר הצפיות שנובעות מחיפוש Google או מקישור לסרטון קשור.
הערה: בדוח הזה צריך להגדיר את הפרמטר maxResults לערך מספר שלם עד 25. בניגוד לרוב הדוחות האחרים, הדוח הזה מחייב גם לציין ערך לפרמטר הבקשה sort.
דוח זה צובר נתונים סטטיסטיים של צפייה, על סמך הגורמים המפנים שהניבו את הצפיות הרבות ביותר בתוכן של בעלי התוכן. הגורמים המפנים מסווגים לפי סוג מקור התנועה, והגדרת המאפיין insightTrafficSourceDetail מזהה את מקורות התנועה שעבורם הדוח זמין. לדוגמה, אם הגדרת את המסנן insightTrafficSourceType כ-ADVERTISING, הדוח יפרט את סוגי המודעות שהניבו את הצפיות או את זמן הצפייה הרבים ביותר בתוכן של בעלי התוכן.
הערה: הדוח הזה נתמך רק לגבי מקורות תנועה ספציפיים. לדוגמה, מקור התנועה NO_LINK_EMBEDDED לא מכיל פרטים נוספים, ולכן הוא לא תומך בדוח הזה. אפשר לעיין בהגדרה של insightTrafficSourceType כדי לקבל פרטים על מקורות התנועה שתומכים בדוח הזה.
סוג המכשיר ומערכת ההפעלה
סוג מכשיר
בדוח הזה נצברים נתונים סטטיסטיים של צפייה, שמבוססים על סוג המכשיר שהצופים השתמשו בו בזמן הצפייה בתוכן. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו בטאבלטים או בקונסולות משחקים.
דוח זה צובר נתונים סטטיסטיים על צפייה, בהתבסס על מערכות ההפעלה של הצופים וסוגי המכשירים שלהם. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו בטאבלטים של Android או במחשבים עם Windows.
הדוח מודד את היכולת של סרטון לשמר את הקהל שלו. המאפיין elapsedVideoTimeRatio מודד את משך הסרטון שחלף לפי ערכי המדדים המתאימים. המדדים audienceWatchRatio ו-relativeRetentionPerformance מספקים שתי מדידות שמראות עד כמה הסרטון מצליח לשמר את הקהל שלו. הראשון הוא ערך מוחלט, והשני מציג את ביצועי הסרטון ביחס לביצועים של סרטונים אחרים ב-YouTube באורך דומה.
הערה: דוחות שימור קהל לא תומכים באפשרות לציין רשימת ערכים המופרדים בפסיקים עבור המסנן video. הערך חייב לציין מזהה וידאו אחד.
הערה: בדוחות האלה צריך להגדיר את הפרמטר maxResults כערך מספר שלם עד 200. נתונים שנאספו לפני 1 בינואר 2013 זמינים רק לגבי 10 הסרטונים המובילים. בניגוד לרוב הדוחות האחרים, בדוחות האלה צריך גם לציין ערך לפרמטר הבקשה sort.
הסרטונים המובילים באופן כללי, לפי מדינה, לפי יבשת או לפי תת-יבשת (<= 200 תוצאות)
דוח זה מפרט את הסרטונים המובילים של בעלי התוכן, בהתבסס על קריטריוני הסינון והמיון שצוינו.
סך כל הסרטונים המובילים לפי מדינה בארה"ב (<= 200 תוצאות)
הדוח הזה מפרט את הסרטונים המובילים של בעלי התוכן במדינה מסוימת בארה"ב או במחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
סרטונים מובילים לצופים רשומים או לא רשומים(<= 200 תוצאות)
הדוח הזה מציג את הסרטונים המובילים אצל צופים רשומים או לא רשומים. אפשר לסנן את הדוח כדי להציג את הסרטונים המובילים לפי מדינה, יבשת או subContinent. הדוח הקודם מאפשר לכם לאחזר את הסרטונים המובילים במדינה מסוימת בארה"ב עבור צופים רשומים או לא רשומים, אבל הוא תומך בפחות מדדים בהשוואה לדוח הזה.
בדוח הזה מוצגים הסרטונים המובילים והוא תומך במסננים של נתוני הפעלה ובמסננים גיאוגרפיים. הדוח הזה דומה לדוח הקודם, אבל הוא תומך בפחות מדדים ומוסיף תמיכה במסנן youtubeProduct.
סרטונים מובילים עם מסננים של פרטי הפעלה (<= 200 תוצאות)
בדוח הזה מפורטים הסרטונים המובילים של בעלי התוכן, ומסננים לפי מאפיין אחד או יותר של פרטי הפעלה: liveOrOnDemand , subscribedStatus ו-youtubeProduct. הדוח תומך גם בסינון לפי אזור.
דוחות לגבי פלייליסטים מכילים מדדים שקשורים לפעילות משתמשים שקשורה לסרטונים בפלייליסטים של
בעלי הערוץ. יש שתי גרסאות זמינות של הדוחות האלה, ולכל דוח זמין בקטעים הבאים יש תיאור של כל גרסה:
בכרטיסייה Recommended (מומלץ) בכל קטע, מתואר הפורמט המועדף של בקשת ה-API לאחזור הדוח המתאים. הדוחות המומלצים תומכים בקבוצה מורחבת של מדדים
שכוללים גם מדדי וידאו נצברים
וגם
מדדים בפלייליסט. בפורמט הבקשה הזה לא נעשה שימוש במאפיין isCurated.
בכרטיסייה שימוש ב-isCurated בכל קטע מתוארים פורמט ישן יותר של בקשות API, שבו נדרש המאפיין isCurated. הדוחות האלה תומכים
רק במדדים בתוך הפלייליסט. חשוב לשים לב
שהמאפיין isCurated הוצא משימוש בכל הדוחות. הערת האזהרה הבאה
מסבירה את לוח הזמנים להוצאה משימוש.
הערת האזהרה הבאה כוללת הסבר מפורט יותר על השינויים בין שתי גרסאות הדוח.
מדדי וידאו מצטברים
המדדים האלה מספקים מדדי פעילות משתמשים וחשיפות שנצברים לגבי כל הסרטונים
בפלייליסט, שנמצאים גם בבעלות הערוץ שהפלייליסט נמצא בבעלותו. מדדים של סרטונים
שנמצאים בבעלות של ערוצים אחרים לא מחושבים בחשבון הצבירה. לכן, אם ערוץ יוצר
פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, הדוחות של הפלייליסטים האלה לא
יספקו ערכים למדדים האלה.
כדאי לעיין בקטע מדדי פלייליסטים נתמכים כדי לקבל רשימה של
מדדי וידאו מצטברים שנתמכים ב-YouTube.
מדדים בתוך הפלייליסט
המדדים האלה משקפים את הפעילות ואת המעורבות של המשתמשים בהקשר של דף הפלייליסט. המדדים
האלה כוללים צפיות בכל הסרטונים בפלייליסט, ללא קשר לערוץ הבעלים שלהם, אבל הם
סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
דוח זה מספק נתונים סטטיסטיים הקשורים לאינטראקציות של משתמשים עם הסרטונים בפלייליסטים
בערוצים של בעלי התוכן במרווחי זמן ספציפיים. אפשר לסנן את הדוח כך שיוצגו בו רק
נתונים לגבי פלייליסט או ערוץ ספציפיים.
הדוח צובר נתונים סטטיסטיים על צפייה, בהתאם לאופן שבו הצופים הגיעו לתוכן הפלייליסט שלכם. לדוגמה, הוא מזהה את מספר הצפיות שהגיעו מחיפוש Google או מדף ערוץ.
הערה: בדוח הזה צריך להגדיר את הפרמטר maxResults לערך מספר שלם עד 25. בניגוד לרוב הדוחות האחרים, הדוח הזה מחייב גם לציין ערך לפרמטר הבקשה sort.
דוח זה צובר נתונים סטטיסטיים של צפייה, על סמך הגורמים המפנים שהניבו את הצפיות הרבות ביותר בפלייליסטים של בעלי התוכן. הגורמים המפנים מסווגים לפי סוג מקור התנועה, והגדרת המאפיין insightTrafficSourceDetail מזהה את מקורות התנועה שעבורם הדוח זמין. לדוגמה, אם המסנן insightTrafficSourceType מוגדר לערך ADVERTISING, הדוח יפרט את סוגי המודעות שהניבו את מספר הצפיות או זמן הצפייה הגבוה ביותר בפלייליסטים של בעלי התוכן.
הערה: הדוח הזה נתמך רק לגבי מקורות תנועה ספציפיים. לדוגמה, מקור התנועה NO_LINK_EMBEDDED לא מכיל פרטים נוספים, ולכן הוא לא תומך בדוח הזה. אפשר לעיין בהגדרה של insightTrafficSourceType כדי לקבל פרטים על מקורות התנועה שתומכים בדוח הזה.
סוג המכשיר ומערכת ההפעלה
סוג מכשיר לפלייליסטים
בדוח הזה נצברים נתונים סטטיסטיים על צפייה, בהתאם לסוג המכשיר שבו הצופים השתמשו כדי לצפות בתוכן של הפלייליסט. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו במכשירים ניידים או בקונסולות משחקים.
דוח זה צובר נתונים סטטיסטיים על צפייה, בהתבסס על מערכות ההפעלה של הצופים וסוגי המכשירים שלהם. לדוגמה, הנתון הזה מזהה את מספר הצפיות בפלייליסט שהתרחשו בטאבלטים של Android או במחשבים עם Windows.
אפשר להשתמש במסננים כדי להבטיח שהדוח מכיל רק נתוני viewerPercentage עבור ערך אחד (או שילוב של ערכים) במסגרת המאפיינים של פרטי ההפעלה.
הפלייליסטים המובילים
הערה: בדוחות האלה צריך להגדיר את הפרמטר maxResults כערך מספר שלם עד 200. נתונים שנאספו לפני 1 בינואר 2013 זמינים רק לגבי 10 הפלייליסטים המובילים. בניגוד לרוב הדוחות האחרים, בדוחות האלה צריך גם לציין ערך לפרמטר הבקשה sort.
הדוח הזה מפרט את הפלייליסטים המובילים של בעלי התוכן, בהתבסס על הקריטריונים לסינון ולמיון שצוינו.
דוחות ביצועי מודעות מספקים ערכים מבוססי-חשיפות לגבי מודעות שהוצגו במהלך הפעלת הסרטונים. המדדים האלה מתייחסים לכל חשיפה של מודעה, וכל הפעלה של סרטון יכולה להניב מספר חשיפות.
אלה הם מדדי הביצועים של מודעות שמבוססים על חשיפות:
