במאמר הזה מוסבר על הדמיון וההבדלים בדרכים שבהן ממשקי ה-API של YouTube Analytics ושל YouTube Reporting מספקים גישה לנתונים של YouTube Analytics, כדי שתוכלו לבחור את ה-API המתאים לאפליקציה שלכם.
שני ממשקי ה-API מאפשרים לכם לאחזר נתונים מ-YouTube Analytics. בנוסף, שני ממשקי ה-API תומכים בבעלי ערוצים ובבעלי תוכן ב-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. דוחות שמנוהלים על ידי המערכת מספקים נתוני הכנסה בפועל שהרוויחו נכסים וסרטונים. בדוח נוסף מפורטים הסרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים והנכסים שתואמים לסרטונים האלה. לא כל הדוחות של Creator Studio זמינים ב-API. הערה: מערכת YouTube יוצרת באופן אוטומטי דוחות שמנוהלים על ידי המערכת לבעלי תוכן שיש להם גישה לדוחות המתאימים ב-Creator 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.