Statystyki twórców YouTube

Odkrywaj i pobieraj statystyki o twórcach YouTube 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. Wyszukiwanie twórców: znajdź odpowiednich twórców na podstawie określonego zestawu tematów, danych demograficznych, grup odbiorców lub atrybutów twórców.
  2. Statystyki tematów twórców: pobieraj statystyki o odpowiednich twórcach, którzy tworzą treści na określone tematy.
  3. Statystyki 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 trendów: pobieraj statystyki o konkretnych trendach na podstawie określonych 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 i są oglądani w tym kraju) jest obsługiwane, gdy używasz odkrywania twórców na podstawie tematu lub statystyk 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 kwalifikować się do udziału w programie, partnerzy muszą spełniać te warunki:

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

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

Generowanie statystyk twórców

Aby wygenerować statystyki twórców, wyślij żądanie do metody GenerateCreatorInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). Przyjmuje różne typy danych wejściowych w zależności od tego, czy chcesz wyszukiwać twórców, wyszukiwać odpowiednich twórców według tematów czy uzyskiwać statystyki twórców. Musisz podać lokalizacje krajów, z których chcesz pobierać dane.

  1. Wyszukiwanie 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ń.

    W interfejsie Google Ads API w wersji 23 możesz określać złożone relacje między atrybutami odbiorców za pomocą pola audience_combinations. To pole umożliwia definiowanie grup odbiorców za pomocą logiki boolowskiej (AND/OR), co nie jest możliwe w przypadku pola audience_attributes.

    Pole audience_attributes nadaje się do kierowania reklam 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 w grafie wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji w grafie wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji w grafie wiedzy dotyczący „Kosmetyków”.

    Jeśli w polu audience_attributes określisz encje w grafie 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 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ć listę obsługiwanych możliwości encji, użyj metody ListAudienceInsightsAttributes.

    Uwaga: opcja search_brand została wycofana w wersji 24.2 i jest całkowicie usunięta w wersji 25. Użytkownicy powinni przejść na używanie opcji search_topics.

  3. Statystyki 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ą w grafie 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 w grafie 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][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 dopasowania (tylko w przypadku wyszukiwania trendów tematycznych)

Aby wygenerować statystyki trendów, wyślij żądanie do metody GenerateTrendingInsights. Ta metoda ma limit 5 zapytań na sekundę (QPS). Przyjmuje 2 typy danych wejściowych w zależności od tego, czy chcesz uzyskać trendy dotyczące odbiorców czy trendy tematyczne. 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 trendów 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ą ListAudienceInsightsAttributes, podając wymiary, dla których chcesz uzyskać atrybuty, np. KNOWLEDGE_GRAPH w przypadku tematów zainteresowań.

    KNOWLEDGE_GRAPH atrybuty będą mieć co najmniej 1 InsightsKnowledgeGraphEntityCapabilities tagów. Atrybuty obsługiwane w przypadku statystyk 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.

    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 podobne zainteresowania, odbiorcy na rynku i zdarzenia z życia). Interfejs API zwraca listę statystyk trendów 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ń.

    W interfejsie Google Ads API w wersji 23 możesz określać złożone relacje między atrybutami odbiorców za pomocą pola audience_combinations. To pole umożliwia definiowanie grup odbiorców za pomocą logiki boolowskiej (AND/OR), co nie jest możliwe w przypadku pola audience_attributes.

    Pole audience_attributes nadaje się do kierowania reklam 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 w grafie wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji w grafie wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji w grafie wiedzy dotyczący „Kosmetyków”.

    Jeśli w polu audience_attributes określisz encje w grafie 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

  3. Trendy tematyczne: podaj listę tematów treści. Interfejs API zwraca listę statystyk trendów 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órców, możesz poprosić o opcjonalne funkcje w statystykach 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).

Wstecz
Statystyki odbiorców