Method: customers.generateSuggestedTargetingInsights

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

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Pola
audience

object (InsightsAudience)

To pole jest wymagane. Interesująca grupa odbiorców, w przypadku której należy uzyskać statystyki.
baselineAudience

object (InsightsAudience)

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

string

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

string

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 (TargetingSuggestionMetrics)
    }
  ]
}
Pola
suggestions[]

object (TargetingSuggestionMetrics)

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 (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Pola
locations[]

object (AudienceInsightsAttributeMetadata)

Sugerowane kierowanie na lokalizację. Wszystkie te atrybuty mają wymiar GEO_TARGET_COUNTRY lub SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

Sugerowany wiek; może być pusty, co oznacza, że nie ma takiego kierowania.
gender

object (GenderInfo)

Sugerowane kierowanie na płeć. Jeśli ten atrybut występuje, ma wymiar GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Sugerowane segmenty odbiorców, na które warto kierować reklamy. Wszystkie te atrybuty mają wymiar AFFINITY_USER_INTEREST lub IN_MARKET_USER_INTEREST
coverage

number

Odsetek żądanych odbiorców, do których można dotrzeć przy użyciu sugerowanego kierowania (od 0 do 1 włącznie).
index

number

Stosunek pokrycia do pokrycia bazowej grupy odbiorców lub zero, jeśli współczynnik ten jest niezdefiniowany lub nieistotny.
potentialYoutubeReach

string (int64 format)

Przybliżona liczba osób, do których można dotrzeć w YouTube przy użyciu tych ustawień kierowania.