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ź najpopularniejszych twórców w danym zestawie tematów, grup demograficznych, odbiorców lub atrybutów twórców.
  2. Statystyki marki twórcy: pobieraj statystyki dotyczące twórców powiązanych z konkretną marką.
  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 trendów: pobieraj statystyki dotyczące konkretnych trendów na podstawie określonych odbiorców lub tematów.

Wymagania

ContentCreatorInsightsService.GenerateCreatorInsights to prywatny komponent interfejsu Google Ads API oferowany na podstawie niewyłącznej, bezpłatnej licencji na dane. Podpisani partnerzy mogą używać standardowych bibliotek klienta Google Ads do eksplorowania 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.
  • Użyj interfejsu API, aby eksplorować 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 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 ContentCreatorInsightsService.GenerateCreatorInsights metody. Ta metoda ma limit 5 zapytań na sekundę i przyjmuje 3 rodzaje danych wejściowych w zależności od tego, czy chcesz wyszukiwać twórców, uzyskiwać statystyki marki twórcy czy statystyki twórcy. 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 ważne wydarzenia życiowe). 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ą AudienceInsightsService.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.

    Aby na przykład 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 Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji Grafu wiedzy dotyczące „pielęgnacji skóry” i „pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji Grafu wiedzy dotyczący „kosmetyków”.

    Pamiętaj, że jeśli w polu audience_attributes określisz encje 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 marki twórcy: podaj markę, aby wyszukać najpopularniejszych twórców. Interfejs API zwraca statystyki dotyczące pasujących kanałów.

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

Metoda generateCreatorInsights zwraca obiekt GenerateCreatorInsightsResponse. Ten obiekt zawiera listę obiektów YouTubeCreatorInsights. 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)

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 zainteresowania użytkowników

    zestawienie)

  • Najpopularniejsze filmy

  • Typ kanału

  • Języki powiązane z treściami kanału

  • Wynik trafności (tylko w przypadku wyszukiwania trendów tematycznych)

Aby wygenerować statystyki trendów, wyślij żądanie do ContentCreatorInsightsService.GenerateTrendingInsights metody. Ta metoda ma limit 5 zapytań na sekundę i przyjmuje 2 rodzaje 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ą AudienceInsightsService.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.

    Aby na przykład 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 Grafu wiedzy (np. /m/014trl w przypadku kosmetyków). Pierwsza grupa będzie zawierać atrybuty encji Grafu wiedzy dotyczące „pielęgnacji skóry” i „pielęgnacji włosów”, a druga grupa będzie zawierać atrybut encji Grafu wiedzy dotyczący „kosmetyków”.

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