Statystyki twórców YouTube

Odkrywaj twórców YouTube i pobieraj informacje o nich za pomocą funkcji statystyk twórców. 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. 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 o odpowiednich twórcach, którzy tworzą treści na określone tematy.
  3. Statystyki dotyczące twórców: pobieraj statystyki o konkretnych kanałach YouTube, takie jak liczba subskrybentów, liczba wyświetleń i dane demograficzne odbiorców.
  4. Statystyki dotyczące trendów: pobieraj 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 i są oglądani w tym kraju) jest obsługiwane, gdy używasz odkrywania twórców na podstawie tematu lub statystyk dotyczących trendów, prosząc o dodatkowe dane.

Wymagania

GenerateCreatorInsights to prywatny komponent interfejsu Google Ads API udostępniany na podstawie niewyłącznej, bezpłatnej licencji na dane. Podpisani partnerzy mogą używać standardowych bibliotek klienta Google Ads do wyszukiwania twórców i treści w YouTube. Aby się kwalifikować, partnerzy muszą spełniać te warunki:

  • Muszą mieć narzędzie do planowania lub interfejs użytkownika, który będzie zintegrowany z interfejsem Google Ads API.
  • Muszą używać interfejsu API do wyszukiwania treści i twórców w YouTube pod kątem potencjalnych możliwości reklamowych.
  • Zweryfikuj wstępną ocenę, aby potwierdzić, że spełniasz wymagania.
  • Muszą przestrzegać wymagań dotyczących użycia danych i być gotowi na okresowe audyty danych.
  • Muszą podpisać umowę licencyjną na dane, która prawnie egzekwuje wymagania dotyczące użycia danych.
  • Muszą zaakceptować warunki korzystania z interfejsu Google Ads API.

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

Generowanie statystyk dotyczących 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). W zależności od tego, czy chcesz odkrywać twórców, wyszukiwać odpowiednich twórców według tematów czy uzyskiwać statystyki dotyczące twórców, metoda ta przyjmuje różne typy danych wejściowych. Musisz podać lokalizacje krajów, z których chcesz pobierać dane.

  1. Odkrywanie twórców: możesz podać listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania użytkowników (w tym podobne zainteresowania, 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órców, aby filtrować twórców, których treści pasują do wprowadzonych atrybutów.

    Dostępne atrybuty odbiorców możesz pobrać za pomocą 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 odbiorców za pomocą pola audience_combinations. To pole umożliwia definiowanie odbiorców za pomocą logiki boolowskiej (ORAZ/LUB), co nie jest możliwe w przypadku pola audience_attributes.

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

    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 w polu audience_combinations. „Pielęgnacja skóry”, „Pielęgnacja włosów” i „Kosmetyki” to tematy zainteresowań reprezentowane przez encje z Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji z Grafu wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji z Grafu wiedzy dotyczący „Kosmetyków”.

    Jeśli w polu audience_attributes określisz encje z Grafu wiedzy, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz używać pola audience_combinations. Jeśli używasz pola audience_combinations, musisz określić te atrybuty w tym polu, a nie w polu audience_attributes. Możesz jednak nadal używać pola audience_attributes w przypadku innych typów atrybutów, takich jak dane demograficzne, w połączeniu z polem audience_combinations.audience_combinations

  2. Statystyki dotyczące tematów twórców: podaj listę tematów treści za pomocą pola search_topics. Interfejs API zwraca odpowiednich twórców, którzy tworzą treści na określone tematy. Pobrane dane są oparte na kraju określonym w country_locations. Pamiętaj, że ta opcja umożliwia wyszukiwanie tylko w jednym kraju.

    Obsługiwane encje w polu SearchTopics muszą być oznaczone możliwością CONTENT_TRENDING_INSIGHTS lub CREATOR_TOPIC_INSIGHTS. Aby pobrać obsługiwane możliwości encji, użyj ListAudienceInsightsAttributes metody.

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

  3. Statystyki dotyczące twórców: podaj listę identyfikatorów kanałów YouTube za pomocą pola 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 statystyczne. Możesz poprosić o opcjonalne funkcje i dodatkowe dane w odpowiedzi, ustawiając powtarzające się 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ą pola search_topics (a temat jest encją z Grafu wiedzy oznaczoną możliwością 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 i są oglądani w tym kraju.
  • Ograniczenie: odkrywanie lokalnych twórców nie jest obsługiwane, gdy w żądaniu ustawione jest pole 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 Twoich podstawowych kryteriów.
  • local_creator_insights: lista obiektów YouTubeCreatorInsights dotyczących lokalnych twórców. To pole jest wypełniane tylko wtedy, gdy zażądano wartości LOCAL_CREATOR_DATA i użyto kryterium 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 YouTube

Obiekt YouTubeMetrics zawiera te dane:

  • Liczba subskrybentów
  • Liczba wyświetleń
  • Liczba filmów
  • Czy 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 oznaczonych marką, sprawdź pole partnership_opportunities. Twórca kwalifikuje się, jeśli lista zawiera wartość CREATOR_PARTNERSHIPS.

Obiekt YouTubeChannelInsights zawiera te informacje o kanale YouTube:

  • Nazwa kanału
  • Identyfikator kanału
  • Adres URL kanału
  • Opis kanału
  • Dane kanału
  • Atrybuty odbiorców kanału (takie jak wiek, płeć i zestawienie zainteresowań użytkowników)
  • Najpopularniejsze filmy
  • Typ kanału
  • Języki powiązane z treściami kanału
  • Wynik trafności (tylko w przypadku wyszukiwania trendów dotyczących tematów)
  • Czy twórca wyraził zgodę na udostępnianie niepublicznych danych

Aby wygenerować statystyki dotyczące trendów, wyślij żądanie do metody GenerateTrendingInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). W zależności od tego, czy chcesz uzyskać trendy dotyczące odbiorców czy trendy dotyczące tematów, metoda ta przyjmuje 2 typy danych wejściowych. Musisz podać konkretną lokalizację kraju, z której chcesz pobierać 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 podobne zainteresowania, odbiorcy na rynku i zdarzenia z życia). 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.

    Dostępne atrybuty odbiorców możesz pobrać za pomocą 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 odbiorców za pomocą pola audience_combinations. To pole umożliwia definiowanie odbiorców za pomocą logiki boolowskiej (ORAZ/LUB), co nie jest możliwe w przypadku pola audience_attributes.

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

    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 w polu audience_combinations. „Pielęgnacja skóry”, „Pielęgnacja włosów” i „Kosmetyki” to tematy zainteresowań reprezentowane przez encje z Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji z Grafu wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji z Grafu wiedzy dotyczący „Kosmetyków”.

    Jeśli w polu audience_attributes określisz encje z Grafu wiedzy, kategorie produktów i usług lub zainteresowania użytkowników, nie możesz używać pola audience_combinations. Jeśli używasz pola audience_combinations, musisz określić te atrybuty w tym polu, a nie w polu audience_attributes. Możesz jednak nadal używać pola audience_attributes w przypadku innych typów atrybutów, takich jak dane demograficzne, w połączeniu z polem audience_combinations.audience_combinations

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

    Pamiętaj, że deweloperzy, którzy mają dostęp do ContentCreatorInsightsService , będą też automatycznie mieć dostęp do AudienceInsightsService.ListAudienceInsightsAttributes. Inne punkty końcowe w usłudze AudienceInsightsService wymagają niezależnego procesu dodawania do listy dozwolonych.

    Dodatkowe informacje o usłudze ListAudienceInsightsAttributes znajdziesz w przewodniku po statystykach odbiorców.

  2. Trendy dotyczące tematów: podaj listę tematów treści. Interfejs API zwraca listę statystyk dotyczących trendów dla tych tematów, w tym dane takie jak procentowa zmiana wartości trendu w okresie porównawczym.

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

Jeśli w żądaniu dotyczącym trendów używasz pola search_topics, interfejs API wypełni pole related_local_creators w zwracanych obiektach TrendInsight powiązanymi lokalnymi twórcami, którzy wyrazili zgodę na udostępnianie danych o lokalizacji. Odkrywanie lokalnych twórców podlega tej samej definicji i ograniczeniom (np. jest niezgodne z polem sub_country_locations).

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

  • trend_attribute: główny AudienceInsightsAttributeMetadata dla trendu.
  • trend_metrics: dane dotyczące trendu, takie jak procentowa zmiana w okresie porównawczym.
  • trend_data_points: historyczne punkty danych dla trendu. To pole jest wypełniane tylko w przypadku trendów, w których używane jest pole search_topics.
  • related_videos: lista obiektów AudienceInsightsAttributeMetadata dotyczących popularnych filmów powiązanych z tematem trendu. To pole jest wypełniane tylko w przypadku trendów, w których używane jest pole search_topics. W przypadku tych atrybutów wypełniane jest zagnieżdżone YouTubeVideoAttributeMetadatapole , które zawiera metadane na poziomie filmu (takie jak adres URL filmu, adres URL miniatury oraz liczba wyświetleń i polubień) oraz metadane na poziomie kanału (takie jak identyfikator kanału, nazwa i adres URL kanału).
Wstecz
Statystyki odbiorców