- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- TargetingSuggestionMetrics
- Wypróbuj
Zwraca zbiór statystyk kierowania (np. odbiorców, na których można kierować reklamy) istotnych dla wybranej grupy odbiorców.
Lista zgłoszonych błędów: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Żądanie HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateSuggestedTargetingInsights
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "audience": { object ( |
Pola | |
---|---|
audience |
To pole jest wymagane. Interesująca grupa odbiorców, w przypadku której należy uzyskać statystyki. |
baselineAudience |
Opcjonalnie. Bazowa grupa odbiorców. Domyślnie, jeśli nie określono inaczej, są wszystkie osoby z tego samego kraju co interesująca grupa odbiorców. |
dataMonth |
Opcjonalnie. Miesięczny zakres danych historycznych na potrzeby statystyk, w formacie „rrrr-mm”. Jeśli nie jest skonfigurowana, zwracane są statystyki z ostatnich 30 dni. |
customerInsightsGroup |
Opcjonalnie. Nazwa planowanego klienta. Jest to wartość zdefiniowana przez użytkownika. |
Treść odpowiedzi
Wiadomość z odpowiedzią na temat: AudienceInsightsService.GenerateSuggestedTargetingInsights
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"suggestions": [
{
object ( |
Pola | |
---|---|
suggestions[] |
Sugerowane statystyki dotyczące odbiorców, na których można kierować reklamy. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/adwords
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
TargetingSuggestionMetrics
Sugerowana grupa odbiorców, na którą można kierować reklamy, odpowiednia dla wybranej grupy odbiorców.
Zapis JSON |
---|
{ "locations": [ { object ( |
Pola | |
---|---|
locations[] |
Sugerowane kierowanie na lokalizację. Wszystkie te atrybuty mają wymiar GEO_TARGET_COUNTRY lub SUB_COUNTRY_LOCATION |
ageRanges[] |
Sugerowany wiek; może być pusty, co oznacza, że nie ma takiego kierowania. |
gender |
Sugerowane kierowanie na płeć. Jeśli ten atrybut występuje, ma wymiar GENDER. |
userInterests[] |
Sugerowane segmenty odbiorców, na które warto kierować reklamy. Wszystkie te atrybuty mają wymiar AFFINITY_USER_INTEREST lub IN_MARKET_USER_INTEREST |
coverage |
Odsetek żądanych odbiorców, do których można dotrzeć przy użyciu sugerowanego kierowania (od 0 do 1 włącznie). |
index |
Stosunek pokrycia do pokrycia bazowej grupy odbiorców lub zero, jeśli współczynnik ten jest niezdefiniowany lub nieistotny. |
potentialYoutubeReach |
Przybliżona liczba osób, do których można dotrzeć w YouTube przy użyciu tych ustawień kierowania. |