Method: customers.generateAudienceCompositionInsights

Zwraca zbiór atrybutów reprezentowanych przez daną grupę odbiorców wraz z danymi, które porównują udział każdego atrybutu w grupie odbiorców z jego udziałem w bazowej grupie 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}:generateAudienceCompositionInsights

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,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "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)

Bazowa grupa odbiorców, z którą porównuje się interesującą grupę odbiorców.
dataMonth

string

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.
dimensions[]

enum (AudienceInsightsDimension)

To pole jest wymagane. Wymiary dotyczące odbiorców, dla których mają zostać zwrócone statystyki kompozycji.
customerInsightsGroup

string

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

Treść odpowiedzi

Odpowiedź na pytanie: AudienceInsightsService.GenerateAudienceCompositionInsights.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Pola
sections[]

object (AudienceCompositionSection)

Treść raportu dotyczącego statystyk podzielonych na sekcje. Każda sekcja jest powiązana z jedną z wartości wymiaru AudienceInsights w żądaniu. Każdy wymiar może mieć więcej niż 1 sekcję.

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.

AudienceCompositionSection

Zbiór powiązanych atrybutów tego samego typu w raporcie ze statystykami struktury odbiorców.

Zapis JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Pola
dimension

enum (AudienceInsightsDimension)

Typ atrybutów w tej sekcji.
topAttributes[]

object (AudienceCompositionAttribute)

Najtrafniejsze segmenty w przypadku tej grupy odbiorców. Jeśli wymiar to GENDER, AGE_RANGE lub PARENTAL_STATUS, ta lista atrybutów jest wyczerpująca.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Dodatkowe atrybuty dla tej listy odbiorców pogrupowane w klastry. Wartość jest podawana tylko wtedy, gdy wymiar to YOUTUBE_CHANNEL.

AudienceCompositionAttribute

Atrybut odbiorców z metadanymi i danymi.

Zapis JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Pola
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Atrybut z jego metadanymi.
metrics

object (AudienceCompositionMetrics)

Udostępnianie i indeksowanie wskaźników dla atrybutu.

AudienceCompositionMetrics

Dane dotyczące udziału i indeksu powiązane z atrybutem w raporcie ze statystykami struktury odbiorców.

Zapis JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Pola
baselineAudienceShare

number

Odsetek (od 0 do 1 włącznie) odbiorców bazowych, którzy pasują do danego atrybutu.
audienceShare

number

Odsetek wszystkich odbiorców pasujących do danego atrybutu (od 0 do 1 włącznie).
index

number

Stosunek wartości AudienceShare do bazowego udziału odbiorców lub zero, jeśli ten współczynnik jest niezdefiniowany lub nie ma istotnego znaczenia.
score

number

Wynik trafności od 0 do 1 włącznie.

AudienceCompositionAttributeCluster

Zbiór powiązanych atrybutów wraz z metadanymi i danymi w raporcie ze statystykami struktury odbiorców.

Zapis JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Pola
clusterDisplayName

string

Nazwa tego klastra atrybutów
clusterMetrics

object (AudienceCompositionMetrics)

Jeśli wymiar powiązany z tym klastrem to YOUTUBE_CHANNEL, parametrclusterMetrics jest danymi powiązanymi z klastrem jako całym klastrem. W przypadku innych wymiarów to pole jest nieskonfigurowane.
attributes[]

object (AudienceCompositionAttribute)

Poszczególne atrybuty tworzące ten klaster wraz z metadanymi i wskaźnikami.