Statystyki odbiorców

Wszystkie żądania wysyłane do AudienceInsightsService są objęte ograniczeniem liczby żądań. W przypadku metod generateAudienceCompositionInsights i generateSuggestedTargetingInsights dozwolona jest mniejsza liczba żądań dziennie niż w przypadku innych metod statystyk odbiorców. Więcej informacji znajdziesz w artykule o limitach interfejsu API.

AudienceInsightsService umożliwia integrację danych ze statystyk odbiorców Google z narzędziami do planowania. Dane te pomagają agencjom multimedialnym i osobom planującym kampanie medialne lepiej poznać docelowych odbiorców, w tym ich dane demograficzne, zainteresowania i zachowania online.

Statystyki odbiorców pomagają poznać grupę odbiorców, kategorię, temat lub markę dzięki ogólnemu przeglądowi informacji na ich temat. Analizując zachowania użytkowników zainteresowanych powiązanymi artykułami, możesz wykorzystać te statystyki odbiorców, aby poznać powiązania i odczucia, jakie mają klienci, oraz zidentyfikować nowe segmenty odbiorców.

Interfejs API obsługuje 3 główne przypadki użycia:

  • Uściślanie i odkrywanie odbiorców: poznaj unikalne zainteresowania i zachowania konsumentów, aby identyfikować nowych odbiorców marki, tworzyć profile odbiorców i ulepszać strategie segmentacji odbiorców.
  • Ułatwianie planowania kampanii: przekształcaj dane wyjściowe w docelowych odbiorców w YouTube, aby planować kampanie, szacować potencjalny zasięg docelowych odbiorców i mierzyć nakładanie się segmentów odbiorców w celu maksymalizacji zasięgu kampanii.
  • Tworzenie przekazu reklamowego: dostosuj przekaz reklamowy do docelowych odbiorców na podstawie tematów i zainteresowań, które najbardziej ich angażują.

Wymagania

Aby kwalifikować się do AudienceInsightsService, partnerzy muszą spełniać te warunki:

  • mieć dostęp do narzędzia Insights Finder lub kwalifikować się do korzystania z niego;
  • mieć narzędzie do planowania lub interfejs użytkownika, który integruje interfejs API;
  • Używaj interfejsu API do planowania mediów lub innych odpowiednich zastosowań.
  • Wypełnij wstępną ankietę.
  • przestrzegać wymagań dotyczących wykorzystania danych i poddawać się okresowym kontrolom danych;
  • Zaakceptuj warunki korzystania z usługi interfejsu Google Ads API i powiązane zasady korzystania z danych.

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

Wyświetl listę dat, dla których dostępne są statystyki

Typowy przepływ pracy rozpoczyna się od sprawdzenia, które miesiące kalendarzowe i okresy są dostępne do analizy. Metoda listInsightsEligibleDates zwraca obiekt ListInsightsEligibleDatesResponse, którego pole data_months zawiera listę miesięcy (w formacie YYYY-MM), dla których dostępne są dane statystyk odbiorców.

Pole last_thirty_days odpowiedzi zawiera dokładny zakres dat, którego generateAudienceCompositionInsights używa, gdy w żądaniu nie ustawiono data_month.

Wyświetlanie listy atrybutów statystyk odbiorców

Zanim wyślesz zapytanie o skład odbiorców lub dane o pokrywaniu się, znajdź prawidłowe identyfikatory atrybutów za pomocą metody listAudienceInsightsAttributes. Ta metoda zwraca obiekt ListAudienceInsightsAttributesResponse zawierający dostępne atrybuty dla żądanych wymiarów.

Jeśli na przykład w żądaniu jako wymiar wybrano AFFINITY_USER_INTEREST, metoda zwraca obsługiwane listy odbiorców o podobnych zainteresowaniach, takie jak „Fani sportu” czy „Miłośnicy muzyki”. Inne obsługiwane wymiary zainteresowań użytkowników to IN_MARKET_USER_INTEREST i LIFE_EVENT_USER_INTEREST. W jednym żądaniu możesz ustawić wiele wymiarów. Pełną listę obsługiwanych wymiarów znajdziesz w dokumentacji pól dimensions.

Podczas wyszukiwania encji (tematów) Grafu wiedzy za pomocą wymiaru KNOWLEDGE_GRAPH musisz podać ciąg zapytania w polu query_text (np. "football and the World Cup").

Możesz opcjonalnie dodać knowledge_graph_entity_search_options, aby dostosować wyszukiwanie tematów:

  • Filtrowanie według funkcji: użyj parametru search_filter, aby zawęzić pobrane encje tylko do tych, które obsługują określone funkcje. Możesz na przykład filtrować tematy obsługiwane jako atrybuty twórcy, podając CREATOR_ATTRIBUTE w polu entity_capability_filters. Można podać wiele funkcji, które są łączone za pomocą operatora logicznego OR.
  • Pobieranie wszystkich atrybutów twórcy: ustaw parametr get_all_creator_attributes na true, aby pobrać wszystkie dostępne encje Grafu wiedzy oznaczone jako atrybuty twórcy. Jeśli używasz tej opcji, musisz wybrać wymiar KNOWLEDGE_GRAPH, pole query_text musi być puste i nie możesz połączyć tej opcji z search_filter.

Atrybuty zwracane przez tę metodę wykrywania mogą być używane jako dane wejściowe dla innych metod AudienceInsightsService.

Każdy obiekt AudienceInsightsAttributeMetadata w ListAudienceInsightsAttributesResponse zawiera ustrukturyzowaną reprezentację atrybutu odbiorców wraz z właściwościami opisowymi i wskaźnikami zaangażowania. Zawiera on podstawową definicję atrybutu, wyświetlaną nazwę, typ wymiaru i szacowany zasięg wśród odbiorców. Definicje pól znajdziesz w dokumentacji AudienceInsightsAttributeMetadata.

Generowanie definicji listy odbiorców

Metoda generateAudienceDefinition przekształca opis odbiorców w formie tekstu swobodnego w uporządkowane sugestie dotyczące atrybutów odbiorców, które możesz przekazywać do metod statystyk na dalszych etapach.

Generowanie statystyk dotyczących sugerowanego kierowania

Metoda generateSuggestedTargetingInsights zwraca kolekcję statystyk kierowania (np. segmentów odbiorców, na które można kierować reklamy) związanych z wybranymi odbiorcami.

Żądanych odbiorców możesz określić jako uporządkowany obiekt InsightsAudienceDefinition lub jako opis tekstowy w polu InsightsAudienceDescription.

generateAudienceCompositionInsights zwraca statystyki dotyczące poszczególnych segmentów atrybutów, a generateSuggestedTargetingInsights – zbiorcze sugestie dotyczące segmentów odbiorców Google Ads, na które można kierować reklamy. Ta metoda pomaga odpowiedzieć na pytania takie jak „Podaj mi sugestie dotyczące odbiorców, do których można kierować reklamy, w przypadku ojców w wieku 30–39 lat, którzy lubią łowić ryby”.

Generowanie danych dotyczących sugestii kierowania

Metoda generateTargetingSuggestionMetrics zwraca obiekt GenerateTargetingSuggestionMetricsResponse, który zawiera potencjalną liczbę użytkowników YouTube, do których można dotrzeć w przypadku każdej definicji listy odbiorców żądanej w parametrze GenerateTargetingSuggestionMetricsRequest.

Ta metoda pomaga odpowiedzieć na pytania takie jak „Do ilu mężczyzn w wieku powyżej 18 lat, którzy interesują się biwakowaniem, można dotrzeć na YouTube w Stanach Zjednoczonych?”.

Generowanie statystyk dotyczących struktury odbiorców

Metoda generateAudienceCompositionInsights zwraca obiekt GenerateAudienceCompositionInsightsResponse, który zawiera listę atrybutów reprezentujących wybraną grupę odbiorców, a także dane dotyczące indeksu i udziału, które porównują udział każdego atrybutu w grupie odbiorców z populacją bazową.

Musisz podać kraj docelowy dla odbiorców. Lista obsługiwanych wymiarów do pobierania statystyk dotyczących kompozycji jest udokumentowana w polu dimensions w GenerateAudienceCompositionInsightsRequest.

Ta metoda pomaga odpowiedzieć na pytania takie jak „Jakie są główne podobieństwa, którymi interesują się moi docelowi odbiorcy w porównaniu z ogółem populacji, i o ile bardziej prawdopodobne jest, że będą oni zainteresowani tymi podobieństwami?”.

Generowanie statystyk dotyczących pokrywania się list odbiorców

Metoda generateAudienceOverlapInsights zwraca obiekt GenerateAudienceOverlapInsightsResponse, który zawiera listę atrybutów odbiorców z szacunkowymi danymi o pokrywaniu się ich potencjalnego zasięgu w YouTube z zasięgiem atrybutu głównego.

Musisz podać kraj docelowy i atrybut podstawowy. Jako wymiary odbiorców obsługiwane są przedział wiekowy, płeć, segmenty odbiorców o podobnych zainteresowaniach i segmenty na rynku.

Ta metoda pomaga odpowiedzieć na pytania takie jak „Jak duża jest przyrostowa wielkość grupy odbiorców, gdy kierujemy reklamy zarówno do fanów sportu, jak i miłośników muzyki w Stanach Zjednoczonych?”.

Generowanie raportu Insights Finder

Metoda generateInsightsFinderReport tworzy zapisany raport w Insights Finder na podstawie danych wejściowych określonych w GenerateInsightsFinderReportRequest i zwraca GenerateInsightsFinderReportResponse zawierający dostępny zewnętrznie link do otwarcia tego raportu w interfejsie Insights Finder.

Narzędzie Google Issue Tracker

Użyj narzędzia Issue Tracker, aby zadać pytania zespołowi pomocy, zgłosić błędy lub przesłać prośby o dodanie funkcji. Google śledzi i priorytetyzuje Twoje zgłoszenia oraz publikuje aktualizacje bezpośrednio w narzędziu Issue Tracker. Więcej informacji znajdziesz w artykule Tworzenie zgłoszenia w narzędziu Google Issue Tracker.

Utwórz zgłoszenie, korzystając z jednego z tych szablonów narzędzia Issue Tracker:

Wypełnij wszystkie pola w szablonie, podając szczegółowe informacje, abyśmy mogli odtworzyć problem i nadać Twojej prośbie odpowiedni priorytet. Google może zamknąć niekompletne zgłoszenia i poprosić Cię o przesłanie nowego zgłoszenia z brakującymi informacjami.

Wstecz
Przegląd
Dalej
Statystyki twórców YouTube