Statystyki twórców YouTube

Odkrywaj twórców YouTube i pobieraj statystyki na ich temat 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, 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 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ą w nim oglądani) jest obsługiwane w przypadku odkrywania twórców na podstawie tematu lub statystyk dotyczących trendów, gdy poprosisz o dodatkowe dane. Możesz też poprosić o statystyki dotyczące nastawienia do marki w przypadku statystyk dotyczących trendów na podstawie tematu, gdy poprosisz 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żywania danych i wyrazić zgodę na okresowe audyty danych.
  • Muszą podpisać umowę licencyjną na dane, która prawnie egzekwuje wymagania dotyczące używania danych.
  • Muszą zaakceptować 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ó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 wyszukiwać twórców, wyszukiwać odpowiednich twórców według tematów czy uzyskiwać statystyki twórców, przyjmuje ona różne typy danych wejściowych. 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 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 reklam na podstawie listy atrybutów połączonych operatorem OR (np. użytkownicy zainteresowani „sportem” LUB „podróżami” LUB…), ale 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 jednostki Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty jednostek Grafu wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut jednostki Grafu wiedzy dotyczący „Kosmetyków”.

    Pamiętaj, że jeśli w polu audience_attributes określisz jednostki 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 jednostki w polu SearchTopics muszą być oznaczone możliwością CONTENT_TRENDING_INSIGHTS lub CREATOR_TOPIC_INSIGHTS. Aby pobrać obsługiwane możliwości jednostek, użyj metody ListAudienceInsightsAttributes.

    Uwaga: opcja search_brand została wycofana w wersji 24.2 i usunięta w wersji 25. Zamiast niej użyj 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 jednostką 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ą w nim oglądani.
  • 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 jednostek 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, przyjmuje ona 2 typy danych wejściowych. Musisz podać konkretną lokalizację kraju, z którego 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ń.

    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 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 reklam na podstawie listy atrybutów połączonych operatorem OR (np. użytkownicy zainteresowani „sportem” LUB „podróżami” LUB…), ale 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 jednostki Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty jednostek Grafu wiedzy dotyczące „Pielęgnacji skóry” i „Pielęgnacji włosów”, a druga grupa będzie zawierać atrybut jednostki Grafu wiedzy dotyczący „Kosmetyków”.

    Pamiętaj, że jeśli w polu audience_attributes określisz jednostki 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.

    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ę statystyk dotyczących trendów dla tych tematów, w tym dane takie jak procentowa zmiana wartości trendu w okresie porównawczym. Możesz też poprosić o statystyki dotyczące nastawienia do marki w przypadku tematów związanych z marką, gdy poprosisz o dodatkowe dane.

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

Jeśli żądanie dotyczące trendów używa pola search_topics, ustawienie pola supplemental_data na wartość LOCAL_CREATOR_DATA spowoduje wypełnienie pola 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).

Jeśli żądanie dotyczące trendów używa pola search_topics, ustawienie pola supplemental_data na BRAND_SENTIMENT_DATA spowoduje wypełnienie pola brand_sentiment_insights w zwracanych obiektach TrendInsight, gdy żądany temat jednostki Grafu wiedzy ma możliwość BRAND. Temat marki to jednostka oznaczona możliwością BRAND. Obsługiwane możliwości jednostek możesz pobrać za pomocą metody ListAudienceInsightsAttributes.

Pomiar nastawienia do marki polega na użyciu modeli AI (opartych na Gemini) do analizowania treści filmów na YouTube związanych z marką i klasyfikowania nastawienia jako pozytywne, negatywne lub neutralne. Analizowane są tylko treści filmów. Komentarze użytkowników nie są uwzględniane.

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. Pole jest wypełniane tylko w przypadku trendów używających pola search_topics.
  • related_videos: lista obiektów AudienceInsightsAttributeMetadata dotyczących popularnych filmów powiązanych z tematem trendu. Pole jest wypełniane tylko w przypadku trendów używających pola 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ń lub polubień) i metadane na poziomie kanału (takie jak identyfikator kanału, nazwa i adres URL).
  • brand_sentiment_insights: lista obiektów BrandSentimentInsight dotyczących trendu. Pole jest wypełniane tylko wtedy, gdy żądanie dotyczące trendu używa pola search_topics, temat jednostki Grafu wiedzy ma możliwość BRAND capability, a BRAND_SENTIMENT_DATA zażądano w polu supplemental_data. Każdy obiekt BrandSentimentInsight zawiera:
    • month: miesiąc, który reprezentuje nastawienie do marki, w formacie YYYY-MM.
    • has_insufficient_data: czy dane są niewystarczające do obliczenia nastawienia do marki.
    • sentiment_distributions: rozkład nastawienia na pozytywne, negatywne i neutralne, obliczony jako proporcja wyświetleń filmów, które odpowiadają marce z każdym nastawieniem.
    • sentiment_summaries: podsumowania wygenerowane przez AI dotyczące pozytywnych i negatywnych aspektów treści związanych z marką, a także przykładowe filmy dla każdego nastawienia. Podsumowania są generowane tylko w przypadku nastawienia pozytywnego i negatywnego, a nie neutralnego.
Wstecz
Statystyki odbiorców