Method: customers.generateSuggestedTargetingInsights

Zwraca zbiór statystyk kierowania (np. odbiorców, na których można kierować reklamy), które są istotne w przypadku żądanej listy odbiorców.

Lista zgłoszonych błędów: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v16/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 została wysłana prośba o statystyki.
baselineAudience

object (InsightsAudience)

Opcjonalnie. Bazowa grupa odbiorców. Jeśli nie określono inaczej, domyślnym ustawieniem 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, wyświetlane są obserwacje obejmujące dane z ostatnich 30 dni.
customerInsightsGroup

string

Opcjonalnie. Nazwa planowanego klienta. Jest to wartość zdefiniowana przez użytkownika.

Treść odpowiedzi

Odpowiedź na pytanie: 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óre można kierować reklamy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

TargetingSuggestionMetrics

Sugerowana grupa odbiorców, na którą można kierować reklamy w przypadku 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)

Sugerowane kierowanie na wiek; może być puste, co oznacza, że nie ma kierowania na wiek.
gender

object (GenderInfo)

Sugerowane kierowanie na płeć. Jeśli ten atrybut istnieje, 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 (od 0 do 1 włącznie) w pożądanej grupie odbiorców, do której można dotrzeć za pomocą sugerowanego kierowania.
index

number

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

string (int64 format)

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