Method: customers.generateAudienceOverlapInsights

Hier sehen Sie eine Reihe von Zielgruppenattributen sowie Schätzungen der Überschneidung zwischen ihrer potenziellen YouTube-Reichweite und der eines bestimmten Eingabeattributs.

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

HTTP-Anfrage

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

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 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Felder
countryLocation

object (LocationInfo)

Erforderlich. Das Land, in dem die Größe und Überschneidungen von Zielgruppen berechnet werden sollen.
primaryAttribute

object (AudienceInsightsAttribute)

Erforderlich. Das Zielgruppenattribut, das mit allen anderen infrage kommenden Zielgruppen übereinstimmen soll. Es muss sich um ein gemeinsames Interesse, ein in-market-Nutzerinteresse, ein Alter oder ein Geschlecht handeln.
dimensions[]

enum (AudienceInsightsDimension)

Erforderlich. Die Attributtypen, für die die Überschneidung mit dem primären Attribut berechnet werden soll. Die Werte müssen Teilmengen von AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE und GENDER sein.
customerInsightsGroup

string

Der Name des Kunden, für den die Planung geplant ist. Dies ist ein benutzerdefinierter Wert.

Antworttext

Antwortnachricht für AudienceInsightsService.GenerateAudienceOverlapInsights.

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

JSON-Darstellung 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Felder
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Metadaten für das primäre Attribut, einschließlich der potenziellen YouTube-Reichweite.
dimensionResults[]

object (DimensionOverlapResult)

Listen von Attributen und deren Überschneidung mit dem primären Attribut, eine Liste pro angeforderter Dimension.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

DimensionOverlapResult

Eine Liste von Zielgruppenattributen einer einzelnen Dimension, einschließlich ihrer Überschneidung mit einem primären Attribut, die als Teil eines GenerateAudienceOverlapInsightsResponse zurückgegeben wird.

JSON-Darstellung 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Felder
dimension

enum (AudienceInsightsDimension)

Die Dimension aller Attribute in diesem Abschnitt.
items[]

object (AudienceOverlapItem)

Die Attribute und ihre Überschneidung mit dem Hauptattribut.

AudienceOverlapItem

Ein Zielgruppenattribut mit Metadaten, einschließlich der Überschneidung zwischen der potenziellen YouTube-Reichweite dieses Attributs und der eines primären Attributs.

JSON-Darstellung 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Felder
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Das Attribut und seine Metadaten, einschließlich der potenziellen YouTube-Reichweite.
potentialYoutubeReachIntersection

string (int64 format)

Die geschätzte Größe der Schnittmenge dieses Zielgruppenattributs mit dem primären Attribut, also die Anzahl der erreichbaren YouTube-Nutzer, die SOWOHL dem primären Attribut als auch diesem Attribut entsprechen.