‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

דרישות סף

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

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

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

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

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

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

אחזור מאפייני קהל זמינים באמצעות ListAudienceInsightsAttributes על ידי ציון המאפיינים שאתם צריכים, כמו KNOWLEDGE_GRAPH לנושאי עניין. כדי לשלב מאפיינים באמצעות קבוצות בוליאניות של AND ו-OR, משתמשים ב-audience_combinations, כמו שמתואר בקטע שילובים מורכבים של קהלים.
תובנות לגבי נושאי היוצרים (search_topics): מספקים רשימה של נושאי תוכן באמצעות השדה search_topics. ה-API מחזיר יוצרים רלוונטיים שיוצרים תוכן בנושאים שצוינו. הנתונים נשלפים עבור המדינה שצוינה ב-country_locations (האפשרות הזו תומכת במדינה אחת לכל בקשה).

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

הערה: האפשרות search_brand הוצאה משימוש ב-v24 והוסרה ב-v25. במקום זאת, צריך להשתמש ב-search_topics.
תובנות לגבי יוצרים (search_channels): מספקים רשימה של מזהי ערוצים ב-YouTube, כינויים של ערוצים ב-YouTube (youtube_channel_handles, זמינים בגרסה v25 ואילך) או שילוב של שניהם באמצעות השדה search_channels. ה-API מחזיר תובנות לגבי הערוצים הספציפיים האלה.

שילובים מורכבים של קהלים

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

כל InsightsAudienceAttributeGroup בתוך audience_combinations משלב את המאפיינים שלו עם OR לוגי.
כמה פריטים של InsightsAudienceAttributeGroup ב-audience_combinations משולבים עם AND לוגי.

לדוגמה, כדי לטרגט קהל שמתעניין ב-("Skin care" OR "Hair care") AND "Cosmetics", צריך לכלול שני פריטי InsightsAudienceAttributeGroup ב-audience_combinations:

קבוצה 1 שמכילה את מאפייני הישות של Knowledge Graph עבור "Skin care" ו-"Hair care".
קבוצה 2 שמכילה את מאפיין הישות של Knowledge Graph עבור "Cosmetics" (למשל /m/014trl).

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

כברירת מחדל, מוחזרים רק נתוני תובנות ליבה. כדי לבקש תכונות אופציונליות ונתונים נוספים בתשובה, אפשר להגדיר את השדה החוזר 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.

ה-method‏ GenerateCreatorInsights מחזירה אובייקט GenerateCreatorInsightsResponse שמכיל את השדות הבאים:

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

כל אובייקט YouTubeCreatorInsights מכיל:

‫creator_name: שם היוצר.
‫creator_channels: רשימה של אובייקטים מסוג YouTubeChannelInsights. פרטי הערוץ ו-channel_metrics (YouTubeMetrics) מוחזרים בתוך כל אובייקט YouTubeChannelInsights ב-creator_channels.

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

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

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

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

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

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

הפניה לבקשה ולתגובה של `GenerateCreatorInsights`

צריך להתקשר אל GenerateCreatorInsights בתאריך ContentCreatorInsightsService בנקודת הקצה הבאה:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

בטבלה הבאה מפורטים השדות בדף GenerateCreatorInsightsRequest:

נתיב השדה	דרישה	פורמט ומגבלות
`customer_id`	חובה	מספר לקוח בן 10 ספרות (`string`) בלי מקפים.
`customer_insights_group`	חובה	השם שהמשתמש הגדיר (`string`) ללקוח או למותג שעבורם מתבצע התכנון.
`country_locations[]`	חובה	רשימה של אובייקטים מסוג `LocationInfo` של מדינה (`geo_target_constant`, כמו `"geoTargetConstants/2840"`). חייבת להכיל מדינה אחת כשמשתמשים ב-`search_topics`.
`sub_country_locations[]`	אופציונלי	מסננים של אזורים במדינה `LocationInfo`; נתמכים רק עם `search_attributes` ולא תואמים ל-`LOCAL_CREATOR_DATA`.
`search_attributes`	‫`criteria` (`oneof`)	`SearchAttributes` שמכיל: • `audience_attributes[]`: `age_range`, `gender`, `device`, `parental_status`, `income_range` (וגם `user_interest`, `entity` או `category` כשלא משתמשים ב-`audience_combinations`). • ‫`audience_combinations[]`: AND-of-ORs `InsightsAudienceAttributeGroup` פריטים. • ‫`creator_attributes[]`: `entity` פריטים ב-Knowledge Graph עם היכולת `CREATOR_ATTRIBUTE`.
`search_topics`	‫`criteria` (`oneof`)	`SearchTopics` שמכיל את `entities[]` (`AudienceInsightsEntity` עם `knowledge_graph_machine_id` מתויג עם `CREATOR_TOPIC_INSIGHTS` או `CONTENT_TRENDING_INSIGHTS`).
`search_channels`	‫`criteria` (`oneof`)	`YouTubeChannels` שמכיל `youtube_channels[]` (`channel_id`) ו/או `youtube_channel_handles[]` (כינויים שמתחילים ב-`@`, כמו `"@youtubecreators"`).
`supplemental_data[]`	אופציונלי	ערכי `ContentCreatorInsightsSupplementalData`. כדי לאכלס את `local_creator_insights[]`, צריך להגדיר את `LOCAL_CREATOR_DATA` בבקשה של `search_topics` למדינה אחת (לישויות עם `CREATOR_TOPIC_INSIGHTS`).
`insights_application_info`	אופציונלי	מטא-נתונים של `AdditionalApplicationInfo` על האפליקציה ששולחת את הבקשה.

ההודעה GenerateCreatorInsightsResponse מחזירה את השדות הבאים:

שדה תשובה	סוג	תיאור
`creator_insights[]`	`YouTubeCreatorInsights`	יוצרים שעומדים בקריטריונים העיקריים שלך (`creator_name` ו-`creator_channels[]`).
`local_creator_insights[]`	`YouTubeCreatorInsights`	יוצרים מקומיים שהסכימו לשתף נתוני מיקום (השדה הזה מאוכלס כשמבקשים את `LOCAL_CREATOR_DATA` עם `search_topics` בישות עם `CREATOR_TOPIC_INSIGHTS`).
`creator_channels[]`	`YouTubeChannelInsights`	מטא-נתונים: `display_name`,‏ `youtube_channel.channel_id`,‏ `handle`,‏ `channel_url`,‏ `publish_date`,‏ `country_location` ו-`data_sharing_consent_given`. תובנות ותוכן: `channel_audience_attributes[]` (מותנה בהסכמה), `channel_attributes[]`,‏ `top_videos[]`,‏ `language_distributions[]`,‏ `relevance_score` (מאוכלס רק ל-`GenerateTrendingInsights` עם `search_topics`) ו-`channel_metrics`.
`channel_metrics`	`YouTubeMetrics`	מדדים גלויים לכולם: `subscriber_count`,‏ `views_count`,‏ `video_count`,‏ `likes_count`,‏ `shares_count`,‏ `comments_count`,‏ `shorts_views_count`,‏ `shorts_video_count`,‏ `is_active_shorts_creator`,‏ `is_active_live_stream_creator` ו-`partnership_opportunities[]`. מדדים שמותנים בהסכמה: `engagement_rate` וממוצעים של 28 ימים לכל סרטון (`average_views_per_video`,‏ `average_likes_per_video`,‏ `average_shares_per_video`,‏ `average_comments_per_video`).

דוגמאות לבקשות ולתשובות ב-`GenerateCreatorInsights` REST

בדוגמה הבאה מוצג חיפוש של יוצרים באמצעות searchAttributes עם המאפיינים הדמוגרפיים audienceAttributes, המאפיינים הבוליאניים audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") ו-creatorAttributes:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

כדי לאחזר יוצרים לפי נושאים וגם יוצרים מקומיים, משתמשים ב-searchTopics וכוללים את "LOCAL_CREATOR_DATA" ב-supplementalData:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

כדי לאחזר תובנות לגבי ערוצי YouTube ספציפיים לפי מזהה הערוץ או הכינוי, משתמשים ב-searchChannels:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

קריאה מוצלחת ל-GenerateCreatorInsightsResponse מחזירה את creatorInsights[] (ואת localCreatorInsights[] כשמבקשים את LOCAL_CREATOR_DATA):

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

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

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

למפתחים שיש להם גישה אל ContentCreatorInsightsService יש גישה אוטומטית אל ListAudienceInsightsAttributes ב-AudienceInsightsService (אפשר לעיין במדריך בנושא מדדי קהלים). נקודות קצה אחרות ב-AudienceInsightsService דורשות רשימת היתרים נפרדת.
מגמות של נושאים (search_topics): צריך לספק רשימה של נושאי תוכן בשדה search_topics. ה-API מחזיר תובנות לגבי מגמות בנושאים האלה, כולל אחוז השינוי בערך המגמה בתקופת ההשוואה. אפשר גם לבקש תובנות לגבי יוצרים מקומיים או לגבי הסנטימנט כלפי המותג באמצעות הגדרת supplemental_data.

המאפיינים של KNOWLEDGE_GRAPH שמוחזרים על ידי ListAudienceInsightsAttributes כוללים תג אחד או יותר של InsightsKnowledgeGraphEntityCapabilities. ישויות שמתויגות בתג CONTENT_TRENDING_INSIGHTS נתמכות כנושאים ב-GenerateTrendingInsights.

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

יוצרים מקומיים (LOCAL_CREATOR_DATA): כשבקשת הטרנדים משתמשת ב-search_topics (והנושא הוא ישות של Knowledge Graph שמתויגת ביכולת CREATOR_TOPIC_INSIGHTS), הגדרת supplemental_data לערך LOCAL_CREATOR_DATA מאכלסת את השדה related_local_creators באובייקטים המוחזרים של TrendInsight ביוצרים מקומיים קשורים שהסכימו לשתף את נתוני המיקום שלהם. התכונה "חיפוש יוצרים מקומיים" לא תואמת ל-sub_country_locations.
סנטימנט כלפי המותג (BRAND_SENTIMENT_DATA): כשבקשת המגמות משתמשת ב-search_topics ולנושא הישות המבוקש ב-Knowledge Graph יש את היכולת BRAND, הגדרת supplemental_data ל-BRAND_SENTIMENT_DATA מאכלסת את השדה brand_sentiment_insights באובייקטים המוחזרים של TrendInsight.

כדי למדוד את הסנטימנט כלפי המותג, מודלים של Gemini AI מנתחים את התוכן של סרטונים ב-YouTube שקשורים למותג, ומסווגים את הסנטימנט כחיובי, שלילי או ניטרלי. רק קטע הווידאו עצמו מנותח, ולא תגובות של משתמשים.

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

‫trend_attribute: AudienceInsightsAttributeMetadata הראשי של המגמה.
‫trend_metrics: המדדים של המגמה, כמו אחוז השינוי בתקופת ההשוואה.
‫trend: ערך של InsightsTrend (EMERGING,‏ RISING,‏ SUSTAINED או DECLINING) שמציין את כיוון המגמה. אפשר לראות את היקף השינוי בtrend_metrics.trend_change_percent.
‫trend_data_points: נקודות על הגרף של נתונים היסטוריים של המגמה. השדה הזה מאוכלס רק במגמות שמשתמשות ב-search_topics.
‫related_videos: רשימה של אובייקטים מסוג AudienceInsightsAttributeMetadata לסרטונים פופולריים שמשויכים לנושא של המגמה (מאוכלסת רק למגמות שמשתמשות ב-search_topics). במאפיינים האלה, השדה המקונן YouTubeVideoAttributeMetadata מאוכלס במטא-נתונים ברמת הסרטון (כתובת URL, כתובת URL של תמונה ממוזערת, מספר הצפיות ומספר הלייקים) ובמטא-נתונים ברמת הערוץ (מזהה הערוץ, השם וכתובת ה-URL).
‫related_creators: רשימה של אובייקטים מסוג YouTubeCreatorInsights ליוצרים שקשורים לנושא של הטרנד (מאוכלסת רק בטרנדים שמשתמשים ב-search_topics).
‫related_local_creators: רשימה של אובייקטים מסוג YouTubeCreatorInsights של יוצרים מקומיים שקשורים לנושא של הטרנד והסכימו לשתף את נתוני המיקום שלהם. השדה הזה מאוכלס רק כשמבקשים את LOCAL_CREATOR_DATA (ראו נתונים משלימים, יוצרים מקומיים וסנטימנט כלפי המותג).
‫brand_sentiment_insights: רשימה של אובייקטים מסוג BrandSentimentInsight למגמה (מאוכלסת כשהבקשה משתמשת ב-search_topics לישות עם היכולת BRAND ומבקשת BRAND_SENTIMENT_DATA). כל אובייקט מסוג BrandSentimentInsight מכיל:
- ‫month: החודש שהסנטימנט כלפי המותג מייצג, בפורמט YYYY-MM.
- has_insufficient_data: אם אין מספיק נתונים כדי לחשב את הסנטימנט כלפי המותג.
- sentiment_distributions: התפלגות הסנטימנט בין חיובי, שלילי וניטרלי, שמחושבת לפי שיעור הצפיות בסרטונים שקשורים למותג בכל סנטימנט.
- sentiment_summaries: סיכומים שנוצרו על ידי AI של נושאים חיוביים ושליליים בתוכן שקשור למותג, וגם סרטונים לאימון המודל לכל סנטימנט. הסיכומים נוצרים רק לסנטימנט חיובי ושלילי, ולא לסנטימנט ניטרלי.

הפניה לבקשה ולתגובה של `GenerateTrendingInsights`

צריך להתקשר אל GenerateTrendingInsights בתאריך ContentCreatorInsightsService בנקודת הקצה הבאה:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

בטבלה הבאה מפורטים השדות בדף GenerateTrendingInsightsRequest:

נתיב השדה	דרישה	פורמט ומגבלות
`customer_id`	חובה	מספר לקוח בן 10 ספרות (`string`) בלי מקפים.
`customer_insights_group`	חובה	השם שהמשתמש הגדיר (`string`) ללקוח או למותג שעבורם מתבצע התכנון.
`country_location`	חובה	מדינה אחת `LocationInfo` (`geo_target_constant`, כמו `"geoTargetConstants/2840"`).
`sub_country_locations[]`	אופציונלי	מסננים של אזורים במדינה `LocationInfo`; נתמכים רק ב-`search_audience` ולא תואמים ל-`LOCAL_CREATOR_DATA`.
`search_audience`	‫`criteria` (`oneof`)	`SearchAudience` שמכיל: • `audience_attributes[]` (חובה): `age_range`,‏ `gender`,‏ `parental_status`,‏ `income_range` (וגם `user_interest`,‏ `entity` או `category` כשלא משתמשים ב-`audience_combinations`). • ‫`audience_combinations[]` (אופציונלי): קבוצות של מאפיינים עם אופרטור AND של אופרטורים מסוג OR.
`search_topics`	‫`criteria` (`oneof`)	`SearchTopics` שמכיל את `entities[]` (`AudienceInsightsEntity` עם `knowledge_graph_machine_id` מתויג עם `CONTENT_TRENDING_INSIGHTS`).
`supplemental_data[]`	אופציונלי	ערכי `ContentCreatorInsightsSupplementalData`: • `LOCAL_CREATOR_DATA`: מאכלס את `related_local_creators[]` לישויות `search_topics` עם `CREATOR_TOPIC_INSIGHTS`. • `BRAND_SENTIMENT_DATA`: מאכלס את `brand_sentiment_insights[]` לישויות `search_topics` עם `BRAND`.
`insights_application_info`	אופציונלי	מטא-נתונים של `AdditionalApplicationInfo` על האפליקציה ששולחת את הבקשה.

ההודעה GenerateTrendingInsightsResponse מחזירה את הרשומות של TrendInsight ב-trend_insights[]:

השדה `TrendInsight`	סוג	תיאור
`trend_attribute`	`AudienceInsightsAttributeMetadata`	המאפיין הראשי של המגמה (`dimension`,‏ `display_name`,‏ `attribute`).
`trend_metrics`	`TrendInsightMetrics`	מדדים בתקופת ההשוואה של 3 חודשים (`views_count` ו-`views_indexed_value` עבור `search_topics`; `audience_share` עבור `search_audience`; `trend_change_percent`).
`trend`	`InsightsTrend`	כיוון המגמה (`EMERGING`,‏ `RISING`,‏ `SUSTAINED` או `DECLINING`).
`trend_data_points[]`	`TrendInsightDataPoint`	נתונים היסטוריים חודשיים (`month` בפורמט `YYYY-MM` ו-`trend_metrics`); מאוכלסים עבור `search_topics`.
`related_videos[]`	`AudienceInsightsAttributeMetadata`	סרטונים פופולריים עם `YouTubeVideoAttributeMetadata`; מאוכלסים עבור `search_topics`.
`related_creators[]`	`YouTubeCreatorInsights`	יוצרים שקשורים לנושא, מאוכלס עבור `search_topics`.
`related_local_creators[]`	`YouTubeCreatorInsights`	יוצרים מקומיים שהביעו הסכמה; מאוכלס עבור `search_topics` כאשר `LOCAL_CREATOR_DATA` מתבקש בישות עם `CREATOR_TOPIC_INSIGHTS`.
`brand_sentiment_insights[]`	`BrandSentimentInsight`	הסנטימנט החודשי כלפי המותג (`month`,‏ `has_insufficient_data`,‏ `sentiment_distributions[]`,‏ `sentiment_summaries[]`). מאוכלס ב-`search_topics` כשמבקשים את `BRAND_SENTIMENT_DATA` בישות עם היכולת `BRAND`.

דוגמה לבקשה ולתגובה ב-`GenerateTrendingInsights` REST

בדוגמה הבאה מתבצעת קריאה ל-GenerateTrendingInsights באמצעות searchTopics לישות מותג של Knowledge Graph (/g/11example_brand, מתויגת עם CONTENT_TRENDING_INSIGHTS,‏ CREATOR_TOPIC_INSIGHTS ו-BRAND) ומבקשת גם את LOCAL_CREATOR_DATA וגם את BRAND_SENTIMENT_DATA:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

אם הפעולה GenerateTrendingInsightsResponse בוצעה בהצלחה, יוחזרו רשומות TrendInsight ב-trendInsights[]:

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Google Issue Tracker

אתם יכולים להשתמש ב-Google Issue Tracker כדי לשאול שאלות תמיכה, לדווח על באגים או להגיש בקשה להוספת תכונה. ‫Google עוקבת אחרי הבקשות, מתעדפת אותן ומפרסמת עדכונים לגביהן ישירות ב-Issue Tracker. למידע נוסף, קראו את המאמר דיווח על בעיה ב-Google Issue Tracker.

יוצרים בעיה באמצעות אחת מהתבניות הבאות של Issue Tracker:

מלאו את כל השדות בתבנית במידע מפורט כדי ש-Google תוכל לשחזר את הבקשה ולתעדף אותה. יכול להיות ש-Google תסגור דוחות חלקיים ותבקש מכם לשלוח דיווח חדש עם הפרטים החסרים.

מדדי קהלים

נקודות השוואה ב-YouTube

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

דרישות סף

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

שילובים מורכבים של קהלים

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

הפניה לבקשה ולתגובה של GenerateCreatorInsights

דוגמאות לבקשות ולתשובות ב-GenerateCreatorInsights REST

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

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

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

הפניה לבקשה ולתגובה של GenerateTrendingInsights

דוגמה לבקשה ולתגובה ב-GenerateTrendingInsights REST

Google Issue Tracker

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

הפניה לבקשה ולתגובה של `GenerateCreatorInsights`

דוגמאות לבקשות ולתשובות ב-`GenerateCreatorInsights` REST

הפניה לבקשה ולתגובה של `GenerateTrendingInsights`

דוגמה לבקשה ולתגובה ב-`GenerateTrendingInsights` REST