Method: customers.generateAudienceCompositionInsights

Gibt eine Sammlung von Attributen zurück, die in einer relevanten Zielgruppe vertreten sind, mit Messwerten, die den Anteil der einzelnen Attribute an der Zielgruppe mit dem Anteil an der Baseline-Zielgruppe vergleichen.

Liste der ausgegebenen Fehler: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Felder
audience

object (InsightsAudience)

Erforderlich. Die Zielgruppe, für die Erkenntnisse angefordert werden.
baselineAudience

object (InsightsAudience)

Die Baseline-Zielgruppe, mit der die gewünschte Zielgruppe verglichen wird.
dataMonth

string

Der Zeitraum von einem Monat, der für Statistiken im Format "yyyy-mm" verwendet werden soll. Wenn die Richtlinie nicht konfiguriert ist, werden Statistiken für die letzten 30 Tage zurückgegeben.
dimensions[]

enum (AudienceInsightsDimension)

Erforderlich. Die Zielgruppendimensionen, für die Zusammensetzungsstatistiken zurückgegeben werden sollen.
customerInsightsGroup

string

Der Name der Kundin oder des Kunden, für den/die geplant werden soll. Dies ist ein benutzerdefinierter Wert.

Antworttext

Antwortnachricht für AudienceInsightsService.GenerateAudienceCompositionInsights.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Felder
sections[]

object (AudienceCompositionSection)

Der Inhalt des Statistikberichts (in Abschnitte gegliedert). Jeder Bereich ist mit einem der AudienceInsightsDimension-Werte in der Anfrage verknüpft. Pro Dimension kann mehr als ein Abschnitt vorhanden sein.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AudienceCompositionSection

Eine Sammlung verwandter Attribute desselben Typs in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung.

JSON-Darstellung 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Felder
dimension

enum (AudienceInsightsDimension)

Der Typ der Attribute in diesem Abschnitt.
topAttributes[]

object (AudienceCompositionAttribute)

Die relevantesten Segmente für diese Zielgruppe. Falls die Dimension GENDER, AGE_RANGE oder PARENTAL_STATUS lautet, ist diese Liste der Attribute vollständig.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Zusätzliche Attribute für diese Zielgruppe, gruppiert in Clustern. Wird nur ausgefüllt, wenn die Dimension YOUTUBE_CHANNEL ist.

AudienceCompositionAttribute

Ein Zielgruppenattribut mit Metadaten und Messwerten.

JSON-Darstellung 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Felder
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Das Attribut mit seinen Metadaten.
metrics

object (AudienceCompositionMetrics)

Messwerte für das Attribut freigeben und indexieren.

AudienceCompositionMetrics

Die Anteil- und Indexmesswerte, die einem Attribut in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung zugeordnet sind.

JSON-Darstellung 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Felder
baselineAudienceShare

number

Der Anteil der Baseline-Zielgruppe (von 0 bis einschließlich 1), der mit dem Attribut übereinstimmt.
audienceShare

number

Der Anteil (von 0 bis einschließlich 1) der spezifischen Zielgruppe, die dem Attribut entspricht.
index

number

Das Verhältnis von „AudienceShare“ zu „BaselineAudienceShare“ oder null, wenn dieses Verhältnis nicht definiert oder nicht aussagekräftig ist.
score

number

Ein Relevanzwert von 0 bis einschließlich 1.

AudienceCompositionAttributeCluster

Eine Sammlung verwandter Attribute mit Metadaten und Messwerten in einem Bericht mit Statistiken zur Zielgruppenzusammensetzung.

JSON-Darstellung 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Felder
clusterDisplayName

string

Der Name dieses Clusters von Attributen
clusterMetrics

object (AudienceCompositionMetrics)

Wenn die mit diesem Cluster verknüpfte Dimension YOUTUBE_CHANNEL ist, dann sind clusterMetrics Messwerte, die dem Cluster als Ganzes zugeordnet sind. Bei anderen Dimensionen ist das Feld nicht festgelegt.
attributes[]

object (AudienceCompositionAttribute)

Die einzelnen Attribute, aus denen dieser Cluster besteht, mit Metadaten und Messwerten.