YouTube Analytics API - Data Model

ממשק ה-API של YouTube Analytics מאפשר ליצור דוחות בהתאמה אישית שמכילים נתונים מ-YouTube Analytics. ממשק ה-API תומך בדוחות עבור בעלי תוכן. מאפייני הדוח מתאפיינים כמאפיינים או כמדדים:

  • מאפיינים הם קריטריונים נפוצים שמשמשים לצבירת נתונים, כמו התאריך שבו התרחשה פעולה או המדינה שבה המשתמשים היו.

    בדוח, בכל שורת נתונים יש שילוב ייחודי של ערכי מאפיינים. לכן, המאפיינים שאתם בוחרים בדוח קובעים את האופן שבו המערכת של YouTube מחשבת את הערכים של המדדים האלה.

  • מדדים הם מדדים ספציפיים הקשורים לפעילות המשתמשים, לביצועי המודעות או להכנסות המשוערות. מדדי פעילות המשתמשים כוללים ספירות של צפיות בסרטונים ודירוגים שלהם (לייקים ודיסלייקים).

ה-API של Analytics מספק פרמטרים של סינון ומיון, כך שאפליקציית ההתקשרות לא חייבת לתמוך באופן מקורי בפונקציות האלה. ממשק ה-API מאפשר גם לאחזר נתונים של קבוצות ב-YouTube Analytics, שבהן קבוצה היא אוסף מותאם אישית של עד 500 סרטונים, פלייליסטים, ערוצים או נכסים.

בחירת פרמטרים של דוחות

כשמבקשים דוח, באמצעות שיטת ה-API reports.query, הבקשה כוללת חמישה פרמטרים שקובעים איך יחושבו ערכי הדוחות:

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

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

  • הפרמטר dimensions מסביר איך לקבץ את המדדים.

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

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

אפשרויות דיווח לדוגמה

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

  • הבעלים של הערוץ מגדירים את הפרמטר startDate לערך 2015-06-01 ואת הפרמטר endDate לערך 2015-07-31. על סמך הערכים האלה, הדוח יכיל נתונים עבור תקופה של חודשיים.

  • דוח סוגי המכשירים תומך במדדים צפיות ו-estimatedMinutesWatched, כך שבעל הערוץ מגדיר את הפרמטר metrics ל-views,estimatedMinutesWatched.

  • עבור הפרמטר dimensions, יש לבעלי הערוץ כמה אפשרויות. שניים מהם מוצגים ברשימה הבאה, והשלישי מוצג בהסבר על ערך הפרמטר filters בהמשך הקטע הזה.

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

      • כמה פעמים צפו בסרטונים של הערוץ במכשירים ניידים בין 1 ביוני 2015 ל-31 ביולי 2015?
      • כמה פעמים הסרטונים של הערוץ נצפו בקונסולות משחקים בין 1 ביוני 2015 ל-31 ביולי 2015?

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

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

      • כמה פעמים צפו הסרטונים בערוץ במכשירים ניידים ב-1 ביוני 2015?
      • כמה פעמים צפו הסרטונים בערוץ בטלוויזיות ב-14 ביולי 2015?

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

    • בעל הערוץ יכול לסנן את הבקשה כדי להחזיר ערכים רק עבור מערכת ההפעלה Android. (כמה צפיות היו במכשירים ניידים עם Android במהלך תקופת הדיווח?)

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

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

      בנוסף, אם המסנן video מציין ערכים מרובים, ניתן לציין גם את המאפיין video כמאפיין. כלומר, הפרמטר dimensions תומך גם בערכים deviceType,video ו-day,deviceType,video.

      • אם הבעלים של הערוץ כוללים סרטון ברשימת המאפיינים, המדדים מציינים ערכים נפרדים לכל סרטון. (כמה פעמים נצפה סרטון XYZ בקונסולת משחקים ב-1 ביוני 2015?)
      • אם בעלי הערוץ לא כוללים סרטון ברשימת המאפיינים, המדדים מציינים את הערכים הכוללים הכוללים את כל הסרטונים שצוינו. (כמה פעמים צפו בסרטונים ABC , DEF ו-XYZ בקונסולת משחקים ב-1 ביוני 2015?)

המערכת מאחזרת דוחות

כדי לאחזר דוח, יש לשלוח בקשת GET מורשית לשיטת reports.query של ה-API, ולציין את הפרמטרים שמגדירים את הדוח שרוצים לאחזר.

עיינו בדוחות הערוצים ובדוחות של בעלי התוכן כדי לעיין ברשימה של דוחות הנתמכים על ידי ה-API. כל הגדרת דוח מזהה את הערכים שניתן להשתמש בהם בפרמטרים metrics, dimensions ו-filters.

שיטות מומלצות

אפליקציות שמשתמשות ב-API של YouTube Analytics צריכות תמיד לפעול בהתאם לשיטות הבאות:

  • אפשר להשתמש בשורת הכותרת של תגובה כדי לקבוע את סדר העמודות בדוח. לדוגמה, אל תניחו שצפיות יהיו המדד הראשון שמוחזר בתגובה, רק מפני שהוא הערך הראשון שרשום בתיאור הדוח. במקום זאת, אפשר להשתמש בשורת הכותרת של התגובה כדי לקבוע איזו עמודה מכילה את הנתונים האלה.
  • שימוש ב-YouTube Data API לאחזור מטא-נתונים נוספים עבור משאבים שזוהו בתגובות ב-YouTube Analytics API. כפי שצוין במדיניות למפתחים של שירותי YouTube API (סעיפים III.E.4.b עד III.E.4.d), לקוחות API צריכים למחוק או לרענן מטא-נתונים של משאבים מאוחסנים מ-API הזה לאחר 30 יום.

מדדים מצטברים ופריטים שנמחקו

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

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

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

אנונימיזציה של נתונים

חלק מהנתונים ב-YouTube Analytics מוגבלים כשהמדדים לא עומדים בסף מסוים. הדבר יכול להתרחש במגוון דוחות. בפועל, ייתכן שהדוח לא יכיל את כל הנתונים שלך (או את חלקם) אם:

  1. לסרטון או לערוץ יש תנועה מוגבלת במהלך תקופת זמן מסוימת,

    או

  2. בחרת מסנן או מאפיין, כמו מקור תנועה או מדינה, שהערכים שלהם לא עומדים בסף מסוים.

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

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

בדוגמה הזו, הדוח הראשון יציין שהסרטון נצפה 1000 פעמים. הדוח השני מציין רק שהסרטון נצפה 500 פעמים בארצות הברית ו-498 פעמים בקנדה. לכן, יהיה הבדל בין המספר הכולל של הצפיות בשני הדוחות. לתשומת ליבכם: הדוח השני לא יכיל אינדיקציה לכך שהתרחשו גם שתי צפיות אחרות (או שהתרחשו צפיות בצרפת).

הספים בפועל שבהם הנתונים מוגבלים אינם מפורסמים וכפופים לשינויים לפי שיקול דעתה של YouTube.

סוגי נתונים מוגבלים

הנתונים הבאים עשויים להיות מוגבלים בדוחות YouTube Analytics:

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

תוכלו לבקר במרכז העזרה של YouTube כדי לקבל מידע נוסף על נתונים מוגבלים בדוחות YouTube Analytics.

שימוש במכסה

כל בקשה ל-API נספרת כיחידה אחת של מכסת השימוש ב-API. המגבלות במכסות מופיעות בחלונית Quotas במסוף Google API.