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),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
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.
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.
scope

enum (AudienceScope)

Definiert den Bereich, in dem diese Zielgruppe verwendet werden kann. Standardmäßig ist der Bereich CUSTOMER. Zielgruppen können mit dem Bereich ASSET_GROUP exklusiv für eine einzelne Asset-Gruppe erstellt werden. Der Umfang kann sich von ASSET_GROUP zu CUSTOMER ändern, jedoch nicht von CUSTOMER zu ASSET_GROUP.
assetGroup

string

Nicht veränderbar. Die Asset-Gruppe, der diese Zielgruppe zugeordnet ist. Dieser Wert muss ausschließlich dann festgelegt werden, wenn der Geltungsbereich ASSET_GROUP ist. Nach dem Erstellen unveränderlich. Wenn eine Zielgruppe mit dem Geltungsbereich ASSET_GROUP auf den Bereich CUSTOMER aktualisiert wird, wird das Feld automatisch gelöscht.
name

string

Name der Zielgruppe. Sie muss für alle Zielgruppen innerhalb des Kontos eindeutig sein. Sie muss eine Mindestlänge von 1 und eine maximale Länge von 255 Zeichen haben. Erforderlich, wenn der Umfang nicht festgelegt oder auf CUSTOMER festgelegt ist. Kann nicht festgelegt oder aktualisiert werden, wenn der Geltungsbereich ASSET_GROUP ist.

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.

AudienceScope

Aufzählung mit möglichen Werten für den Zielgruppenbereich.

Enums
UNSPECIFIED Der Bereich wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt.
CUSTOMER Die Zielgruppe wird auf Kundenebene festgelegt.
ASSET_GROUP Die Zielgruppe wird einer bestimmten Asset-Gruppe zugeordnet.