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

InsightsAudience

Eine Gruppe von Nutzern, definiert durch verschiedene Merkmale, für die mit AudienceInsightsService Statistiken angefordert werden können.

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

object (LocationInfo)

Erforderlich. Die Länder für die Zielgruppe.
subCountryLocations[]

object (LocationInfo)

Geografischer Standortattribute für das Unterland. Sofern vorhanden, muss jedes dieser Elemente in einem der Länder der Zielgruppe enthalten sein. Ist dies nicht der Fall, wird die Zielgruppe geografisch auf die countryLocations ausgerichtet und nicht weiter.
gender

object (GenderInfo)

Geschlecht der Zielgruppe. Ist dies nicht der Fall, wird die Zielgruppe nicht nach Geschlecht eingeschränkt.
ageRanges[]

object (AgeRangeInfo)

Altersgruppen für die Zielgruppe. Falls nicht, umfasst die Zielgruppe alle Personen über 18 Jahren, die den anderen Attributen entsprechen.
parentalStatus

object (ParentalStatusInfo)

Elternstatus für die Zielgruppe. Ist dies nicht der Fall, gelten für die Zielgruppe keine Einschränkungen durch den Elternstatus.
incomeRanges[]

object (IncomeRangeInfo)

Perzentilbereiche des Haushaltseinkommens für die Zielgruppe. Ist dies nicht der Fall, wird die Zielgruppe nicht auf den Bereich des Haushaltseinkommens angewendet.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Dynamische Pakete, die die von der Zielgruppe angesehenen YouTube-Inhalte darstellen
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Eine Kombination aus Entitäts-, Kategorie- und Nutzerinteressenattributen, mit denen die Zielgruppe definiert wird. Die Kombination hat eine logische UND-aus-ODER-Struktur: Attribute innerhalb einer InsightsAudienceAttributeGroup werden mit OR und die Kombinationen selbst mit AND kombiniert. Beispielsweise kann der Ausdruck (Entity OR Affinität) AND (kaufbereit ODER Kategorie) mithilfe von zwei InsightsAudienceAttributeGroups mit jeweils zwei Attributen gebildet werden.

InsightsAudienceAttributeGroup

Eine Liste der AudienceInsightsAttributes.

JSON-Darstellung 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Felder
attributes[]

object (AudienceInsightsAttribute)

Erforderlich. Eine Sammlung von Zielgruppenattributen, die mit einem logischen ODER kombiniert werden sollen. Die Attribute müssen nicht alle dieselbe Dimension haben. In diesem Kontext werden nur Knowledge Graph-Objekte, Produkt- und Dienstleistungskategorien sowie Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen unterstützt.

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.