Method: customers.generateSuggestedTargetingInsights

Gibt eine Sammlung von Targeting-Informationen zurück (z.B. Zielgruppen, für die eine Ausrichtung möglich ist), die für die angeforderte Zielgruppe relevant sind.

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

HTTP-Anfrage

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

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,
  "customerInsightsGroup": string
}
Felder
audience

object (InsightsAudience)

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

object (InsightsAudience)

Optional. Die Baseline-Zielgruppe Wenn nicht angegeben, werden standardmäßig alle Nutzer im selben Land wie die gewünschte Zielgruppe verwendet.
dataMonth

string

Optional. 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.
customerInsightsGroup

string

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

Antworttext

Antwortnachricht für AudienceInsightsService.GenerateSuggestedTargetingInsights.

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

JSON-Darstellung 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Felder
suggestions[]

object (TargetingSuggestionMetrics)

Vorschläge für Statistiken zu Zielgruppen, für die eine Ausrichtung möglich ist

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

TargetingSuggestionMetrics

Eine vorgeschlagene Zielgruppe, die für die angefragte Zielgruppe relevant ist.

JSON-Darstellung 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Felder
locations[]

object (AudienceInsightsAttributeMetadata)

Vorschlag für geografische Ausrichtung. Diese Attribute haben alle die Dimension GEO_TARGET_COUNTRY oder SUB_COUNTRY_LOCATION.
ageRanges[]

object (AgeRangeInfo)

Vorgeschlagene Ausrichtung auf Altersgruppen. Das Feld kann leer sein, wenn es keine Ausrichtung auf Altersgruppen gibt.
gender

object (GenderInfo)

Vorgeschlagenes Geschlechts-Targeting. Dieses Attribut hat gegebenenfalls die Dimension GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Vorgeschlagene Zielgruppensegmente für die Ausrichtung. Diese Attribute haben alle die Dimension AFFINITY_USER_INTEREST oder IN_MARKET_USER_INTEREST.
coverage

number

Der Anteil (von 0 bis einschließlich 1) der angefragten Zielgruppe, der mit dem vorgeschlagenen Targeting erreicht werden kann.
index

number

Das Verhältnis der Abdeckung zur Abdeckung der Baseline-Zielgruppe oder null, wenn dieses Verhältnis nicht definiert oder nicht aussagekräftig ist.
potentialYoutubeReach

string (int64 format)

Die geschätzte Anzahl von Nutzern, die mit dieser Ausrichtung auf YouTube erreicht werden können.