Audience

„Zielgruppe“ ist eine effektive Ausrichtungsoption, bei der Sie verschiedene Segmentattribute wie detaillierte demografische Merkmale und gemeinsame Interessen kombinieren können, um Zielgruppen zu erstellen, die bestimmten Bereichen Ihrer Zielsegmente entsprechen.

JSON-Darstellung 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname der Zielgruppe. Zielgruppennamen haben das folgende Format:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Nur Ausgabe ID der Zielgruppe.
status

enum (AudienceStatus)

Nur Ausgabe Status dieser Zielgruppe. Gibt an, ob die Zielgruppe aktiviert oder entfernt wurde.
name

string

Erforderlich. Name der Zielgruppe. Sie sollte für alle Zielgruppen eindeutig sein. Sie muss eine Mindestlänge von 1 und eine maximale Länge von 255 Zeichen haben.
description

string

Beschreibung dieser Zielgruppe.
dimensions[]

object (AudienceDimension)

Positive Dimensionen, die die Zusammensetzung der Zielgruppe angeben.
exclusionDimension

object (AudienceExclusionDimension)

Negative Dimension, die die Zusammensetzung der Zielgruppe angibt.

AudienceStatus

Enum mit möglichen Zielgruppenstatustypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
ENABLED Status „Aktiviert“: Die Zielgruppe ist aktiviert und kann für das Targeting verwendet werden.
REMOVED Status „Entfernt“: Die Zielgruppe wurde entfernt und kann nicht für die Ausrichtung verwendet werden.

AudienceDimension

Positive Dimension, die die Zielgruppe des Nutzers angibt.

JSON-Darstellung 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
Felder
Union-Feld dimension. Dimension für die Nutzer, die zur Zielgruppe gehören Für dimension ist nur einer der folgenden Werte zulässig:
age

object (AgeDimension)

Dimension, die Nutzer nach Alter angibt.
gender

object (GenderDimension)

Dimension für die Angabe von Nutzern nach Geschlecht.
householdIncome

object (HouseholdIncomeDimension)

Dimension für Nutzer nach Haushaltseinkommen.
parentalStatus

object (ParentalStatusDimension)

Dimension für die Angabe von Nutzern nach Elternstatus.
audienceSegments

object (AudienceSegmentDimension)

Dimension, die Nutzer nach ihrer Mitgliedschaft in anderen Zielgruppensegmenten angibt.

AgeDimension

Dimension, die Nutzer nach Alter angibt.

JSON-Darstellung 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Felder
ageRanges[]

object (AgeSegment)

Zusammenhängende Altersgruppe, die in die Dimension einbezogen werden soll
includeUndetermined

boolean

Nutzer einschließen, deren Alter nicht ermittelt werden kann.

AgeSegment

Aufeinanderfolgende Altersgruppe.

JSON-Darstellung 
{
  "minAge": integer,
  "maxAge": integer
}
Felder
minAge

integer

Einzuschließendes Mindestalter. Es muss ein Mindestalter von 18 Jahren angegeben werden. Zulässige Werte sind 18, 25, 35, 45, 55 und 65.
maxAge

integer

Höchstalter für die Aufnahme. Es muss kein Höchstalter angegeben werden. Wenn angegeben, muss maxAge größer als minAge sein und die zulässigen Werte sind 24, 34, 44, 54 und 64.

GenderDimension

Dimension für die Angabe von Nutzern nach Geschlecht.

JSON-Darstellung 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Felder
genders[]

enum (GenderType)

Demografische Segmente nach Geschlecht eingeschlossen.
includeUndetermined

boolean

Nutzer einschließen, deren Geschlecht nicht bestimmt ist.

HouseholdIncomeDimension

Dimension für Nutzer nach Haushaltseinkommen.

JSON-Darstellung 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Felder
incomeRanges[]

enum (IncomeRangeType)

Demografische Segmente für das Haushaltseinkommen wurden berücksichtigt.
includeUndetermined

boolean

Nutzer einschließen, deren Haushaltseinkommen nicht ermittelt werden kann.

ParentalStatusDimension

Dimension für die Angabe von Nutzern nach Elternstatus.

JSON-Darstellung 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Felder
parentalStatuses[]

enum (ParentalStatusType)

Demografische Segmente zum Elternstatus wurden eingeschlossen.
includeUndetermined

boolean

Nutzer einschließen, deren Elternstatus unbekannt ist

AudienceSegmentDimension

Dimension, die Nutzer nach ihrer Mitgliedschaft in anderen Zielgruppensegmenten angibt.

JSON-Darstellung 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Felder
segments[]

object (AudienceSegment)

Eingeschlossene Zielgruppensegmente. Nutzer werden einbezogen, wenn sie mindestens einem Segment angehören.

AudienceSegment

Positives Zielgruppensegment

JSON-Darstellung 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
Felder
Union-Feld segment. Positives Segment Für segment ist nur einer der folgenden Werte zulässig:
userList

object (UserListSegment)

Nutzerlistensegment.
userInterest

object (UserInterestSegment)

Segment mit gemeinsamen Interessen oder kaufbereiten Zielgruppen
lifeEvent

object (LifeEventSegment)

Zielgruppensegment für Live-Veranstaltung.
detailedDemographic

object (DetailedDemographicSegment)

Detailliertes demografisches Segment.
customAudience

object (CustomAudienceSegment)

Benutzerdefiniertes Zielgruppensegment.

UserListSegment

Nutzerlistensegment. Die Funktion „Ähnliche Zielgruppen“ wird im Mai 2023 eingestellt. Weitere Optionen finden Sie unter https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.

JSON-Darstellung 
{
  "userList": string
}
Felder
userList

string

Die Nutzerlistenressource.

UserInterestSegment

Segment mit Nutzerinteresse.

JSON-Darstellung 
{
  "userInterestCategory": string
}
Felder
userInterestCategory

string

Die Ressource für das Nutzerinteresse.

LifeEventSegment

Segment für Live-Veranstaltung.

JSON-Darstellung 
{
  "lifeEvent": string
}
Felder
lifeEvent

string

Die Lebensereignisressource.

DetailedDemographicSegment

Detailliertes demografisches Segment.

JSON-Darstellung 
{
  "detailedDemographic": string
}
Felder
detailedDemographic

string

Die detaillierte demografische Ressource.

CustomAudienceSegment

Benutzerdefiniertes Zielgruppensegment.

JSON-Darstellung 
{
  "customAudience": string
}
Felder
customAudience

string

Ressource für benutzerdefinierte Zielgruppen

AudienceExclusionDimension

Eine negative Dimension, mit der die Nutzer angegeben werden, die aus der Zielgruppe ausgeschlossen werden sollen.

JSON-Darstellung 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Felder
exclusions[]

object (ExclusionSegment)

Auszuschließendes Zielgruppensegment.

ExclusionSegment

Zielgruppensegment, das aus einer Zielgruppe ausgeschlossen werden soll.

JSON-Darstellung 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Felder
Union-Feld segment. Auszuschließendes Segment. Für segment ist nur einer der folgenden Werte zulässig:
userList

object (UserListSegment)

Auszuschließendes Nutzerlistensegment.