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

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

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

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

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

אפשר להשתמש בנתונים משלימים כדי לגלות יוצרים מקומיים (יוצרים שנמצאים במדינה מסוימת או מפרסמים ממדינה מסוימת, והסרטונים שלהם נצפים במדינה הזו) באמצעות גילוי יוצרים לפי נושא או תובנות לגבי נושאים פופולריים.

דרישות סף

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

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

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

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

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

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

   אפשר לאחזר מאפייני קהל זמינים באמצעות 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 עבור 'קוסמטיקה'.

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

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

   יש לתייג את הישויות הנתמכות בשדה SearchTopics ביכולת CONTENT_TRENDING_INSIGHTS או ביכולת CREATOR_TOPIC_INSIGHTS. משתמשים ב-method‏ ListAudienceInsightsAttributes כדי לאחזר את היכולות הנתמכות של הישות.

   הערה: האפשרות search_brand הוצאה משימוש בגרסה 24.2 והוסרה בגרסה 25. במקום זאת, צריך להשתמש ב-search_topics.

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

נתונים משלימים ויוצרים מקומיים

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

לדוגמה, אפשר להוסיף את ערך ה-enum‏ LOCAL_CREATOR_DATA לשדה supplemental_data כדי לבקש נתונים של יוצרים מקומיים. אם אתם מחפשים יוצרים באמצעות search_topics (והנושא הוא ישות ב-Knowledge Graph שתויגה ביכולת CREATOR_TOPIC_INSIGHTS), ה-API יאכלס את השדה local_creator_insights בתגובה עם יוצרים מקומיים שהסכימו לשתף את נתוני המיקום שלהם.

שימו לב למפרטים הבאים לגבי גילוי יוצרים מקומיים:

• הגדרה: 'יוצרים מקומיים' הם יוצרים שנמצאים במדינה שנבחרה או מפרסמים ממנה, והתוכן שלהם נצפה במדינה הזו.
• הגבלה: לא ניתן להשתמש באפשרות 'גילוי יוצרים מקומיים' כשמגדירים את sub_country_locations בבקשה.
• יכולות: אפשר לאחזר את רשימת הישויות הנתמכות ב-Knowledge Graph ואת היכולות שלהן באמצעות ListAudienceInsightsAttributes.

השיטה generateCreatorInsights מחזירה אובייקט GenerateCreatorInsightsResponse. האובייקט הזה מכיל את השדות הבאים:

• ‫creator_insights: רשימה של אובייקטים מסוג YouTubeCreatorInsights שתואמים לקריטריונים העיקריים.
• ‫local_creator_insights: רשימה של אובייקטים מסוג YouTubeCreatorInsights ליוצרים מקומיים. השדה הזה מאוכלס רק אם נשלחה בקשה ל-LOCAL_CREATOR_DATA והקריטריונים שבהם נעשה שימוש היו search_topics.

כל אובייקט YouTubeCreatorInsights מכיל את הפרטים הבאים על היוצר:

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

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

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

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

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

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

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

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

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

   אפשר לאחזר מאפייני קהל זמינים באמצעות 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 עבור 'קוסמטיקה'.

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

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

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

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

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

נתונים משלימים ויוצרים מקומיים

בדומה ליצירת תובנות לגבי יוצרים, אפשר לבקש תכונות אופציונליות בתובנות לגבי נושאים פופולריים על ידי הגדרת השדה החוזר supplemental_data לערך LOCAL_CREATOR_DATA.

אם הבקשה לחיפוש נושאים פופולריים משתמשת ב-search_topics, השדה related_local_creators באובייקטים של TrendInsight שמוחזרים יאוכלס ביוצרים מקומיים שקשורים לנושא המבוקש והסכימו לשתף את נתוני המיקום שלהם. גילוי יוצרים מקומי כפוף לאותה הגדרה ולאותן מגבלות (למשל, הוא לא תואם ל-sub_country_locations).

מטא-נתונים של תובנות לגבי מגמות

ה-method‏ GenerateTrendingInsights מחזירה רשימה של אובייקטים מסוג TrendInsight, שכל אחד מהם מכיל:

• ‫trend_attribute: AudienceInsightsAttributeMetadata הראשי של המגמה.
• ‫trend_metrics: המדדים של המגמה, כמו אחוז השינוי בתקופה להשוואה.
• trend_data_points: נקודות נתונים היסטוריות של המגמה. השדה מאוכלס רק במגמות שמשתמשות ב-search_topics.
• ‫related_videos: רשימה של אובייקטים מסוג AudienceInsightsAttributeMetadata של סרטונים פופולריים שקשורים לנושא של המגמה. השדה הזה מאוכלס רק בנתוני מגמות שמתקבלים באמצעות search_topics. במאפיינים האלה, מאוכלס YouTubeVideoAttributeMetadata המקונן, שמכיל מטא-נתונים ברמת הסרטון (כמו כתובת ה-URL של הסרטון, כתובת ה-URL של התמונה הממוזערת ומספר הצפיות או הלייקים) ומטא-נתונים ברמת הערוץ (כמו מזהה הערוץ, השם וכתובת ה-URL).