במאמר הזה נסביר על הדמיון וההבדלים בדרכים שבהן ממשקי ה-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 Reporting API תומך בסוגי הדוחות הבאים:
| סוג הדוח | פרטים |
|---|---|
| דוחות פיננסיים ודוחות הכנסות | |
| הכנסות מפרסום | סיכומים חודשיים או שבועיים של הכנסות מפרסום. דוגמאות: content_owner_ad_revenue_summary_a1,
content_owner_estimated_revenue_a1 |
| הכנסות ממינויים | הכנסות ממינויים ללייבלים ולחברות להפצת מוזיקה. דוגמאות: music_content_owner_red_revenue_raw_a1,
content_owner_music_asset_red_revenue_raw_a1 |
| הכנסות מסרטוני Shorts | מאגרים ספציפיים למונטיזציה של סרטוני Shorts של בעלי תוכן ספציפיים. דוגמאות: music_content_owner_shorts_revenue_summary_a1 |
| דוחות של בעלי תוכן ונכסים | |
| ביצועי נכס | נתוני צפיות והתעניינות שמשויכים לנכסים ספציפיים (קודי ISRC או UPC), שנועדו לבעלי זכויות כדי לעקוב אחרי הביצועים בכל הערוצים שבבעלותם. דוגמאות: content_owner_asset_basic_a3,
content_owner_asset_demographics_a1 |
| תלונות והפניות | הדוח עוקב אחרי תלונות פעילות, קונפליקטים פוטנציאליים וחפיפות של קבצים לעיון, והוא מיועד לבעלי זכויות שרוצים לעקוב אחרי הביצועים בכל הערוצים שבבעלותם. דוגמאות: content_owner_active_claims_a3,
content_owner_asset_conflict_a3 |
| ניתוח נתוני סרטונים ופלייליסטים | |
| ניתוח נתונים של סרטונים ופלייליסטים | נתוני ביצועים מפורטים לסרטונים או לפלייליסטים ספציפיים, כמו מקורות תנועה, סוג מכשיר/מערכת הפעלה, מיקומי הפעלה ומידע דמוגרפי על הצופים. דוגמאות: channel_traffic_source_a3,
playlist_device_os_a2 |
בנוסף, 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.