Method: customers.generateSuggestedTargetingInsights

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

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

HTTP-Anfrage

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

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

object (InsightsAudience)

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

object (InsightsAudience)

Optional. Die Baseline-Zielgruppe. Wenn Sie nichts angeben, werden standardmäßig alle Nutzer verwendet, die sich im selben Land wie die gewünschte Zielgruppe befinden.
dataMonth

string

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

string

Optional. Der Name des Kunden, für den Sie in der Planung sind. 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)

Vorgeschlagene Statistiken für Zielgruppen, bei denen 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 gewünschte 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)

Vorgeschlagene geografische Ausrichtung. Alle diese Attribute haben die Dimension GEO_TARGET_COUNTRY oder SUB_COUNTRY_LOCATION.
ageRanges[]

object (AgeRangeInfo)

Vorgeschlagene Ausrichtung auf Altersgruppen. Das Feld kann leer sein, sodass keine Ausrichtung auf Altersgruppen angegeben ist.
gender

object (GenderInfo)

Vorgeschlagenes Geschlechts-Targeting. Falls vorhanden, hat dieses Attribut die Dimension GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Vorgeschlagene Zielgruppensegmente für die Ausrichtung. Alle diese Attribute haben die Dimension AFFINITY_USER_INTEREST oder IN_MARKET_USER_INTEREST.
coverage

number

Der Anteil (von 0 bis einschließlich 1) der angeforderten 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.