תובנות ליוצרים ב-YouTube

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

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

ל-API יש ארבע פונקציות עיקריות:

1. גילוי יוצרים: תוכלו למצוא את היוצרים המובילים לפי קבוצה נתונה של נושאים, נתונים דמוגרפיים, קהלים או מאפייני יוצרים.
2. תובנות לגבי מותגים של יוצרים: קבלת תובנות לגבי יוצרים שקשורים למותג מסוים.
3. תובנות לגבי יוצרים: אפשר לקבל תובנות לגבי ערוצים ספציפיים ב-YouTube, כמו מספר המנויים, מספר הצפיות והנתונים הדמוגרפיים של הקהל.
4. תובנות לגבי מגמות: מקבלים תובנות לגבי מגמות ספציפיות, על סמך קהלים או נושאים ספציפיים.

דרישות סף

‫ContentCreatorInsightsService.GenerateCreatorInsights הוא רכיב פרטי של Google Ads API שמוצע עם רישיון נתונים לא בלעדי וללא תמלוגים. שותפים רשומים יכולים להשתמש בספריות הלקוח הרגילות של Google Ads כדי לחפש יוצרים ותוכן ב-YouTube. כדי לעמוד בדרישות, השותפים צריכים לעמוד בתנאים הבאים:

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

למידע נוסף, אפשר לפנות לנציג Google.

יצירת תובנות לגבי יוצרים

כדי ליצור תובנות לגבי יוצרים, שולחים בקשה לשיטה ContentCreatorInsightsService.GenerateCreatorInsights. לשיטה הזו יש מגבלה של 5 שאילתות לשנייה (QPS), והיא מקבלת שלושה סוגים של קלט, בהתאם לסוג התובנות שרוצים לקבל: תובנות לגבי גילוי יוצרים, תובנות לגבי מותגים של יוצרים או תובנות לגבי יוצרים. צריך לציין את המיקומים במדינות שמהן רוצים לקבל נתונים.

1. אחזור נתונים להזנת התובנות לגבי יוצרים: אפשר לאחזר מאפיינים זמינים באמצעות AudienceInsightsService.ListAudienceInsightsAttributes, על ידי ציון המאפיינים שרוצים לאחזר, למשל KNOWLEDGE_GRAPH לנושאי עניין.

   מאפייני KNOWLEDGE_GRAPH יכללו תג InsightsKnowledgeGraphEntityCapabilities אחד או יותר. מאפיינים שנתמכים ב'תובנות בנושא יוצרים' יכללו תגים רלוונטיים במטא-נתונים של התשובה.

   שימו לב: למפתחים עם גישה אל ContentCreatorInsightsService תהיה גם גישה אוטומטית אל AudienceInsightsService.ListAudienceInsightsAttributes. נקודות קצה אחרות ב-AudienceInsightsService דורשות תהליך נפרד של רשימת היתרים.

   במדריך למדדי הקהלים יש מסמכים נוספים על ListAudienceInsightsAttributes.

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

   החל מ-Google Ads API v23, אפשר לציין קשרים מורכבים בין מאפייני קהל באמצעות audience_combinations. השדה הזה מאפשר להגדיר קהלים באמצעות לוגיקה בוליאנית (AND/OR) שלא אפשרית באמצעות audience_attributes.

   התג audience_attributes מתאים לטירגוט על סמך רשימה של מאפיינים מאוחדים (בשילוב עם OR) (למשל, משתמשים שמתעניינים ב'ספורט' או ב'נסיעות' או ב…), אבל התג audience_combinations מאפשר שליטה מפורטת יותר. כל תג InsightsAudienceAttributeGroup בתוך התג audience_combinations משלב מאפיינים עם OR לוגי. לאחר מכן, הקבוצות האלה משולבות עם AND לוגי.

   לדוגמה, כדי לטרגט קהל שמתעניין ב ("טיפוח העור" או "טיפוח השיער") וגם ב "קוסמטיקה", צריך להשתמש בשני פריטים InsightsAudienceAttributeGroup ב-audience_combinations. 'טיפוח העור', 'טיפוח השיער' ו'קוסמטיקה' הם נושאי עניין, המיוצגים על ידי ישויות ב-Knowledge Graph (לדוגמה, /m/014trl מייצג קוסמטיקה). הקבוצה הראשונה תכיל מאפיינים של ישויות ב-Knowledge Graph עבור 'טיפוח העור' ו'טיפוח השיער', והקבוצה השנייה תכיל את המאפיין של ישות ב-Knowledge Graph עבור 'קוסמטיקה'.

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

3. תובנות לגבי מותגים של יוצרים: אפשר לציין מותג כדי לחפש יוצרים מובילים. ‫API מחזיר תובנות לגבי ערוצים תואמים.

4. תובנות לגבי יוצרים: מספקים רשימה של מזהי ערוצים ב-YouTube. ה-API מחזיר תובנות לגבי הערוצים הספציפיים האלה.

השיטה generateCreatorInsights מחזירה אובייקט GenerateCreatorInsightsResponse. האובייקט הזה מכיל רשימה של אובייקטים מסוג YouTubeCreatorInsights. כל אובייקט YouTubeCreatorInsights מכיל את הפרטים הבאים על היוצר:

• שם היוצר/ת
• ערוץ YouTube
• מדדים כוללים של יוצרים
• רשימת התובנות לגבי ערוץ YouTube

האובייקט YouTubeMetrics מכיל את המדדים הבאים:

• מספר המנויים
• מספר צפיות
• מספר הסרטונים
• הוא יוצר פעיל של סרטוני Shorts
• הזדמנויות לשותפות (החל מגרסה 23)

כדי לדעת אם יוצר עומד בדרישות לשיתוף פעולה ליצירת תוכן ממותג מקורי, צריך לבדוק את הערך של partnership_opportunities. אם הערך CREATOR_PARTNERSHIPS מופיע ברשימה, היוצר עומד בדרישות.

אובייקט YouTubeChannelInsights מכיל את המידע הבא על ערוץ YouTube:

• שם הערוץ
• מזהה הערוץ
• כתובת ה-URL של הערוץ
• תיאור הערוץ
• מדדי הערוץ

• מאפייני הקהל של הערוץ (כמו גיל, מגדר ותחומי עניין של המשתמשים)

  פירוט)

• סרטונים מובילים

• סוג הערוץ

• השפות שמשויכות לתוכן בערוץ

• ציון רלוונטיות (לחיפושים של מגמות לפי נושא בלבד)

יצירת תובנות לגבי מגמות

כדי ליצור תובנות לגבי מגמות, שולחים בקשה לשיטה ContentCreatorInsightsService.GenerateTrendingInsights. לשיטה הזו יש מגבלה של 5 שאילתות לשנייה (QPS), והיא מקבלת שני סוגים של קלט, בהתאם לשאלה אם רוצים לקבל מגמות בקרב קהלים או מגמות בנושאים. צריך לציין את המיקום הספציפי במדינה שממנו רוצים לקבל מגמות.

1. נתונים להזנת הפונקציה GenerateTrendingInsights: אפשר לאחזר מאפיינים זמינים באמצעות AudienceInsightsService.ListAudienceInsightsAttributes, על ידי ציון המאפיינים שרוצים לאחזר, למשל KNOWLEDGE_GRAPH כדי לאחזר נושאים שמעוררים עניין.

   מאפייני KNOWLEDGE_GRAPH יכללו תג InsightsKnowledgeGraphEntityCapabilities אחד או יותר. מאפיינים שנתמכים ב'תובנות לגבי נושאים פופולריים' יכללו תגים רלוונטיים במטא-נתונים של התשובה.

   שימו לב: למפתחים עם גישה אל ContentCreatorInsightsService תהיה גם גישה אוטומטית אל AudienceInsightsService.ListAudienceInsightsAttributes. נקודות קצה אחרות ב-AudienceInsightsService דורשות תהליך נפרד של רשימת היתרים.

   במדריך למדדי הקהלים יש מסמכים נוספים על ListAudienceInsightsAttributes.

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

   החל מ-Google Ads API v23, אפשר לציין קשרים מורכבים בין מאפייני קהל באמצעות audience_combinations. השדה הזה מאפשר לכם להגדיר קהלים באמצעות לוגיקה בוליאנית (AND/OR) שלא אפשרית באמצעות audience_attributes.

   התג audience_attributes מתאים לטירגוט על סמך רשימה של מאפיינים מאוחדים (בשילוב עם OR) (למשל, משתמשים שמתעניינים ב'ספורט' או ב'נסיעות' או ב…), אבל התג audience_combinations מאפשר שליטה מפורטת יותר. כל תג InsightsAudienceAttributeGroup בתוך התג audience_combinations משלב מאפיינים עם OR לוגי. לאחר מכן, הקבוצות האלה משולבות עם AND לוגי.

   לדוגמה, כדי לטרגט קהל שמתעניין ב ("טיפוח העור" או "טיפוח השיער") וגם ב "קוסמטיקה", צריך להשתמש בשני פריטים InsightsAudienceAttributeGroup ב-audience_combinations. 'טיפוח העור', 'טיפוח השיער' ו'קוסמטיקה' הם נושאי עניין, המיוצגים על ידי ישויות ב-Knowledge Graph (לדוגמה, /m/014trl מייצג קוסמטיקה). הקבוצה הראשונה תכיל מאפיינים של ישויות ב-Knowledge Graph עבור 'טיפוח העור' ו'טיפוח השיער', והקבוצה השנייה תכיל את המאפיין של ישות ב-Knowledge Graph עבור 'קוסמטיקה'.

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

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