YouTube Analytics API מאפשר ליצור דוחות בהתאמה אישית שמכילים נתונים מ-YouTube Analytics. ה-API תומך בדוחות של ערוצים ושל בעלי תוכן. השדות בדוחות מאופיינים כמאפיינים או כמדדים:
מאפיינים הם קריטריונים נפוצים שמשמשים לצבירת נתונים, כמו התאריך שבו התרחשה פעולה או המדינה שבה המשתמשים נמצאים.
בדוח, לכל שורת נתונים יש שילוב ייחודי של ערכי מאפיינים. לכן, המאפיינים שאתם בוחרים לדוח קובעים איך מערכת YouTube מחשבת את ערכי המדדים בדוח הזה.
מדדים הם מדידות ספציפיות שקשורות לפעילות המשתמשים, לביצועי המודעות או להכנסה המשוערת. מדדי פעילות המשתמשים כוללים דברים כמו מספר הצפיות בסרטונים ודירוגים (לייקים ודיסלייקים).
Analytics API מספק פרמטרים של סינון ומיון, כך שהאפליקציה שמבצעת את הקריאה לא צריכה לתמוך בפונקציות האלה באופן מקורי. ה-API גם מאפשר לאחזר נתונים של קבוצות ב-YouTube Analytics, כאשר קבוצה היא אוסף מותאם אישית של עד 500 סרטונים, פלייליסטים, ערוצים או נכסים.
בחירת פרמטרים של דוחות
כשמבקשים דוח באמצעות השיטה reports.query של ה-API, בקשת ה-API מכילה חמישה פרמטרים שקובעים איך יחושבו הערכים בדוח:
הפרמטרים
startDateו-endDateמציינים את התקופה שהדוח יכיל נתונים לגביה. התגובה מה-API מכילה נתונים עד היום האחרון שצוין, שבו כל המדדים בשאילתה זמינים בזמן השאילתה.הפרמטר
metricsמציין את המדידות שייכללו בדוח. בדוחות של ערוצים, המדדים מודדים את פעילות המשתמשים וכוללים ערכים כמו צפיות ולייקים. חלק מהמדדים גם מודדים את ביצועי המודעות או את ההכנסה המשוערת.הפרמטר
dimensionsמסביר איך המדדים יקובצו.הפרמטר
filtersמסביר איך נתוני הדוח יסוננו. לדוגמה, במקום להחזיר את כל הנתונים של ערוץ מסוים, אפשר לסנן את הדוח כך שיכיל רק מדדים של מדינה, סרטון או קבוצת סרטונים מסוימים.הערה: ה-API מאפשר לציין כמה ערכים למסננים video, playlist ו-channel. אם תעשו זאת, תוכלו גם לכלול את המסנן הזה ברשימת המאפיינים, כך שהמדדים שיוחזרו יקובצו גם לפי סרטון, פלייליסט או ערוץ.
אפשרויות דיווח לדוגמה
לדוגמה, נניח שבעלים של ערוץ רוצה לאחזר דוח על סוגי המכשירים שבהם צופים בסרטונים, כדי לקבוע כמה צפיות בסרטונים של הערוץ התרחשו במכשירים ניידים, בקונסולות משחקים, בטלוויזיות וכו'.
בעלי הערוץ מגדירים את הפרמטר
startDateלערך2015-06-01ואת הפרמטרendDateלערך2015-07-31. על סמך הערכים האלה, הדוח יכיל נתונים לתקופה של חודשיים.הדוח לפי סוג מכשיר תומך במדדים views ו-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 מציין כמה ערכים, אפשר לציין את video גם כמאפיין. כלומר, הפרמטר
dimensionsתומך גם בערכיםdeviceType,videoו-day,deviceType,video.- אם הבעלים של הערוץ כוללים את המאפיין video ברשימת המאפיינים, המדדים יציינו ערכים נפרדים לכל סרטון. (כמה פעמים צפו בסרטון XYZ בקונסולת משחקים ב-1 ביוני 2015?)
- אם בעלי הערוץ לא כוללים את המאפיין video ברשימת המאפיינים, המדדים יציינו את הערכים הכוללים של כל הסרטונים שצוינו. (כמה פעמים צפו בסרטונים ABC, DEF ו-XYZ בקונסולת משחקים ב-1 ביוני 2015?)
עדכניות הנתונים וזמן האחזור
ממשק YouTube Analytics API תומך בשאילתות ייעודיות, אבל נתוני הניתוח הבסיסיים הם לא בזמן אמת. עיבוד הנתונים בדרך כלל גורם לעיכוב של 48 עד 72 שעות. לכן, התגובות מה-API לא מכילות נתונים מהימים האחרונים, והשדה endDate בדוח כולל רק נתונים עד היום האחרון שבו כל המדדים המבוקשים עברו עיבוד מלא.
בגלל זמן האחזור של הנתונים, יכול להיות שיהיו הבדלים בין הנתונים שמוחזרים על ידי ה-API לבין המדדים בזמן אמת שמוצגים ב-YouTube Studio. אם האפליקציה שלכם דורשת נתונים סטטיסטיים בזמן אמת על סרטונים ספציפיים, כמו מספר הצפיות, הלייקים או התגובות הנוכחי, השתמשו בשיטה videos.list של YouTube Data API במקום ב-YouTube Analytics API.
אחזור דוחות
כדי לאחזר דוח, שולחים בקשת GET מורשית ל-method reports.query של ה-API, ומציינים את הפרמטרים שמגדירים את הדוח שרוצים לאחזר.
רשימה של הדוחות שנתמכים ב-API מופיעה במסמכי התיעוד של דוחות הערוץ ודוחות בעלי התוכן. כל הגדרת דוח מזהה את הערכים שהדוח מאפשר לפרמטרים metrics, dimensions ו-filters.
שיטות מומלצות
אפליקציות שמשתמשות ב-YouTube Analytics API צריכות תמיד לפעול לפי השיטות הבאות:
- אפשר להשתמש בשורת הכותרת של התגובה כדי לקבוע את סדר העמודות בדוח. לדוגמה, אל תניחו שהמדד views יהיה המדד הראשון שיוחזר בתגובה רק כי הוא המדד הראשון שמופיע בתיאור הדוח. במקום זאת, צריך להשתמש בשורת הכותרת של התשובה כדי לקבוע איזו עמודה מכילה את הנתונים האלה.
- אתם יכולים להשתמש ב-YouTube Data API כדי לאחזר מטא-נתונים נוספים של משאבים שזוהו בתגובות של YouTube Analytics API. כפי שצוין במדיניות המפתחים של שירותי ה-API של YouTube (סעיפים III.E.4.b עד III.E.4.d), לקוחות API חייבים למחוק או לרענן את המטא-נתונים של המשאבים שמאוחסנים מה-API הזה אחרי 30 יום.
מדדים נצברים ופריטים שנמחקו
התגובות של YouTube Analytics API לא מכילות פירוט של מדדים לפריטים שנמחקו. לדוגמה, אם בעלי ערוץ מוחקים סרטון, הסרטון הזה לא יופיע יותר בתגובה מה-API שמחזירה מדדים לכל סרטון בנפרד. עם זאת, דוחות שצוברים מדדים של קבוצת משאבים עדיין כוללים מדדים שמשויכים לפריטים שנמחקו.
לדוגמה, נניח שבעלים של ערוץ מאחזר שני דוחות. הדוח הראשון מציג את מספר הצפיות היומי הכולל בכל הסרטונים בערוץ בתקופה מסוימת. הדוח השני מפרט את סך הצפיות היומיות לפי סרטון באותה תקופה.
במקרה כזה, המספרים בדוח הראשון יכללו צפיות בסרטונים שנמחקו מאוחר יותר, כי הדוח הראשון מכיל נתונים מצטברים יומיים. עם זאת, הדוח השני לא יכלול צפיות שמשויכות לפריטים שנמחקו, כי הדוח השני מפרט צפיות על בסיס כל סרטון בנפרד. לכן, אם בערוץ נמחקו סרטונים במהלך התקופה שהדוח מכסה, יכול להיות שמספר הצפיות היומי הכולל שדווח בדוח הראשון יהיה גבוה יותר מסכום הצפיות היומיות בסרטונים ספציפיים בדוח השני.
אנונימיזציה של נתונים
חלק מהנתונים ב-YouTube Analytics מוגבלים אם המדדים לא מגיעים לסף מסוים. זה יכול לקרות במגוון דוחות. בפועל, זה אומר שדוח מסוים לא יכיל את כל הנתונים שלכם (או לא יכיל נתונים בכלל) אם:
אם לא הייתה מספיק תנועה לסרטון או לערוץ בפרק הזמן שבחרתם,
או
בחרתם מסנן או מאפיין שהערכים שלהם לא מגיעים לסף מסוים, למשל מקור תנועה או מדינה.
אם יש דוחות שחסרים בהם נתונים, זה יכול ליצור הבדלים בין הסכומים הכוללים שתראו בהם לאלה שתראו בדוחות אחרים. זה תלוי בשיטה שבה נצברים הנתונים בכל דוח.
לדוגמה, נניח שבעלים של ערוץ מאחזר שני דוחות. בדוח הראשון מופיע מספר הצפיות הכולל בסרטון מסוים, ובדוח השני מופיע מספר הצפיות הכולל בסרטון הזה לפי מדינה. נניח שהיו 1, 000 צפיות בסרטון בטווח זמן מסוים, שמתוכן 500 צפיות היו בארצות הברית, 498 צפיות בקנדה, ו-2 צפיות בצרפת.
בדוגמה הזו, בדוח הראשון יופיעו 1,000 צפיות בסרטון. בדוח השני יופיע רק שהסרטון נצפה 500 פעמים בארצות הברית ו-498 פעמים בקנדה. לכן יהיה הבדל בין הסכום הכולל של מספר הצפיות בשני הדוחות. שימו לב שהדוח השני לא יכיל שום אינדיקציה לכך שהיו עוד שתי צפיות (או שהיו צפיות בצרפת).
סוגי נתונים מסוימים
יכול להיות שהנתונים הבאים יהיו מוגבלים בדוחות של YouTube Analytics:
- מידע דמוגרפי, כמו גיל ומגדר.
- נתונים גיאוגרפיים, כולל מדדים או מאפיינים שקשורים למדינות או לאזורים שבהם הצופים נמצאים, כמו המדינות או האזורים שלהם. עם זאת, חשוב לזכור שהדוחות לא מחילים ספי מיקום גיאוגרפי על מדדי הכנסה.
- מדדים שקשורים למקורות תנועה ספציפיים, כמו מונחי חיפוש או כתובות URL חיצוניות שהובילו לצפיות בסרטונים שלכם. לדוגמה, מונחי חיפוש וכתובות URL שמובילים למספר קטן מאוד של צפיות לא יופיעו בדוחות, אבל עדיין תראו מונחים וכתובות URL שמושכים הרבה צופים לתוכן שלכם.
במרכז העזרה של YouTube מוסבר בהרחבה על נתונים מוגבלים בדוחות של YouTube Analytics.
ניצול המכסה
כל בקשת API שאתם שולחים נספרת כיחידה אחת במכסת השימוש ב-API. מגבלות המכסות מופיעות בחלונית Quotas במסוף Google Cloud.