Method: customers.generateAudienceCompositionInsights

Gibt eine Sammlung von Attributen zurück, die in einer gewünschten Zielgruppe vertreten sind, mit Messwerten, mit denen der Anteil der einzelnen Attribute an der Zielgruppe mit dem Anteil an der Baseline-Zielgruppe verglichen wird.

Liste der ausgelösten Fehler: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
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 Informationen angefordert werden.
baselineAudience

object (InsightsAudience)

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

string

Der einmonatige Bereich der Verlaufsdaten, die für Insights verwendet werden sollen, im Format „jjjj-mm“. Wenn die Richtlinie nicht konfiguriert ist, werden Statistiken für die Daten der letzten 30 Tage zurückgegeben.
dimensions[]

enum (AudienceInsightsDimension)

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

string

Der Name des Kunden, für den Sie in der Planung sind. 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 einem der AudienceInsightsDimension-Werte in der Anfrage zugeordnet. 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 zusammengehöriger Attribute desselben Typs in einem Bericht mit Informationen 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. Wenn die Dimension GENDER, AGE_RANGE oder PARENTAL_STATUS ist, 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 Anteile und Indexmesswerte, die einem Attribut in einem Bericht mit Informationen 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 mit dem Attribut übereinstimmt.
index

number

Das Verhältnis von „audienceShare“ zu „BaselineAudienceShare“. Es kann auch null sein, 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 mit dem Cluster als Ganzes verknüpft sind. Bei anderen Dimensionen ist das Feld nicht festgelegt.
attributes[]

object (AudienceCompositionAttribute)

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