Statystyki twórców YouTube

Odkrywaj twórców YouTube i uzyskuj o nich statystyki dzięki funkcji statystyk o twórcach. Może to być przydatne dla agencji i reklamodawców, którzy chcą znaleźć twórców odpowiednich dla ich grupy docelowej.

Interfejs API ma 4 główne funkcje:

  1. Wyszukiwanie twórców: znajdź odpowiednich twórców na podstawie określonych 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: pobieranie statystyk dotyczących konkretnych kanałów w YouTube, takich jak liczba subskrybentów, liczba wyświetleń i dane demograficzne odbiorców.
  4. Trendy: uzyskuj statystyki dotyczące konkretnych trendów na podstawie określonych odbiorców lub tematów.

Odkrywanie lokalnych twórców (znajdowanie twórców, którzy mieszkają w danym kraju lub publikują z niego treści, a ich filmy są oglądane w tym kraju) jest obsługiwane w przypadku odkrywania twórców na podstawie tematów lub trendów przez wysyłanie prośby o dane dodatkowe. Możesz też poprosić o statystyki dotyczące opinii o marce w przypadku statystyk trendów opartych na tematach, przesyłając prośbę o dane dodatkowe.

Wymagania

GenerateCreatorInsights to prywatny komponent interfejsu Google Ads API oferowany na podstawie niewyłącznej, bezpłatnej licencji na dane. Podpisani partnerzy mogą korzystać ze standardowych bibliotek klienta Google Ads, aby wyszukiwać twórców i treści w YouTube. Aby się kwalifikować, partnerzy muszą spełniać te warunki:

  • mieć narzędzie do planowania lub interfejs użytkownika, który będzie integrować interfejs Google Ads API;
  • Używaj interfejsu API do odkrywania treści i twórców w YouTube, aby znaleźć potencjalne możliwości reklamowe.
  • Aby sprawdzić, czy spełniasz wymagania, wypełnij wstępną ankietę.
  • Przestrzegaj wymagań dotyczących wykorzystania danych i zgódź się na okresowe audyty danych.
  • Podpisz umowę licencyjną na dane, która prawnie egzekwuje wymagania dotyczące korzystania z danych.
  • Zaakceptuj warunki korzystania z interfejsu Google Ads API.

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

Generowanie statystyk twórców

Aby wygenerować statystyki twórcy, wyślij żądanie do metody GenerateCreatorInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). W zależności od tego, czy chcesz zwiększyć widoczność twórcy, wyszukać odpowiednich twórców według tematów czy uzyskać statystyki dotyczące twórców, musisz podać różne rodzaje danych wejściowych. Musisz podać kraje, z których chcesz pobrać dane.

  1. Widoczność twórcy: możesz podać listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania użytkowników (w tym odbiorcy o podobnych zainteresowaniach, odbiorcy na rynku i zdarzenia z życia). Interfejs API zwraca listę twórców, których odbiorcy pasują do tych atrybutów. Możesz też podać atrybuty twórcy, aby filtrować twórców, których treści są zgodne z podanymi przez Ciebie atrybutami.

    Dostępne atrybuty odbiorców możesz pobrać za pomocą metody ListAudienceInsightsAttributes, podając wymiary, dla których chcesz uzyskać atrybuty, np. KNOWLEDGE_GRAPH w przypadku tematów, które interesują odbiorców.

    Od wersji 23 interfejsu Google Ads API możesz określać złożone relacje między atrybutami listy odbiorców za pomocą audience_combinations. To pole umożliwia określanie odbiorców za pomocą wartości logicznych (ORAZ/LUB), co nie jest możliwe w przypadku kolumny audience_attributes.

    Atrybut audience_attributes nadaje się do kierowania na podstawie listy atrybutów połączonych za pomocą operatora OR (np. użytkownicy zainteresowani „sportem” LUB „podróżami” LUB …), a atrybut audience_combinations zapewnia bardziej szczegółową kontrolę. Każdy element InsightsAudienceAttributeGroup w audience_combinations łączy atrybuty za pomocą operatora logicznego LUB. Te grupy są następnie łączone za pomocą operatora logicznego ORAZ.

    Jeśli na przykład chcesz kierować reklamy na odbiorców zainteresowanych (pielęgnacją skóry LUB pielęgnacją włosów) ORAZ kosmetykami, użyj 2 elementów InsightsAudienceAttributeGroup we właściwości audience_combinations. „Pielęgnacja skóry”, „Pielęgnacja włosów” i „Kosmetyki” to tematy zainteresowań reprezentowane przez jednostki z grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa zawierałaby atrybuty encji z grafu wiedzy dotyczące „pielęgnacji skóry” i „pielęgnacji włosów”, a druga grupa zawierałaby atrybut encji z grafu wiedzy dotyczący „kosmetyków”.

    Pamiętaj, że jeśli w audience_attributes określisz jednostki z bazy Knowledge Graph, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz używać audience_combinations. Jeśli używasz audience_combinations, musisz określić te atrybuty w audience_combinations, a nie w audience_attributes. Możesz jednak nadal używać audience_attributes w przypadku innych typów atrybutów, takich jak dane demograficzne, w połączeniu z audience_combinations.

  2. Statystyki tematów twórców: podaj listę tematów treści w polu search_topics. Interfejs API zwraca odpowiednich twórców, którzy tworzą treści na określone tematy. Pobrane dane zależą od kraju określonego w parametrze country_locations. Pamiętaj, że ta opcja umożliwia wyszukiwanie tylko w jednym kraju.

    Obsługiwane elementy w polu SearchTopics muszą być oznaczone możliwością CONTENT_TRENDING_INSIGHTS lub CREATOR_TOPIC_INSIGHTS. Użyj metody ListAudienceInsightsAttributes do pobierania obsługiwanych funkcji jednostki.

    Uwaga: opcja search_brand została wycofana w wersji 24.2 i usunięta w wersji 25. Zamiast niej używaj search_topics.

  3. Statystyki twórcy: podaj listę identyfikatorów kanałów w YouTube, nicków używanych na kanale w YouTube (od wersji 25.2) lub kombinację obu tych elementów w polu search_channels. Interfejs API zwraca statystyki dotyczące tych konkretnych kanałów.

Dane dodatkowe i lokalni twórcy

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

Możesz na przykład poprosić o dane lokalnych twórców, dodając wartość wyliczeniową LOCAL_CREATOR_DATA do pola supplemental_data. Jeśli wyszukujesz twórców za pomocą search_topics (a temat jest elementem Grafu wiedzy oznaczonym tagiem CREATOR_TOPIC_INSIGHTS), interfejs API wypełni pole local_creator_insights w odpowiedzi lokalnymi twórcami, którzy wyrazili zgodę na udostępnianie danych o lokalizacji.

Pamiętaj o tych specyfikacjach dotyczących odkrywania lokalnych twórców:

  • Definicja: „lokalni twórcy” to twórcy, którzy mieszkają w wybranym kraju lub publikują z niego treści, a ich filmy są oglądane w tym kraju.
  • Ograniczenie: wykrywanie lokalnych twórców nie jest obsługiwane, gdy w żądaniu ustawiona jest wartość parametru sub_country_locations.
  • Możliwości: listę obsługiwanych encji z Grafu wiedzy i ich możliwości możesz pobrać za pomocą metody ListAudienceInsightsAttributes.

Metoda generateCreatorInsights zwraca obiekt GenerateCreatorInsightsResponse. Ten obiekt zawiera te pola:

  • creator_insights: lista obiektów YouTubeCreatorInsights pasujących do podstawowych kryteriów.
  • local_creator_insights: Lista obiektów YouTubeCreatorInsights dla lokalnych twórców. To pole jest wypełniane tylko wtedy, gdy zażądano parametru LOCAL_CREATOR_DATA, a użyte kryteria to search_topics.

Każdy obiekt YouTubeCreatorInsights zawiera te informacje o twórcy:

  • Nazwa twórcy
  • Kanał w YouTube
  • Łączne dane twórcy
  • Lista statystyk kanału w YouTube

Obiekt YouTubeMetrics zawiera te dane:

  • Liczba subskrybentów
  • Liczba wyświetleń
  • Liczba filmów
  • jest aktywnym twórcą filmów Short;
  • Możliwości współpracy (od wersji 23)

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

Obiekt YouTubeChannelInsights zawiera te informacje o kanale w YouTube:

  • Nazwa kanału
  • Identyfikator kanału
  • Adres URL kanału
  • Opis kanału
  • Dane dotyczące kanału
  • Atrybuty odbiorców kanału (np. podział według wieku, płci i zainteresowań użytkowników)
  • Najpopularniejsze filmy
  • Typ kanału
  • Języki powiązane z treściami na kanale
  • Ocena trafności (tylko w przypadku wyszukiwań trendów tematycznych)
  • Czy twórca wyraził zgodę na udostępnianie niepublicznych danych.

Aby wygenerować popularne statystyki, wyślij żądanie do metody GenerateTrendingInsights. Ta metoda ma limit 5 zapytań na sekundę. W zależności od tego, czy chcesz poznać trendy dotyczące odbiorców czy tematów, narzędzie przyjmuje 2 rodzaje danych wejściowych. Musisz podać konkretny kraj, z którego chcesz uzyskać trendy.

  1. Trendy dotyczące odbiorców: możesz podać listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania użytkowników (w tym odbiorcy o podobnych zainteresowaniach, odbiorcy na rynku i zdarzenia z życia). Interfejs API zwraca listę popularnych statystyk dotyczących tych odbiorców, w tym dane takie jak procentowa zmiana wartości trendu w okresie porównawczym.

    Dostępne atrybuty odbiorców możesz pobrać za pomocą metody ListAudienceInsightsAttributes, podając wymiary, dla których chcesz uzyskać atrybuty, np. KNOWLEDGE_GRAPH w przypadku tematów, które interesują odbiorców.

    Od wersji 23 interfejsu Google Ads API możesz określać złożone relacje między atrybutami listy odbiorców za pomocą audience_combinations. To pole umożliwia określanie odbiorców za pomocą wartości logicznych (ORAZ/LUB), co nie jest możliwe w przypadku kolumny audience_attributes.

    Atrybut audience_attributes nadaje się do kierowania na podstawie listy atrybutów połączonych za pomocą operatora OR (np. użytkownicy zainteresowani „sportem” LUB „podróżami” LUB …), a atrybut audience_combinations zapewnia bardziej szczegółową kontrolę. Każdy element InsightsAudienceAttributeGroup w audience_combinations łączy atrybuty za pomocą operatora logicznego LUB. Te grupy są następnie łączone za pomocą operatora logicznego ORAZ.

    Jeśli na przykład chcesz kierować reklamy na odbiorców zainteresowanych (pielęgnacją skóry LUB pielęgnacją włosów) ORAZ kosmetykami, użyj 2 elementów InsightsAudienceAttributeGroup we właściwości audience_combinations. „Pielęgnacja skóry”, „Pielęgnacja włosów” i „Kosmetyki” to tematy zainteresowań reprezentowane przez jednostki z grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa zawierałaby atrybuty encji z grafu wiedzy dotyczące „pielęgnacji skóry” i „pielęgnacji włosów”, a druga grupa zawierałaby atrybut encji z grafu wiedzy dotyczący „kosmetyków”.

    Pamiętaj, że jeśli w audience_attributes określisz jednostki z bazy Knowledge Graph, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz używać audience_combinations. Jeśli używasz audience_combinations, musisz określić te atrybuty w audience_combinations, a nie w audience_attributes. Możesz jednak nadal używać audience_attributes w przypadku innych typów atrybutów, takich jak dane demograficzne, w połączeniu z audience_combinations.

    Atrybuty KNOWLEDGE_GRAPH będą miały co najmniej 1 tag InsightsKnowledgeGraphEntityCapabilities. Atrybuty obsługiwane w przypadku statystyk dotyczących trendów będą miały w metadanych odpowiedzi odpowiednie tagi.

    Pamiętaj, że deweloperzy z dostępem do ContentCreatorInsightsService będą też mieć automatyczny dostęp do AudienceInsightsService.ListAudienceInsightsAttributes. Inne punkty końcowe w AudienceInsightsService wymagają niezależnego procesu dodawania do listy dozwolonych.

    Dodatkową dokumentację dotyczącą ListAudienceInsightsAttributes znajdziesz w przewodniku po statystykach odbiorców.

  2. Trendy dotyczące tematów: podaj listę tematów treści. Interfejs API zwraca listę popularnych statystyk dotyczących tych tematów, w tym dane takie jak procentowa zmiana wartości trendu w okresie porównawczym. Możesz też poprosić o dodatkowe dane, aby uzyskać statystyki dotyczące opinii o marce w przypadku tematów związanych z marką.

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

Jeśli w zapytaniu o trendy używasz parametru search_topics, ustawienie parametru supplemental_data na wartość LOCAL_CREATOR_DATA spowoduje wypełnienie pola related_local_creators w zwróconych obiektach TrendInsight powiązanymi lokalnymi twórcami, którzy wyrazili zgodę na udostępnianie danych o swojej lokalizacji. Wyszukiwanie lokalnych twórców podlega tej samej definicji i ograniczeniom (np. jest niezgodne z sub_country_locations).

Jeśli żądanie dotyczące trendów używa parametru search_topics, ustawienie parametru supplemental_data na wartość BRAND_SENTIMENT_DATA spowoduje wypełnienie pola brand_sentiment_insights w zwracanych obiektach TrendInsight, gdy temat żądanej encji z Grafu wiedzy ma funkcję BRAND. Temat dotyczący marki to podmiot oznaczony funkcją BRAND. Obsługiwane funkcje jednostki możesz pobrać za pomocą metody ListAudienceInsightsAttributes.

Pomiar nastawienia do marki obejmuje wykorzystanie modeli AI (opartych na Gemini) do analizowania treści filmów w YouTube związanych z marką i kategoryzowania nastawienia jako pozytywne, negatywne lub neutralne. Analizowana jest tylko treść filmu, 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. procentowa zmiana w okresie porównawczym.
  • trend_data_points: historyczne punkty danych dotyczące trendu. Wartość jest podawana tylko w przypadku trendów korzystających z search_topics.
  • related_videos: lista obiektów AudienceInsightsAttributeMetadata dla filmów na czasie powiązanych z tematem trendu. Wartość podawana tylko w przypadku trendów korzystających z search_topics. W przypadku tych atrybutów wypełniane jest pole zagnieżdżone YouTubeVideoAttributeMetadata, które zawiera metadane na poziomie filmu (takie jak adres URL filmu, adres URL miniatury oraz liczba wyświetleń lub polubień) i metadane na poziomie kanału (takie jak identyfikator kanału, nazwa i adres URL kanału).
  • brand_sentiment_insights: lista obiektów BrandSentimentInsight dla trendu. Wypełniane tylko wtedy, gdy żądanie trendu używa parametru search_topics, temat jednostki z grafu wiedzy ma funkcję BRAND, a w parametrze supplemental_data żądany jest parametr BRAND_SENTIMENT_DATA. Każdy obiekt BrandSentimentInsight zawiera:
    • month: miesiąc, którego dotyczy sentyment marki, w formacie YYYY-MM.
    • has_insufficient_data: czy jest za mało danych, aby obliczyć nastawienie do marki.
    • sentiment_distributions: Rozkład nastawienia na pozytywne, negatywne i neutralne, obliczany jako odsetek wyświetleń filmów, które odpowiadają marce z danym nastawieniem.
    • sentiment_summaries: wygenerowane przez AI podsumowania pozytywnych i negatywnych opinii o treściach związanych z marką oraz przykładowe filmy dla każdego rodzaju opinii. Podsumowania są generowane tylko w przypadku pozytywnego i negatywnego nastawienia, a nie neutralnego.
Wstecz
Statystyki odbiorców
Dalej
Testy porównawcze w YouTube