בעזרת התכונה 'תובנות לגבי יוצרים' אפשר לגלות יוצרים ב-YouTube ולקבל תובנות לגביהם. האפשרות הזו שימושית לסוכנויות ולמפרסמים שרוצים למצוא יוצרים שרלוונטיים לקהל היעד שלהם.
ל-API יש ארבע פונקציות עיקריות:
- גילוי יוצרים: אפשר למצוא את היוצרים המובילים לפי קבוצה נתונה של נושאים, נתונים דמוגרפיים, קהלים או מאפייני יוצרים.
- תובנות לגבי מותגים של יוצרים: קבלת תובנות לגבי יוצרים שקשורים למותג ספציפי.
- תובנות לגבי יוצרים: אפשר לקבל תובנות לגבי ערוצים ספציפיים ב-YouTube, כמו מספר המנויים, מספר הצפיות והנתונים הדמוגרפיים של הקהל.
- תובנות לגבי מגמות: מקבלים תובנות לגבי מגמות ספציפיות, על סמך קהלים או נושאים ספציפיים.
דרישות סף
ContentCreatorInsightsService.GenerateCreatorInsights
הוא רכיב פרטי של Google Ads API שמוצע עם רישיון נתונים לא בלעדי וללא תמלוגים. שותפים רשומים יכולים להשתמש בספריות הלקוח הרגילות של Google Ads כדי לחפש יוצרים ותוכן ב-YouTube.
כדי לעמוד בדרישות, השותפים צריכים לעמוד בתנאים הבאים:
- יש לכם כלי לתכנון או ממשק משתמש שישלב את Google Ads API.
- אפשר להשתמש ב-API כדי לעיין בתוכן וביוצרים ב-YouTube ולזהות הזדמנויות פוטנציאליות לפרסום.
- כדי לוודא שאתם עומדים בדרישות, עליכם להשלים הערכה מקדימה.
- לפעול בהתאם לדרישות השימוש בנתונים ולהסכים לעבור ביקורות תקופתיות של הנתונים.
- לחתום על הסכם לרישוי נתונים שמחייב מבחינה משפטית את הדרישות לשימוש בחבילת הגלישה.
- מאשרים את התנאים וההגבלות של Google Ads API.
למידע נוסף, אפשר לפנות לנציג Google.
יצירת תובנות לגבי יוצרים
כדי ליצור תובנות לגבי יוצרים, שולחים בקשה אל ה-method ContentCreatorInsightsService.GenerateCreatorInsights. בשיטה הזו יש מגבלה של 5 שאילתות לשנייה (QPS), והיא מקבלת שלושה סוגים של קלט, בהתאם לכך אם רוצים לשפר את יכולת הגילוי של יוצרים, לקבל תובנות לגבי מותגים של יוצרים או לקבל תובנות לגבי יוצרים. צריך לציין את המיקומים במדינות שמהם רוצים לקבל נתונים.
גילוי של יוצרים: אתם יכולים לספק רשימה של מאפייני קהל, כמו גיל, מגדר ותחומי עניין של משתמשים (כולל קהלים עם תחום עניין משותף, קהלים עם כוונת רכישה וקהלים שמטורגטים לפי אירועים משמעותיים בחיים). ה-API מחזיר רשימה של יוצרים שהקהלים שלהם תואמים למאפיינים האלה. אפשר גם לספק מאפייני יוצרים כדי לסנן את היוצרים שהתוכן שלהם תואם באופן ספציפי למאפייני היוצרים שהזנתם.
אפשר לאחזר מאפייני קהל זמינים באמצעות
AudienceInsightsService.ListAudienceInsightsAttributes. לשם כך, צריך לציין את המאפיינים שרוצים לאחזר, למשלKNOWLEDGE_GRAPHכדי לאחזר מאפיינים של נושאים שמעניינים את הקהל.החל מ-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.תובנות לגבי מותגים של יוצרים: אפשר לציין מותג כדי לחפש יוצרים מובילים. API מחזיר תובנות לגבי ערוצים תואמים.
תובנות לגבי יוצרים: צריך לספק רשימה של מזהי ערוצים ב-YouTube. ה-API מחזיר תובנות לגבי הערוצים הספציפיים האלה.
השיטה generateCreatorInsights מחזירה אובייקט GenerateCreatorInsightsResponse. האובייקט הזה מכיל רשימה של אובייקטים מסוג YouTubeCreatorInsights. כל אובייקט YouTubeCreatorInsights מכיל את הפרטים הבאים על היוצר:
- שם היוצר/ת
- ערוץ YouTube
- מדדים כוללים של יוצרים
- רשימת התובנות לגבי ערוץ YouTube
האובייקט YouTubeMetrics מכיל את המדדים הבאים:
- מספר המנויים
- מספר צפיות
- מספר הסרטונים
- הוא יוצר פעיל של סרטוני Shorts
- הזדמנויות לשותפות (החל מגרסה 23)
אובייקט YouTubeChannelInsights מכיל את המידע הבא על ערוץ YouTube:
- שם הערוץ
- מזהה הערוץ
- כתובת ה-URL של הערוץ
- תיאור הערוץ
- מדדי הערוץ
מאפייני הקהל של הערוץ (כמו גיל, מגדר ותחומי עניין של המשתמשים)
פירוט)
סרטונים מובילים
סוג הערוץ
השפות שמשויכות לתוכן בערוץ
ציון רלוונטיות (לחיפושים של מגמות בנושאים בלבד)
יצירת תובנות לגבי מגמות
כדי ליצור תובנות לגבי מגמות, שולחים בקשה אל ה-method ContentCreatorInsightsService.GenerateTrendingInsights. בשיטה הזו יש מגבלה של 5 שאילתות לשנייה (QPS), והיא מקבלת שני סוגים של קלט, בהתאם לשאלה אם רוצים לקבל נתונים על מגמות בקרב הקהל או על מגמות בנושאים.
צריך לציין את המדינה הספציפית שבה רוצים לקבל נתונים על מגמות.
מגמות בקרב קהלים: אתם יכולים לספק רשימה של מאפייני קהל, כמו גיל, מגדר ותחומי עניין של משתמשים (כולל קהלים עם תחום עניין משותף, קהלים עם כוונת רכישה וקהלים שמטורגטים לפי אירועים משמעותיים בחיים). ה-API מחזיר רשימה של תובנות לגבי מגמות בקרב קהלים ספציפיים, כולל מדדים כמו אחוז השינוי בערך המגמה במהלך תקופת ההשוואה.
אפשר לאחזר מאפייני קהל זמינים באמצעות
AudienceInsightsService.ListAudienceInsightsAttributes. לשם כך, צריך לציין את המאפיינים שרוצים לאחזר, למשלKNOWLEDGE_GRAPHכדי לאחזר מאפיינים של נושאים שמעניינים את הקהל.החל מ-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.מגמות בנושאים: רשימה של נושאי תוכן. ה-API מחזיר רשימה של תובנות לגבי המגמות בנושאים האלה, כולל מדדים כמו אחוז השינוי בערך המגמה במהלך תקופת ההשוואה.