Method: customers.generateAudienceCompositionInsights

Zwraca zbiór atrybutów reprezentowanych przez interesującą grupę odbiorców z danymi, które porównują udział poszczególnych atrybutów w tej grupie odbiorców z udziałem w grupie bazowej.

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}: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 należy uzyskać statystyki.
baselineAudience

object (InsightsAudience)

Bazowa grupa odbiorców, z którą porównywana jest grupa odbiorców związana z zainteresowaniami.
dataMonth

string

Miesięczny zakres danych historycznych na potrzeby statystyk, w formacie „rrrr-mm”. Jeśli nie jest skonfigurowana, zwracane są statystyki z ostatnich 30 dni.
dimensions[]

enum (AudienceInsightsDimension)

To pole jest wymagane. Wymiary 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

Wiadomość z odpowiedzią na temat: AudienceInsightsService.GenerateAudienceCompositionInsights.

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

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

object (AudienceCompositionSection)

Zawartość 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 artykule Omówienie protokołu OAuth 2.0.

AudienceCompositionSection

Zbiór powiązanych atrybutów tego samego typu w raporcie na temat 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ść 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 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) w bazowej grupie odbiorców pasującej do atrybutu.
audienceShare

number

Odsetek (od 0 do 1 włącznie) według określonych odbiorców pasujących do atrybutu.
index

number

Stosunek wartości AudienceShare do bazowej grupy odbiorców lub zero, jeśli ten współczynnik jest niezdefiniowany lub nie ma istotności.
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 na temat 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 wymiarem powiązanym z tym klastrem jest YOUTUBE_CHANNEL, parametrclusterMetrics jest wskaźnikami powiązanymi z klastrem jako całym klastrem. W przypadku innych wymiarów to pole jest nieskonfigurowane.
attributes[]

object (AudienceCompositionAttribute)

Poszczególne atrybuty składające się na ten klaster (wraz z metadanymi i wskaźnikami).