בדף הזה מפורטים דוחות שבעלי ערוצים יכולים לאחזר באמצעות YouTube Analytics API. דוחות ערוצים מספקים מדדי פעילות משתמשים עבור ערוץ מסוים ומודדים דברים כמו צפיות בסרטונים, דירוגים וספירות מנויים.
דוחות סרטונים מספקים נתונים סטטיסטיים על כל פעילות המשתמשים שקשורה לסרטונים בערוץ.
דוחות הפלייליסט מספקים נתונים סטטיסטיים שקשורים ספציפית לצפיות בסרטונים שמתרחשות בהקשר של פלייליסט.
דוחות ביצועי מודעות כוללים מדדים שקשורים להכנסות ולביצועי המודעות. הן משתמשות במאפיין adType כדי לקבץ מדדים על סמך סוגי המודעות שהוצגו במהלך הפעלות של סרטונים. בקטע דוחות ביצועי מודעות מוסברים שני הסוגים של מדדי ביצועי מודעות שנתמכים על ידי ה-API.
אחזור דוח
כדי לאחזר דוח ערוצים, עליך להגדיר את ערך הפרמטר ids בבקשת ה-API לאחד מהערכים הבאים:
channel==MINE – ה-API מחזיר נתונים עבור ערוץ YouTube של המשתמש המאומת.
channel==CHANNEL_ID – מגדירים את CHANNEL_ID למזהה הערוץ הייחודי של הערוץ שלגביו מאחזרים נתונים. המשתמש שמאשר את הבקשה חייב להיות הבעלים של הערוץ.
מזהה הערוץ הוא כרגע מחרוזת שמתחילה באותיות UC, אבל הפורמט שלו עשוי להשתנות. (אפשר למצוא את מזהה הערוץ בדף הגדרות חשבון מתקדמות של ערוץ YouTube, או לאחזר את מזהה הערוץ באופן פרוגרמטי באמצעות השיטה YouTube Data API'schannels.list).
אישור
כל הבקשות של 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.
הערה: מדדים של 'הכנסות משוערות' ו'ביצועי מודעות' לא נתמכים כרגע בדוחות ערוצים. כתוצאה מכך, ההיקף https://www.googleapis.com/auth/yt-analytics-monetary.readonly לא מאפשר כרגע גישה לנתונים כספיים בדוחות האלה.
מסננים
בטבלאות שמכילות הסבר על הדוחות הנתמכים, אפשר לזהות את המסננים שבהם אפשר להשתמש בכל דוח. בטבלאות, המסננים שמוצגים בסוגריים הם אופציונליים. למשל, באפשרות הסינון video(,country), המסנן וידאו הוא חובה והמסנן מדינה הוא אופציונלי.
ממשק ה-API תומך גם באפשרות לציין ערכים מרובים עבור המסננים video ו-playlist. אם תציינו ערכים מרובים לאחד מהמסננים האלה, תוכלו גם להוסיף את המסנן הזה לרשימת המאפיינים שציינתם לבקשה. הדבר נכון גם אם המסנן לא רשום כמאפיין נתמך בדוח מסוים.
הסבר מלא על סינון תוצאות ה-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 או יותר: אפשר לכלול את כל הערכים מהקבוצה או את כולם.
דוחות סרטונים
נתונים סטטיסטיים בסיסיים
נתונים סטטיסטיים בסיסיים של פעילות משתמשים
הדוח הזה מספק נתונים סטטיסטיים הקשורים לפעולות של משתמשים בערוץ. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי מדינה או סרטון ספציפיים.
נתונים סטטיסטיים בסיסיים לגבי פעילות משתמשים במדינות בארה"ב
דוח זה מספק נתונים סטטיסטיים עבור מדינה ספציפית בארה"ב או מחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
פעילות משתמשים במדינות בארה"ב בתקופות זמן ספציפיות
דוח זה מספק נתונים סטטיסטיים הקשורים לפעילות המשתמש במדינה מסוימת בארה"ב או במחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
הדוח הזה מספק מדדי פעילות משתמשים עבור צופים מנויים וצופים לא רשומים. אפשר לקבץ את הנתונים הסטטיסטיים לפי תקופה (יום או חודש), ואפשר לסנן את הדוח גם לפי מדינה, יבשת או subContinent.
מאפיין הזמן – יום או חודש – הוא אופציונלי בדוחות האלה, כי בכל מקרה, צריך להשתמש בפרמטרים של הבקשה startDate ו-endDate כדי לציין את טווח התאריכים שהדוח יכסה. אם המאפיין קיים, הוא מציין שאתם רוצים שהנתונים בדוח יצטברו לפי יום, חודש וכו'.
פרטי הפעלה עם מאפיין זמן אופציונלי ונתונים סטטיסטיים של liveOrOnDemand
דוח זה מספק נתונים סטטיסטיים של פרטי ההפעלה עבור מרווחי זמן ספציפיים. הוא תומך במאפיין liveOrOnDemand (והמסנן).
דוח זה צובר נתונים סטטיסטיים על צפייה, בהתבסס על האופן שבו הצופים הגיעו לתוכן הווידאו שלך. לדוגמה, הוא מזהה את מספר הצפיות שנובעות מחיפוש 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 תוצאות)
הדוח הזה מפרט את הסרטונים המובילים בערוץ. אפשר לסנן את הדוח כדי להציג את הסרטונים המובילים לפי מדינה, יבשת או subContinent.
בדוח הזה מפורטים הסרטונים המובילים בערוץ במדינה מסוימת בארה"ב או במחוז קולומביה. לתשומת ליבכם: הדוח הזה תומך רק בקבוצת משנה של המדדים שזמינים בדוח הספציפי למדינה שתיארנו קודם.
סרטונים מובילים לצופים רשומים או לא רשומים(<= 200 תוצאות)
בדוח הזה מפורטים הסרטונים המובילים בערוץ שמתייחסים לצופים רשומים או לא רשומים. אפשר לסנן את הדוח כדי להציג את הסרטונים המובילים לפי מדינה, יבשת או subContinent. הדוח הקודם מאפשר לכם לאחזר את הסרטונים המובילים במדינה מסוימת בארה"ב עבור צופים רשומים או לא רשומים, אבל הוא תומך בפחות מדדים בהשוואה לדוח הזה.
הדוח הזה כולל רשימה של הסרטונים המובילים בערוץ, והוא תומך בסינון פרטי ההפעלה ובמסננים הגיאוגרפיים. הדוח הזה דומה לדוח הקודם, אבל הוא תומך בפחות מדדים ומוסיף תמיכה במסנן youtubeProduct.
דוחות לגבי פלייליסטים מכילים מדדים שקשורים לפעילות משתמשים שקשורה לסרטונים בפלייליסטים של
בעלי הערוץ. יש שתי גרסאות זמינות של הדוחות האלה, ולכל דוח זמין בקטעים הבאים יש תיאור של כל גרסה:
בכרטיסייה Recommended (מומלץ) בכל קטע, מתואר הפורמט המועדף של בקשת ה-API לאחזור הדוח המתאים. הדוחות המומלצים תומכים בקבוצה מורחבת של מדדים
שכוללים גם מדדי וידאו נצברים
וגם
מדדים בפלייליסט. בפורמט הבקשה הזה לא נעשה שימוש במאפיין isCurated.
בכרטיסייה שימוש ב-isCurated בכל קטע מתוארים פורמט ישן יותר של בקשות API, שבו נדרש המאפיין isCurated. הדוחות האלה תומכים
רק במדדים בתוך הפלייליסט. חשוב לשים לב
שהמאפיין isCurated הוצא משימוש בכל הדוחות. הערת האזהרה הבאה
מסבירה את לוח הזמנים להוצאה משימוש.
הערת האזהרה הבאה כוללת הסבר מפורט יותר על השינויים בין שתי גרסאות הדוח.
מדדי וידאו מצטברים
המדדים האלה מספקים מדדי פעילות משתמשים וחשיפות שנצברים לגבי כל הסרטונים
בפלייליסט, שנמצאים גם בבעלות הערוץ שהפלייליסט נמצא בבעלותו. מדדים של סרטונים
שנמצאים בבעלות של ערוצים אחרים לא מחושבים בחשבון הצבירה. לכן, אם ערוץ יוצר
פלייליסט שמכיל רק סרטונים בבעלות של ערוצים אחרים, הדוחות של הפלייליסטים האלה לא
יספקו ערכים למדדים האלה.
כדאי לעיין בקטע מדדי פלייליסטים נתמכים כדי לקבל רשימה של
מדדי וידאו מצטברים שנתמכים ב-YouTube.
מדדים בתוך הפלייליסט
המדדים האלה משקפים את הפעילות ואת המעורבות של המשתמשים בהקשר של דף הפלייליסט. המדדים
האלה כוללים צפיות בכל הסרטונים בפלייליסט, ללא קשר לערוץ הבעלים שלהם, אבל הם
סופרים רק צפיות שהתרחשו בהקשר של הפלייליסט.
הדוח הזה כולל נתונים סטטיסטיים לגבי האינטראקציות של משתמשים עם הסרטונים
בפלייליסטים של הערוץ. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי פלייליסט ספציפי.
הדוח הזה כולל נתונים סטטיסטיים לגבי האינטראקציות של משתמשים עם הסרטונים
בפלייליסטים של הערוץ. אפשר לסנן את הדוח כך שיוצגו בו רק נתונים לגבי פלייליסט ספציפי.
בדוח הזה מוצגים נתונים סטטיסטיים לגבי פעילות של פלייליסטים במדינות בארה"ב ובמחוז קולומביה.
עבור דוח זה, עליך לסנן את התוצאות כדי להחזיר נתונים עבור ארה"ב בלבד.
הערה: בדוח הזה צריך להגדיר את הפרמטר maxResults
כערך מספר שלם עד 25. בניגוד לרוב הדוחות האחרים, הדוח הזה
מחייב גם לציין ערך לפרמטר הבקשה sort.
בדוח הזה נצברים נתונים סטטיסטיים של צפייה על סמך הגורמים המפנים שהניבו את מספר הצפיות
הגבוה ביותר בסרטונים בפלייליסטים של הערוץ. הגורמים המפנים מסווגים לפי סוג מקור התנועה, והגדרת המאפיין
insightTrafficSourceDetail מזהה את מקורות התנועה
שהדוח זמין עבורם.
לדוגמה, אם מגדירים את המסנן insightTrafficSourceType
לערך ADVERTISING, הדוח יפרט את סוגי המודעות שהניבו את
מספר הצפיות או זמן הצפייה הגבוה ביותר בפלייליסטים של הערוץ.
הערה: הדוח הזה נתמך רק לגבי מקורות תנועה ספציפיים. לדוגמה, מקור התנועה NO_LINK_EMBEDDED לא מכיל פרטים נוספים, ולכן הוא לא תומך בדוח הזה. אפשר לעיין בהגדרה של insightTrafficSourceType כדי לקבל פרטים על מקורות התנועה שתומכים בדוח הזה.
סוג המכשיר ומערכת ההפעלה
סוג מכשיר
בדוח הזה נצברות סטטיסטיקות צפייה על סמך האופן שבו הצופים הגיעו לסרטונים
בפלייליסטים שלך. לדוגמה, הוא מזהה את מספר הצפיות שהתרחשו במכשירים ניידים או בקונסולות משחקים.
דוח זה צובר נתונים סטטיסטיים על צפייה, בהתבסס על מערכות ההפעלה של הצופים וסוגי המכשירים שלהם.
לדוגמה, הוא מזהה כמה צפיות התרחשו בטאבלטים של Android או במחשבים עם Windows.
הערה: בדוחות האלה צריך להגדיר את הפרמטר maxResults כערך מספר שלם עד 200. נתונים שנאספו לפני 1 בינואר 2013 זמינים רק לגבי 10 הפלייליסטים המובילים. בניגוד לרוב הדוחות האחרים, בדוחות האלה צריך גם לציין ערך לפרמטר הבקשה sort.
הדוח הזה מציג את רשימת הפלייליסטים המובילים בערוץ, לפי הקריטריונים לסינון ולמיון שצוינו.
דוחות ביצועי מודעות מספקים ערכים מבוססי-חשיפות לגבי מודעות שהוצגו במהלך הפעלת הסרטונים. המדדים האלה מתייחסים לכל חשיפה של מודעה, וכל הפעלה של סרטון יכולה להניב מספר חשיפות.
אלה הם מדדי הביצועים של מודעות שמבוססים על חשיפות:
