Statystyki twórców YouTube

Odkrywaj i uzyskuj statystyki dotyczące twórców YouTube dzięki funkcji statystyk twórców w ContentCreatorInsightsService. Ta usługa pomaga agencjom i reklamodawcom znaleźć twórców, którzy są odpowiedni dla ich docelowych odbiorców.

Interfejs API ma 4 główne funkcje:

  1. Odkrywanie twórców: znajdź odpowiednich twórców na podstawie określonego zestawu tematów, danych demograficznych, odbiorców lub atrybutów twórców.
  2. Statystyki dotyczące tematów twórców: pobieraj statystyki dotyczące odpowiednich twórców, którzy tworzą treści na określone tematy.
  3. Statystyki twórców: pobieraj statystyki dotyczące konkretnych kanałów na YouTube, takie jak liczba subskrybentów, liczba wyświetleń i dane demograficzne odbiorców.
  4. Statystyki dotyczące trendów: uzyskuj statystyki dotyczące konkretnych trendów na podstawie określonych grup odbiorców lub tematów.

Wyszukiwanie lokalnych twórców (znajdowanie twórców, którzy mieszkają w danym kraju lub publikują z niego treści i są oglądani w tym kraju) jest obsługiwane, gdy korzystasz z wyszukiwania twórców na podstawie tematu lub statystyk dotyczących trendów, prosząc o dodatkowe dane. Możesz też poprosić o statystyki dotyczące opinii o marce w przypadku statystyk dotyczących trendów tematycznych, prosząc o dodatkowe dane.

Wymagania

GenerateCreatorInsights to prywatny komponent interfejsu Google Ads API oferowany z niewyłączną, bezpłatną licencją na dane. Zalogowani partnerzy mogą korzystać ze standardowych bibliotek klienta Google Ads, aby przeglądać twórców i treści w YouTube. Aby kwalifikować się do programu, partnerzy muszą spełniać te warunki:

  • mieć narzędzie do planowania lub interfejs użytkownika, który integruje interfejs Google Ads API;
  • Używaj interfejsu API do przeglądania treści i twórców na YouTube pod kątem potencjalnych możliwości reklamowych.
  • Przejdź wstępną ocenę, aby sprawdzić, czy się kwalifikujesz.
  • przestrzegać wymagań dotyczących wykorzystania danych i poddawać się okresowym kontrolom danych;
  • Zaakceptuj Warunki korzystania z usługi interfejsu Google Ads API i powiązane zasady użytkowania danych.

Aby uzyskać więcej informacji, skontaktuj się z przedstawicielem Google.

Generowanie statystyk twórców

Aby wygenerować statystyki dotyczące twórców, wyślij żądanie do metody GenerateCreatorInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). Akceptuje różne kryteria w zależności od tego, czy chcesz odkrywać twórców, wyszukiwać ich na podstawie tematu czy uzyskać statystyki dotyczące konkretnego kanału. Musisz podać lokalizacje krajów docelowych w country_locations.

  1. Odkrywalność twórców (search_attributes): podaj listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania użytkowników (odbiorcy o podobnych zainteresowaniach, odbiorcy na rynku i ważne wydarzenia życiowe), używając pola search_attributes, aby znaleźć twórców, których odbiorcy pasują do tych atrybutów. Możesz też podać atrybuty twórców, aby filtrować twórców, których treści pasują do określonych atrybutów.

    Pobierz dostępne atrybuty odbiorców za pomocą metody ListAudienceInsightsAttributes, określając potrzebne wymiary, np. KNOWLEDGE_GRAPH w przypadku tematów, które Cię interesują. Aby połączyć atrybuty za pomocą grup logicznych AND i OR, użyj audience_combinations zgodnie z opisem w artykule Złożone kombinacje list odbiorców.

  2. Statystyki dotyczące tematów twórcy (search_topics): podaj listę tematów treści za pomocą pola search_topics. Interfejs API zwraca odpowiednich twórców, którzy publikują treści na określone tematy. Dane są pobierane dla kraju określonego w parametrze country_locations (ta opcja obsługuje 1 kraj na żądanie).

    Obsługiwane encje w search_topics muszą być oznaczone tagiem funkcji CONTENT_TRENDING_INSIGHTS lub CREATOR_TOPIC_INSIGHTS. Użyj ListAudienceInsightsAttributes, aby pobrać obsługiwane funkcje encji.

  3. Statystyki twórców (search_channels): podaj listę identyfikatorów kanałów w YouTube, nicków kanałów w YouTube (youtube_channel_handles, dostępne w v25 i nowszych wersjach) lub kombinację obu tych elementów, korzystając z pola search_channels. Interfejs API zwraca statystyki dotyczące tych konkretnych kanałów.

Złożone kombinacje list odbiorców

Zarówno w GenerateCreatorInsights, jak i w GenerateTrendingInsights możesz definiować złożone relacje między atrybutami odbiorców za pomocą audience_combinations. To pole umożliwia łączenie odbiorców z połączonych list za pomocą operatorów logicznych (AND i OR) poza płaską sumą (OR) w audience_attributes:

  • Każdy element InsightsAudienceAttributeGroup w elemencie audience_combinations łączy swoje atrybuty z logicznym operatorem OR.
  • Wiele elementów InsightsAudienceAttributeGroup w audience_combinations jest połączonych operatorem logicznym AND.

Jeśli na przykład chcesz kierować reklamy na odbiorców zainteresowanych ("Skin care" OR "Hair care") AND "Cosmetics", dodaj 2 elementy InsightsAudienceAttributeGroup w audience_combinations:

  1. Grupa 1 zawierająca atrybuty encji Grafu wiedzy dla "Skin care" i "Hair care".
  2. Grupa 2 zawierająca atrybut encji Grafu wiedzy dla "Cosmetics" (np. /m/014trl).

Dane dodatkowe i lokalni twórcy

Domyślnie zwracane są tylko podstawowe dane statystyczne. Możesz poprosić o opcjonalne funkcje i dodatkowe dane w odpowiedzi, ustawiając pole powtarzane supplemental_data.

Możesz na przykład poprosić o dane lokalnego twórcy, dodając wartość typu wyliczeniowego LOCAL_CREATOR_DATA do supplemental_data. Jeśli wyszukujesz twórców za pomocą search_topics (a temat jest encją Grafu wiedzy oznaczoną tagiem z możliwością CREATOR_TOPIC_INSIGHTS), interfejs API wypełnia pole local_creator_insights w odpowiedzi lokalnymi twórcami, którzy wyrazili zgodę na udostępnianie danych o swojej lokalizacji.

Pamiętaj o tych wymaganiach dotyczących wyszukiwania lokalnych twórców:

  • Definicja: lokalni twórcy to twórcy, którzy mieszkają w wybranym kraju lub publikują z niego treści i są oglądani w tym kraju.
  • Ograniczenie: lokalne wyszukiwanie twórców nie jest obsługiwane, gdy w żądaniu ustawiono sub_country_locations.
  • Możliwości: listę obsługiwanych encji i ich możliwości w Grafie wiedzy możesz pobrać za pomocą metody ListAudienceInsightsAttributes.

Metoda GenerateCreatorInsights zwraca obiekt GenerateCreatorInsightsResponse zawierający te pola:

  • creator_insights: lista obiektów YouTubeCreatorInsights pasujących do Twoich podstawowych kryteriów.
  • local_creator_insights: lista obiektów YouTubeCreatorInsights dla twórców lokalnych. To pole jest wypełniane tylko wtedy, gdy żądano LOCAL_CREATOR_DATA i użyto kryteriów search_topics.

Każdy obiekt YouTubeCreatorInsights zawiera:

  • creator_name: imię i nazwisko twórcy.
  • creator_channels: lista obiektów YouTubeChannelInsights. Szczegóły kanału i channel_metrics (YouTubeMetrics) są zwracane w każdym obiekcie YouTubeChannelInsights w creator_channels.

Obiekt YouTubeMetrics zawiera:

  • Liczba subskrybentów, wyświetleń i filmów
  • Łączna liczba polubień, udostępnień i komentarzy pod wszystkimi filmami na kanale
  • Współczynnik zaangażowania od początku śledzenia (łączne zaangażowanie podzielone przez łączną liczbę wyświetleń)
  • Średnia liczba wyświetleń, polubień, udostępnień i komentarzy na film w ciągu ostatnich 28 dni
  • Wyświetlenia filmów Short i liczba filmów
  • Czy twórca jest aktywnym twórcą filmów Short lub aktywnym twórcą transmisji na żywo (opublikował co najmniej 1 film Short lub 1 transmisję na żywo w ciągu ostatnich 90 dni).
  • Możliwości współpracy

Współczynnik zaangażowania oraz średnia liczba wyświetleń, polubień i komentarzy na film to dane niepubliczne, które są wyświetlane tylko wtedy, gdy twórca wyraził zgodę na ich udostępnianie.

Aby sprawdzić, czy twórca kwalifikuje się do współpracy w zakresie oryginalnych treści tworzonych we współpracy z marką, sprawdź partnership_opportunities. Twórca kwalifikuje się, jeśli lista zawiera CREATOR_PARTNERSHIPS.

Obiekt YouTubeChannelInsights zawiera te informacje o kanale w YouTube:

  • Nazwa kanału, identyfikator, nick, adres URL, opis i adres URL miniatury
  • Data utworzenia kanału i powiązany z nim kraj
  • Dane dotyczące kanału
  • atrybuty odbiorców kanału (np. wiek, płeć i zainteresowania użytkowników);
  • atrybuty kanału (atrybuty powiązane z treściami kanału);
  • Najpopularniejsze filmy
  • Typ kanału i języki treści
  • Wynik trafności (tylko w przypadku wyszukiwań zyskujących popularność dotyczących tematów)
  • Czy twórca wyraził zgodę na udostępnianie niepublicznych danych

Dokumentacja żądań i odpowiedzi GenerateCreatorInsights

Wywołaj metodę GenerateCreatorInsights w ContentCreatorInsightsService w tym punkcie końcowym:

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

W tabeli poniżej znajdziesz podsumowanie pól na stronie GenerateCreatorInsightsRequest:

Ścieżka pola Wymaganie Format i ograniczenia
customer_id Wymagane 10-cyfrowy identyfikator klienta (string) bez łączników.
customer_insights_group Wymagane Zdefiniowana przez użytkownika nazwa (string) klienta lub marki, dla której tworzony jest plan.
country_locations[] Wymagane Lista obiektów LocationInfo kraju (geo_target_constant, np. "geoTargetConstants/2840"). Musi zawierać jeden kraj, gdy używany jest parametr search_topics.
sub_country_locations[] Opcjonalny Filtry regionu LocationInfo; obsługiwane tylko w przypadku search_attributes i niezgodne z LOCAL_CREATOR_DATA.
search_attributes criteria (oneof) SearchAttributes zawierający:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (oraz user_interest, entity lub category, gdy audience_combinations nie jest używany).
• audience_combinations[]: elementy AND-of-ORs InsightsAudienceAttributeGroup.
• creator_attributes[]: elementy Grafu wiedzy entity z możliwością CREATOR_ATTRIBUTE.
search_topics criteria (oneof) SearchTopics zawierający entities[] (AudienceInsightsEntity z knowledge_graph_machine_id otagowanym jako CREATOR_TOPIC_INSIGHTS lub CONTENT_TRENDING_INSIGHTS).
search_channels criteria (oneof) YouTubeChannels zawierający youtube_channels[] (channel_id) lub youtube_channel_handles[] (nick zaczynający się od @, np. "@youtubecreators").
supplemental_data[] Opcjonalny Wartości ContentCreatorInsightsSupplementalData. Ustaw LOCAL_CREATOR_DATA w żądaniu search_topics dotyczącym jednego kraju (w przypadku podmiotów z CREATOR_TOPIC_INSIGHTS), aby wypełnić local_creator_insights[].
insights_application_info Opcjonalny AdditionalApplicationInfo – metadane dotyczące aplikacji wysyłającej żądanie.

Komunikat GenerateCreatorInsightsResponse zwraca te pola:

Pole odpowiedzi Typ Opis
creator_insights[] YouTubeCreatorInsights Twórcy spełniający Twoje podstawowe kryteria (creator_name i creator_channels[]).
local_creator_insights[] YouTubeCreatorInsights Lokalni twórcy, którzy wyrazili zgodę na udostępnianie danych o lokalizacji (wypełniane, gdy żądanie LOCAL_CREATOR_DATA jest wysyłane z search_topics w przypadku elementu z CREATOR_TOPIC_INSIGHTS).
creator_channels[] YouTubeChannelInsights Metadane: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location i data_sharing_consent_given.
Statystyki i treści: channel_audience_attributes[] (wymagana zgoda), channel_attributes[], top_videos[], language_distributions[], relevance_score (wypełniane tylko w przypadku GenerateTrendingInsights z search_topics) i channel_metrics.
channel_metrics YouTubeMetrics Dane publiczne: 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 i partnership_opportunities[].
Dane wymagające zgody: engagement_rate i 28-dniowe średnie na film (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

Przykłady żądań i odpowiedzi REST w GenerateCreatorInsights

W tym przykładzie wyszukiwani są twórcy, którzy używają searchAttributes z danymi demograficznymi audienceAttributes, wartością logiczną audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") i 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"
        }
      }
    ]
  }
}

Aby pobrać twórców według tematu wraz z twórcami lokalnymi, użyj searchTopics i uwzględnij "LOCAL_CREATOR_DATA" w 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"
      }
    ]
  }
}

Aby pobrać statystyki dotyczące konkretnych kanałów na YouTube według identyfikatora kanału lub nicka, użyj 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"
    ]
  }
}

Pomyślne żądanie GenerateCreatorInsightsResponse zwraca creatorInsights[] (oraz localCreatorInsights[], gdy żądany jest 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": []
}

Aby wygenerować statystyki dotyczące trendów, wyślij żądanie do metody GenerateTrendingInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). Akceptuje 2 rodzaje danych wejściowych w zależności od tego, czy chcesz uzyskać trendy dotyczące odbiorców czy tematów, i wymaga podania lokalizacji kraju docelowego.

  1. Trendy dotyczące odbiorców (search_audience): podaj listę atrybutów odbiorców (takich jak wiek, płeć i zainteresowania użytkowników) w polu audience_attributes w search_audience i opcjonalnie użyj audience_combinations, aby połączyć atrybuty za pomocą operatorów logicznych AND/OR. Interfejs API zwraca listę statystyk dotyczących trendów dla tych odbiorców, w tym dane takie jak procentowa zmiana wartości trendu w okresie porównawczym.

    Deweloperzy, którzy mają dostęp do ContentCreatorInsightsService, automatycznie uzyskują dostęp do ListAudienceInsightsAttributes w AudienceInsightsService (zobacz przewodnik po statystykach odbiorców). Inne punkty końcowe w AudienceInsightsService wymagają osobnej listy dozwolonych.

  2. Trendy dotyczące tematów (search_topics): podaj listę tematów treści w polu search_topics. Interfejs API zwraca statystyki trendów dotyczące tych tematów, w tym procentową zmianę wartości trendu w okresie porównawczym. Możesz też poprosić o statystyki dotyczące lokalnych twórców lub nastawienia do marki, ustawiając parametr supplemental_data.

    Atrybuty KNOWLEDGE_GRAPH zwracane przez ListAudienceInsightsAttributes zawierają co najmniej 1 tag InsightsKnowledgeGraphEntityCapabilities. Elementy oznaczone tagiem CONTENT_TRENDING_INSIGHTS są obsługiwane jako tematy w GenerateTrendingInsights.

Podobnie jak w przypadku generowania statystyk dotyczących twórców, możesz poprosić o opcjonalne funkcje w statystykach trendów, ustawiając pole powtarzane supplemental_data na LOCAL_CREATOR_DATA lub BRAND_SENTIMENT_DATA:

  • Twórcy lokalni (LOCAL_CREATOR_DATA): gdy żądanie trendów używa search_topics (a temat jest encją Grafu wiedzy oznaczoną tagiem CREATOR_TOPIC_INSIGHTS), ustawienie supplemental_data na LOCAL_CREATOR_DATA powoduje wypełnienie pola related_local_creators w zwróconych obiektach TrendInsight powiązanymi twórcami lokalnymi, którzy wyrazili zgodę na udostępnianie danych o swojej lokalizacji. Wykrywanie twórców lokalnych jest niezgodne z funkcją sub_country_locations.
  • Nastawienie do marki (BRAND_SENTIMENT_DATA): gdy żądanie dotyczące trendów używa search_topics, a żądany temat encji Grafu wiedzy ma funkcję BRAND, ustawienie supplemental_data na BRAND_SENTIMENT_DATA wypełnia pole brand_sentiment_insights w zwróconych obiektach TrendInsight.

Pomiar nastawienia do marki wykorzystuje modele AI od Gemini do analizy treści filmów na YouTube związanych z marką i kategoryzuje nastawienie jako pozytywne, negatywne lub neutralne. Analizowane są tylko treści wideo, a nie komentarze użytkowników.

Metoda GenerateTrendingInsights zwraca listę obiektów TrendInsight, z których każdy zawiera:

  • trend_attribute: główny AudienceInsightsAttributeMetadata trendu.
  • trend_metrics: dane dotyczące trendu, np. zmiana procentowa w okresie porównawczym.
  • trend: wartość InsightsTrend (EMERGING, RISING, SUSTAINED lub DECLINING) wskazująca kierunek trendu. Aby sprawdzić rozmiar zmiany, zobacz trend_metrics.trend_change_percent.
  • trend_data_points: historyczne punkty danych dotyczące trendu. Wypełniane tylko w przypadku trendów korzystających z search_topics.
  • related_videos: lista obiektów AudienceInsightsAttributeMetadata dotyczących zyskujących popularność filmów powiązanych z tematem trendu (wypełniana tylko w przypadku trendów korzystających z search_topics). W przypadku tych atrybutów zagnieżdżony obiekt YouTubeVideoAttributeMetadata jest wypełniany metadanymi na poziomie filmu (adres URL, adres URL miniatury, liczba wyświetleń i polubień) oraz metadanymi na poziomie kanału (identyfikator kanału, nazwa i adres URL kanału).
  • related_creators: lista obiektów YouTubeCreatorInsights dotyczących twórców związanych z tematem trendu (wypełniana tylko w przypadku trendów korzystających z search_topics).
  • related_local_creators: lista obiektów YouTubeCreatorInsights dotyczących lokalnych twórców związanych z tematem trendu, którzy wyrazili zgodę na udostępnianie danych o lokalizacji. Wypełniane tylko wtedy, gdy żądany jest parametr LOCAL_CREATOR_DATA (patrz Dane dodatkowe, lokalni twórcy i nastawienie do marki).
  • brand_sentiment_insights: lista obiektów BrandSentimentInsight dla trendu (wypełniana, gdy żądanie używa search_topics dla encji z możliwością BRAND i żąda BRAND_SENTIMENT_DATA). Każdy obiekt BrandSentimentInsight zawiera:
    • month: miesiąc, którego dotyczy nastawienie do marki, w formacie YYYY-MM.
    • has_insufficient_data: czy jest za mało danych, aby obliczyć nastawienie do marki.
    • sentiment_distributions: rozkład nastawienia między pozytywnym, negatywnym i neutralnym, obliczany jako odsetek wyświetleń filmów odpowiadających marce z każdym nastawieniem.
    • sentiment_summaries: wygenerowane przez AI podsumowania pozytywnych i negatywnych motywów w treściach związanych z marką wraz z przykładowymi filmami dla każdego nastroju. Podsumowania są generowane tylko w przypadku pozytywnego i negatywnego nastawienia, a nie neutralnego.

Wywołaj metodę GenerateTrendingInsights w ContentCreatorInsightsService w tym punkcie końcowym:

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

W tabeli poniżej znajdziesz podsumowanie pól na stronie GenerateTrendingInsightsRequest:

Ścieżka pola Wymaganie Format i ograniczenia
customer_id Wymagane 10-cyfrowy identyfikator klienta (string) bez łączników.
customer_insights_group Wymagane Zdefiniowana przez użytkownika nazwa (string) klienta lub marki, dla której tworzony jest plan.
country_location Wymagane Pojedynczy kraj LocationInfo (geo_target_constant, np. "geoTargetConstants/2840").
sub_country_locations[] Opcjonalny Filtry regionów w kraju LocationInfo; obsługiwane tylko w przypadku search_audience i niezgodne z LOCAL_CREATOR_DATA.
search_audience criteria (oneof) SearchAudience zawierający:
• audience_attributes[] (wymagany): age_range, gender, parental_status, income_range (oraz user_interest, entity lub category, gdy nie jest używany audience_combinations).
• audience_combinations[] (opcjonalnie): grupy atrybutów AND-of-ORs.
search_topics criteria (oneof) SearchTopics zawierający entities[] (AudienceInsightsEntity z knowledge_graph_machine_id otagowanym jako CONTENT_TRENDING_INSIGHTS).
supplemental_data[] Opcjonalny Wartości ContentCreatorInsightsSupplementalData:
• LOCAL_CREATOR_DATA: wypełnia related_local_creators[] w przypadku elementów search_topics wartością CREATOR_TOPIC_INSIGHTS.
• BRAND_SENTIMENT_DATA: wypełnia brand_sentiment_insights[] w przypadku elementów search_topics wartością BRAND.
insights_application_info Opcjonalny AdditionalApplicationInfo – metadane dotyczące aplikacji wysyłającej żądanie.

Komunikat GenerateTrendingInsightsResponse zwraca wpisy TrendInsight w trend_insights[]:

TrendInsight pole Typ Opis
trend_attribute AudienceInsightsAttributeMetadata Atrybut podstawowy trendu (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics Dane z 3-miesięcznego okresu porównawczego (views_count i views_indexed_value dla search_topics; audience_share dla search_audience; trend_change_percent).
trend InsightsTrend Kierunek trendu (EMERGING, RISING, SUSTAINED lub DECLINING).
trend_data_points[] TrendInsightDataPoint Miesięczne dane historyczne (month w formacie YYYY-MM i trend_metrics); wypełnione dla: search_topics.
related_videos[] AudienceInsightsAttributeMetadata Filmy zyskujące popularność z YouTubeVideoAttributeMetadata; wypełnione dla: search_topics.
related_creators[] YouTubeCreatorInsights Twórcy powiązani z tematem; wypełnione dla: search_topics.
related_local_creators[] YouTubeCreatorInsights Wyrażający zgodę twórcy lokalni; wypełniane dla search_topics, gdy LOCAL_CREATOR_DATA jest wymagane w przypadku encji z CREATOR_TOPIC_INSIGHTS.
brand_sentiment_insights[] BrandSentimentInsight Miesięczne nastawienie do marki (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); wypełniane dla search_topics, gdy żądany jest BRAND_SENTIMENT_DATA w przypadku podmiotu z możliwością BRAND.

W poniższym przykładzie wywołujemy GenerateTrendingInsights, używając searchTopics dla encji marki w Grafie wiedzy (/g/11example_brand, otagowanej jako CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS i BRAND), i prosimy o LOCAL_CREATOR_DATA i 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"
      }
    ]
  }
}

Udane wywołanie GenerateTrendingInsightsResponse zwraca wpisy TrendInsight w 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": []
    }
  ]
}

Narzędzie Google Issue Tracker

Użyj narzędzia Issue Tracker, aby zadać pytania zespołowi pomocy, zgłosić błędy lub przesłać prośby o dodanie funkcji. Google śledzi i priorytetyzuje Twoje zgłoszenia oraz publikuje aktualizacje bezpośrednio w narzędziu Issue Tracker. Więcej informacji znajdziesz w artykule Tworzenie zgłoszenia w narzędziu Google Issue Tracker.

Utwórz zgłoszenie, korzystając z jednego z tych szablonów narzędzia Issue Tracker:

Wypełnij wszystkie pola w szablonie, podając szczegółowe informacje, abyśmy mogli odtworzyć problem i nadać Twojej prośbie odpowiedni priorytet. Google może zamknąć niekompletne zgłoszenia i poprosić Cię o przesłanie nowego zgłoszenia z brakującymi informacjami.

Wstecz
Statystyki odbiorców
Dalej
Testy porównawcze w YouTube