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/v14/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.

InsightsAudience

Zbiór użytkowników określony przez różne cechy, w przypadku których można zażądać statystyk za pomocą AudienceInsightsService.

Zapis JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Pola
countryLocations[]

object (LocationInfo)

To pole jest wymagane. Kraje odbiorców.
subCountryLocations[]

object (LocationInfo)

Atrybuty lokalizacji geograficznej podrzędnych krajów. Jeśli występuje, każdy z tych elementów musi znajdować się w jednym z krajów na tej liście odbiorców. Jeśli ich nie ma, odbiorcy są kierowani do lokalizacji geograficznej w kraju, a nie dalej.
gender

object (GenderInfo)

Płeć odbiorców. Jeśli go nie ma, grupa odbiorców nie jest ograniczana ze względu na płeć.
ageRanges[]

object (AgeRangeInfo)

Przedziały wiekowe odbiorców. Jeśli jej nie ma, grupa odbiorców obejmuje wszystkie osoby powyżej 18 roku życia, które pasują do innych atrybutów.
parentalStatus

object (ParentalStatusInfo)

Status rodzicielski odbiorców. Jeśli go brakuje, grupa odbiorców nie jest ograniczona ze względu na status rodzicielski.
incomeRanges[]

object (IncomeRangeInfo)

Zakresy centyli dochodu gospodarstwa domowego w grupie odbiorców. Jeśli go brakuje, grupa odbiorców nie jest ograniczona według przedziału dochodu gospodarstwa domowego.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Dynamiczne lineupy reprezentujące treści w YouTube oglądane przez odbiorców.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Kombinacja atrybutów podmiotu, kategorii i zainteresowań użytkownika definiujących odbiorców. Kombinacja ma logiczną strukturę typu ORAZ i LUB: atrybuty w każdej grupie InsightsAudienceAttributeGroup są połączone operatorem LUB, a same kombinacje są połączone operatorem ORAZ. Na przykład wyrażenie (Jednostka LUB Podobne zainteresowania) I (Odbiorcy na rynku LUB Kategoria) można utworzyć za pomocą 2 grup InsightsAudienceAttributeGroups po 2 atrybuty.

InsightsAudienceAttributeGroup

Lista atrybutów AudienceInsightsAttributes.

Zapis JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Pola
attributes[]

object (AudienceInsightsAttribute)

To pole jest wymagane. Zbiór atrybutów odbiorców, który należy połączyć za pomocą operatora logicznego LUB. Atrybuty nie muszą być takimi samymi wymiarami. W tym kontekście obsługiwane są tylko elementy Grafu wiedzy, Kategorie produktów i usług oraz Odbiorcy o podobnych zainteresowaniach i Odbiorcy na rynku.

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).