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 swoich docelowych odbiorców.

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: pobieraj statystyki dotyczące konkretnych kanałów w YouTube, takie jak liczba subskrybentów, liczba wyświetleń i dane demograficzne odbiorców.
  4. Trendy: uzyskuj informacje o określonych trendach na podstawie konkretnych grup 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ą w tym kraju oglądane) jest obsługiwane w przypadku odkrywania twórców na podstawie tematów lub popularnych statystyk, gdy poprosisz 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 kwalifikować się do udziału w programie, partnerzy muszą spełniać te warunki:

  • Musisz mieć narzędzie do planowania lub interfejs użytkownika, który będzie integrować interfejs Google Ads API.
  • Używaj interfejsu API, aby przeglądać treści i twórców w YouTube pod kątem potencjalnych możliwości reklamowych.
  • Aby zweryfikować, czy spełniasz wymagania, przeprowadź wstępną ocenę.
  • 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 użycia 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 typy danych wejściowych. Musisz podać kraje, z których chcesz pobierać dane.

  1. Wykrywalność 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.

    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 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, które są reprezentowane przez elementy z Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa zawierałaby atrybuty encji grafu wiedzy dla „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa – atrybut encji grafu wiedzy dla „Kosmetyków”.

    Pamiętaj, że jeśli w polu audience_attributes określisz jednostki z Grafu wiedzy, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz użyć pola 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 dotyczące tematu twórcy: podaj listę tematów treści w polu search_topics. Interfejs API zwraca odpowiednich twórców, którzy publikują treści na określone tematy. Pobrane dane zależą od kraju określonego w 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 elementu.

    Uwaga: opcja search_brand została wycofana w wersji 24.2 i zostanie całkowicie usunięta w wersji 25. Użytkownicy powinni zacząć korzystać z search_topics.

  3. Statystyki twórców: podaj listę identyfikatorów kanałów w YouTube w polu search_channels. Interfejs API zwraca statystyki dotyczące tych konkretnych kanałów.

Dodatkowe dane 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 lokalnego twórcy, dodając wartość wyliczeniową LOCAL_CREATOR_DATA do pola supplemental_data. Jeśli szukasz twórców za pomocą search_topics (a temat jest encją Grafu wiedzy oznaczoną 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 swojej 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ść sub_country_locations.
  • Możliwości: możesz pobrać listę obsługiwanych elementów Grafu wiedzy i ich możliwości za pomocą metody ListAudienceInsightsAttributes.

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

  • creator_insights: lista obiektów YouTubeCreatorInsights spełniających Twoje podstawowe kryteria.
  • 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 kanału
  • Atrybuty odbiorców kanału (np. wiek, płeć i zainteresowania 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)

Aby wygenerować statystyki dotyczące trendów, 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, funkcja ta 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.

    Atrybuty KNOWLEDGE_GRAPH będą miały co najmniej 1 tag InsightsKnowledgeGraphEntityCapabilities. Atrybuty obsługiwane w przypadku statystyk o trendach 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 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 odbiorcy związani ze zdarzeniami 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 zainteresowań.

    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.

    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 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, które są reprezentowane przez elementy z Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa zawierałaby atrybuty encji grafu wiedzy dla „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa – atrybut encji grafu wiedzy dla „Kosmetyków”.

    Pamiętaj, że jeśli w polu audience_attributes określisz jednostki z Grafu wiedzy, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz użyć pola 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.

  3. 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.

Podobnie jak w przypadku generowania statystyk twórcy możesz poprosić o funkcje opcjonalne w statystykach trendów, ustawiając powtarzające się pole supplemental_data na LOCAL_CREATOR_DATA.

Jeśli w żądaniu dotyczącym trendów używasz search_topics, w polu related_local_creators zwróconych obiektów TrendInsight zostaną umieszczone informacje o lokalnych twórcach, którzy są związani z danym tematem i wyrazili zgodę na udostępnianie danych o lokalizacji. Wyszukiwanie lokalnych twórców podlega tej samej definicji i ograniczeniom (np. jest niezgodne z sub_country_locations).

Wstecz
Statystyki odbiorców