Audience

„Zielgruppe“ ist eine effektive Ausrichtungsoption, bei der sich verschiedene Segmentattribute wie detaillierte demografische Merkmale und gemeinsame Interessen überschneiden lassen. So lassen sich Zielgruppen 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 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, mit denen die Zusammensetzung der Zielgruppe angegeben wird
exclusionDimension

object (AudienceExclusionDimension)

Negative Dimension für die Zusammensetzung der Zielgruppe
scope

enum (AudienceScope)

Definiert den Bereich, in dem diese Zielgruppe verwendet werden kann. Standardmäßig ist der Bereich CUSTOMER. Zielgruppen können mit dem Umfang „ASSET_GROUP“ erstellt und ausschließlich durch eine einzelne Asset-Gruppe verwendet werden. Der Umfang kann sich von ASSET_GROUP zu CUSTOMER ändern, aber nicht von CUSTOMER zu ASSET_GROUP.
assetGroup

string

Nicht veränderbar. Die Asset-Gruppe, der diese Zielgruppe zugeordnet ist. Muss festgelegt werden, wenn der Umfang ASSET_GROUP ist. Nach dem Erstellen unveränderlich. Wenn für eine Zielgruppe mit dem Umfang ASSET_GROUP ein Upgrade auf den Umfang CUSTOMER durchgeführt wird, wird das Feld automatisch gelöscht.
name

string

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

AudienceStatus

Enum-Wert, der mögliche Zielgruppenstatustypen enthält.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version 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 Nutzer, die zur Zielgruppe gehören. Für dimension ist nur einer der folgenden Werte zulässig:
age

object (AgeDimension)

Dimension für Nutzer nach Alter.
gender

object (GenderDimension)

Dimension für Nutzer nach Geschlecht.
householdIncome

object (HouseholdIncomeDimension)

Dimension für Nutzer nach Haushaltseinkommen.
parentalStatus

object (ParentalStatusDimension)

Dimension zum Angeben von Nutzern nach Elternstatus.
audienceSegments

object (AudienceSegmentDimension)

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

AgeDimension

Dimension für Nutzer nach Alter.

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

object (AgeSegment)

Zusammengehörige Altersgruppe, die in die Dimension einbezogen werden soll.
includeUndetermined

boolean

Nutzer einschließen, deren Alter nicht bestimmt wurde.

AgeSegment

Zusammenhängende 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

Maximal zulässiges Alter. Es muss kein Höchstalter angegeben werden. Falls angegeben, muss „maxAge“ größer als „minAge“ sein und die zulässigen Werte sind 24, 34, 44, 54 und 64.

GenderDimension

Dimension für Nutzer nach Geschlecht.

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

enum (GenderType)

Demografische Segmente für das Geschlecht eingeschlossen.
includeUndetermined

boolean

Nutzer einschließen, deren Geschlecht nicht bestimmt wurde.

HouseholdIncomeDimension

Dimension für Nutzer nach Haushaltseinkommen.

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

enum (IncomeRangeType)

Berücksichtigte demografische Segmente für das Haushaltseinkommen.
includeUndetermined

boolean

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

ParentalStatusDimension

Dimension zum Angeben von Nutzern nach Elternstatus.

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

enum (ParentalStatusType)

Demografische Segmente „Elternstatus“ eingeschlossen.
includeUndetermined

boolean

Nutzer einschließen, deren Elternstatus unbekannt ist

AudienceSegmentDimension

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

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

object (AudienceSegment)

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

AudienceSegment

Einschließendes 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. Einschließendes Segment. Für segment ist nur einer der folgenden Werte zulässig:
userList

object (UserListSegment)

Nutzerlistensegment.
userInterest

object (UserInterestSegment)

Segment mit gemeinsamen Interessen oder mit 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 der 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

Die Ressource für benutzerdefinierte Zielgruppen.

AudienceExclusionDimension

Negative Dimension mit Angabe von Nutzern, die aus der Zielgruppe ausgeschlossen werden sollen

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

object (ExclusionSegment)

Zielgruppensegment, das ausgeschlossen werden soll.

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

Enum-Wert, der mögliche Werte für den Zielgruppenbereich enthält.

Enums
UNSPECIFIED Der Umfang 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.