במאמר הזה מוסבר על הדמיון וההבדלים בדרכים שבהן ממשקי ה-API של YouTube Analytics ושל YouTube Reporting מספקים גישה לנתונים של YouTube Analytics, כדי שתוכלו לבחור את ה-API המתאים לאפליקציה שלכם.
שני ממשקי ה-API מאפשרים לכם לאחזר נתונים מ-YouTube Analytics. בנוסף, שני ממשקי ה-API תומכים בבעלי ערוצי YouTube ובבעלי תוכן ב-YouTube, ולכל אחד מהם יש גישה לקבוצה ספציפית של דוחות:
-
דוחות הערוצים מכילים מדדים של פעילות המשתמשים בערוץ ספציפי.
-
דוחות של בעלי התוכן כוללים מדדים מצטברים של כל הערוצים שמקושרים לבעלי תוכן ספציפיים ב-YouTube. לדוגמה, לייבל יכול לאחזר דוח שמכיל נתונים סטטיסטיים משולבים של ערוצי YouTube של כל האומנים של הלייבל. חלק מהדוחות של בעלי התוכן מכילים מדדים של פעילות המשתמשים, ואחרים מכילים מדדים שקשורים להכנסות ולביצועי המודעות.
בנוסף, ה-Reporting API מאפשר לבעלי תוכן מסוימים לגשת לדוחות על הכנסות מפרסום שמנוהלים על ידי המערכת. אפשר לאחזר את הנתונים בדוחות שמנוהלים על ידי המערכת רק באמצעות Reporting API.
כל הבקשות ל-YouTube Analytics API ול-YouTube Reporting API צריכות להיות מאושרות על ידי בעלי הערוץ או בעלי התוכן שבבעלותם הנתונים המבוקשים.
תוכן הדוח
הדוחות שממשקי ה-API מאחזרים מכילים שני סוגי נתונים:
-
מאפיינים הם קריטריונים נפוצים שמשמשים לצבירת נתונים, כמו התאריך שבו התרחשה פעילות המשתמש או המדינה שבה נמצאים המשתמשים.
בדוח, לכל שורת נתונים יש שילוב ייחודי של ערכי מאפיינים. לכן, השילוב של ערכי המאפיינים בכל שורה משמש כמפתח הראשי של השורה הזו.
-
מדדים הם מדידות נפרדות של פעילות המשתמשים, ביצועי המודעות או הכנסה משוערת. מדדי פעילות המשתמשים כוללים נתונים כמו מספר הצפיות בסרטונים והדירוגים (לייקים ודיסלייקים).
בחירת ה-API המתאים לאפליקציה
- YouTube Analytics API
- YouTube Analytics API תומך בשאילתות ממוקדות בזמן אמת כדי ליצור דוחות YouTube Analytics בהתאמה אישית. ה-API מספק פרמטרים של סינון ומיון, כך שהאפליקציה שמבצעת את הקריאה לא צריכה לתמוך בפונקציות האלה באופן מובנה.
בכל בקשת API מצוין טווח התאריכים שעבורו יוחזרו הנתונים. בנוסף, ה-API מאפשר לאחזר קבוצות נתונים שבועיות וחודשיות. לכן, אפליקציית השיחות לא צריכה לאחסן מערכי נתונים שאוחזרו או נתונים סטטיסטיים מצטברים בטווחי תאריכים. - YouTube Reporting API
- YouTube Reporting API מאחזר דוחות בכמות גדולה שמכילים נתונים מ-YouTube Analytics לגבי ערוץ או בעלי תוכן. היא מיועדת לאפליקציות שיכולות לייבא קבוצות גדולות של נתונים, ומספקות כלים לסינון, למיון ולכריית הנתונים האלה.
כל דוח מכיל קבוצה מוגדרת מראש של שדות. אתם משתמשים ב-API כדי לתזמן משימות דיווח, שכל אחת מהן מזהה דוח ש-YouTube צריך ליצור. לאחר מכן, המערכת של YouTube יוצרת דוח יומי שאפשר להוריד באופן אסינכרוני. כל דוח מכיל נתונים לתקופה ייחודית של 24 שעות.
בנוסף, YouTube יוצר באופן אוטומטי קבוצה של דוחות שמנוהלים על ידי המערכת עבור בעלי תוכן שיש להם גישה לדוחות המתאימים ב-YouTube Studio. הדוחות האלה מספקים גישה פרוגרמטית לנתוני הכנסות מפרסום.
דוחות נתמכים
בטבלה הבאה מפורטים סוגי הדוחות שאפשר לאחזר באמצעות ממשקי ה-API. אפשר להשתמש ב-YouTube Analytics API כדי להריץ שאילתות ממוקדות, וב-YouTube Reporting API כדי להפיק דוחות בכמות גדולה.
יכול להיות שנתונים שזמינים בממשק API אחד לא יהיו זמינים בממשק API אחר. לדוגמה, YouTube Analytics API מאפשר לכם לאחזר מדדים של פעילות המשתמשים על בסיס שבועי או חודשי, אבל ב-YouTube Reporting API אתם צריכים לצבור את הנתונים בעצמכם. לעומת זאת, YouTube Reporting API תומך בדוחות על נכסים לבעלי תוכן, אבל הנתונים האלה לא זמינים דרך YouTube Analytics API.
| סוגי דוחות | |
|---|---|
| דוחות סרטונים | הפעולה נתמכת בערוצים (query או bulk) ובבעלי תוכן (query או bulk). בדוחות על סרטונים מוצגים נתונים סטטיסטיים על כל פעילות המשתמשים שקשורה לסרטונים בערוץ או לסרטונים של בעלי תוכן. לדוגמה, בדוחות האלה מופיע מספר הצפיות שהסרטונים שלכם קיבלו. ב-YouTube Analytics API, חלק מהדוחות על סרטונים של בעלי תוכן כוללים גם רווחים משוערים ומדדים של ביצועי מודעות. |
| דוחות על היקף החשיפה | האפשרות הזו נתמכת בערוצים (בכמות גדולה) ובבעלי תוכן (בכמות גדולה). מדדי היקף החשיפה זמינים גם בדוחות הווידאו עבור שאילתות ממוקדות. בדוחות על טווח הגעה מוצגים נתונים סטטיסטיים על חשיפות של תמונות ממוזערות של סרטונים ועל שיעורי קליקים. |
| דוחות על פלייליסטים | הפעולה נתמכת בערוצים (query או bulk) ובבעלי תוכן (query או bulk). דוחות הפלייליסטים מספקים נתונים סטטיסטיים שקשורים באופן ספציפי לצפיות בסרטונים שמתרחשות בהקשר של פלייליסט. YouTube Reporting API תומך בדוחות על שימור קהל בפלייליסטים, אבל YouTube Analytics API לא תומך בדוח דומה. |
| דוח ביצועי מודעות | נתמך עבור בעלי תוכן (שאילתה או הסרה בכמות גדולה). בדוחות ביצועי המודעות מוצגים מדדים שמבוססים על חשיפות של מודעות שהוצגו במהלך הפעלת סרטונים. המדדים האלה מתייחסים לכל חשיפה של מודעה, וכל הפעלה של סרטון יכולה להניב כמה חשיפות. |
| דוחות על הכנסות משוערות | האפשרות נתמכת לבעלי תוכן (בכמות גדולה). בדוחות ההכנסות המשוערות מופיע סך כל ההכנסות המשוערות מסרטונים ממקורות פרסום שנמכרו על ידי Google וממקורות שהם לא פרסומיים. הדוחות האלה כוללים גם כמה מדדים של ביצועי מודעות. שימו לב שדוחות בניהול המערכת מכילים נתונים של הכנסות בפועל. |
| דוחות נכסים | נתמך עבור בעלי תוכן (בכמות גדולה). בדוחות הנכסים מוצגים מדדים של פעילות המשתמשים שקשורים לסרטונים שמקושרים לנכסים של בעלי התוכן. סרטון נכלל בדוח של בעלי תוכן אם הם הגישו לגביו תלונה על הפרת זכויות יוצרים בטענה שהוא תואם לאחד מהנכסים שלהם. יכול להיות שבעלי התוכן או משתמש אחר ב-YouTube העלו את הסרטון. |
| דוחות שמנוהלים על ידי המערכת | האפשרות הזו נתמכת עבור בעלי תוכן שיש להם גישה לדוחות המתאימים בתפריט הדוחות ב-YouTube Studio. דוחות שמנוהלים על ידי המערכת מספקים נתוני הכנסה בפועל שהרוויחו נכסים וסרטונים. בדוח נוסף מפורטים הסרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים והנכסים שתואמים לסרטונים האלה. לא כל הדוחות של YouTube Studio זמינים ב-API. הערה: מערכת YouTube יוצרת באופן אוטומטי דוחות שמנוהלים על ידי המערכת לבעלי תוכן שיש להם גישה לדוחות המתאימים ב-YouTube Studio. כתוצאה מכך, התהליך לאחזור הדוחות האלה שונה מהתהליך לאחזור סוגי הדוחות האחרים ברשימה הזו. מידע נוסף זמין במאמר בנושא דוחות שמנוהלים על ידי המערכת. |
ההבדלים העיקריים
בטבלה הבאה מפורטים ההבדלים החשובים בין YouTube Analytics API לבין YouTube Reporting API.
| תכונה | YouTube Analytics API | YouTube Reporting API |
|---|---|---|
| תהליך לאחזור נתונים | בכל בקשת API מציינים את המאפיינים והמדדים שיוחזרו, וגם את תקופת הזמן שעבורה יוחזרו הנתונים. | אפליקציות מתזמנות משימות דיווח. לכל משימה, מערכת YouTube יוצרת דוחות יומיים שאפשר להוריד באופן אסינכרוני. |
| טווחי תאריכים | בחלק מהדוחות של ה-API מצוין התאריך שבו התרחשה פעילות המשתמש. חלק מהדוחות האלה תומכים במאפיינים לצבירת מדדי פעילות המשתמשים לפי חודש. | בכל הדוחות של API מצוין היום שבו התרחשה פעילות המשתמש. אפליקציות שמשתמשות ב-API יכולות להטמיע תכונות לצבירת נתונים במרווחי זמן קבועים. |
| סינון נתונים | אפשר לסנן דוחות כך שיכללו רק שורות שבהן למאפיין יש ערך ספציפי. ה-API תומך גם בכמה מאפיינים, כמו continent ו-subContinent, שמשמשים רק כמסננים. | ה-API תומך בהורדות בכמות גדולה של קבוצות נתונים שלמות. היא לא תומכת בסינון או בהחזרת נתונים למאפיינים שמשמשים רק לסינון. אפליקציית הלקוח מאחסנת את הנתונים שהורדו ומטמיעה תכונות משלה כדי לסנן את הנתונים. |
| מיון | אפשר למיין את הדוחות לפי ערכי המדדים שמוחזרים. חלק מהדוחות תומכים רק במספר מוגבל של תוצאות. לדוגמה, בדוח שבו מפורטים הסרטונים הכי נצפים בערוץ מופיעות עד 200 שורות. | ה-API הזה תומך בהורדות בכמות גדולה של קבוצות נתונים מלאות. אפליקציות לקוח יכולות להטמיע תכונות משלהן למיון הנתונים שהורדו. |
| ערכי ספירה | דוחות API מכילים ערכי טקסט, כמו ANDROID או CHANNEL, כדי לזהות ערכי מאפיינים ממוספרים. | דוחות API מכילים מספרים שלמים שאפשר למפות לערכי טקסט. |
| מכסה | שרת ה-API מעריך כל שאילתה כדי לקבוע את עלות המכסה שלה. בקטע שימוש במכסה מוסבר על המתודולוגיה בפירוט רב יותר. | השימוש במכסת הנפח לא מהווה בעיה כי הנתונים מאוחזרים פעם אחת ואז מסוננים, ממוינים ונשלחות לגביהם שאילתות בתוך האפליקציה. |
| דוחות ייחודיים |
|
|
| מאפיינים ייחודיים | group (מאפיין לסינון בלבד) continent (מאפיין לסינון בלבד) subContinent (מאפיין לסינון בלבד) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| מדדים ייחודיים | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
הבדלים בשמות בין ממשקי API
שני ממשקי ה-API משתמשים במוסכמות שונות למתן שמות כדי לזהות מאפיינים ומדדים. שמות של YouTube Analytics API משתמשים ב-camelCase, כמו adType. השמות ב-YouTube Reporting API הם באותיות קטנות וכוללים קו תחתון, כמו ad_type.
בטבלאות הבאות מפורטים השמות השונים שבהם משתמשים שני ממשקי ה-API כדי לזהות את אותם מדדים ומאפיינים. במקרים מסוימים, ההבדל בין שני השמות גדול יותר ממה שמתקבל אחרי המרה של שם מ-camelCase לקו תחתון. לדוגמה, המאפיין video ב-YouTube Analytics API נקרא video_id ב-YouTube Reporting API.