CustomAudience

Eine benutzerdefinierte Zielgruppe. Dies ist eine Liste der Nutzer nach Interessen.

JSON-Darstellung 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname der benutzerdefinierten Zielgruppe. Namen benutzerdefinierter Zielgruppenressourcen haben folgendes Format:

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Nur Ausgabe. ID der benutzerdefinierten Zielgruppe.
status

enum (CustomAudienceStatus)

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

string

Name der benutzerdefinierten Zielgruppe. Sie muss für alle benutzerdefinierten Zielgruppen, die von einem Kunden erstellt wurden, eindeutig sein. Dieses Feld ist zum Erstellen von Vorgängen erforderlich.
type

enum (CustomAudienceType)

Typ der benutzerdefinierten Zielgruppe. („INTERESSE“ ODER „KAUFABSICHT“ ist für neu erstellte benutzerdefinierte Zielgruppen nicht zulässig, wird aber für vorhandene Zielgruppen beibehalten.)
description

string

Beschreibung dieser benutzerdefinierten Zielgruppe.
members[]

object (CustomAudienceMember)

Liste der Mitglieder der benutzerdefinierten Zielgruppe, aus denen diese besteht. Mitglieder können beim Erstellen der benutzerdefinierten Zielgruppe hinzugefügt werden. Wenn Mitglieder im UPDATE-Vorgang angezeigt werden, werden vorhandene Mitglieder überschrieben.

CustomAudienceStatus

Enum mit möglichen Status für benutzerdefinierte Zielgruppen.

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

CustomAudienceType

Enum mit möglichen Typen für benutzerdefinierte Zielgruppen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
AUTO In Google Ads wird die beste Interpretation automatisch bei der Auslieferung ausgewählt.
INTEREST Nutzer werden anhand ihrer Interessen abgeglichen.
PURCHASE_INTENT Nutzer werden anhand von Themen, die sie recherchieren, oder Produkten, die sie kaufen möchten, abgeglichen.
SEARCH Nutzer werden anhand ihrer Suchanfragen in der Google Suche abgeglichen.

CustomAudienceMember

Ein Mitglied der benutzerdefinierten Zielgruppe. Ein Mitglied kann ein KEINRICHTWORT, eine URL, eine ORTKATEGORIE oder eine APP sein. Es kann nur erstellt oder entfernt, aber nicht geändert werden.

JSON-Darstellung 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Felder
memberType

enum (CustomAudienceMemberType)

Der Typ des Mitglieds der benutzerdefinierten Zielgruppe: KEYWORD, URL, PLACE_CATEGORY oder APP.
Union-Feld value. Der Wert „CustomAudienceMember“. Je nach Mitgliedstyp wird ein Feld ausgefüllt. Für value ist nur einer der folgenden Werte zulässig:
keyword

string

Ein Keyword oder eine Keyword-Phrase – maximal 10 Wörter und 80 Zeichen. Bei Sprachen mit Zeichen doppelter Breite wie Chinesisch, Japanisch oder Koreanisch sind 40 Zeichen für die Beschreibung der Interessen oder Aktionen des Nutzers zulässig.
url

string

Eine HTTP-URL, einschließlich Protokoll – maximal 2.048 Zeichen, die Inhalte enthält, an denen Nutzer interessiert sind.
placeCategory

string (int64 format)

Ein Ortstyp, der durch eine Ortskategorie beschrieben wird, die Nutzer besuchen.
app

string

Der Paketname von Android-Apps, die Nutzer installiert haben, z. B. com.google.beispiel.

CustomAudienceMemberType

Enum mit möglichen Typen von Mitgliedern benutzerdefinierter Zielgruppen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
KEYWORD Nutzer, deren Interessen oder Aktionen durch ein Keyword beschrieben werden.
URL Nutzer, die Interessen haben, die sich auf die Inhalte der Website beziehen.
PLACE_CATEGORY Nutzer, die Orte besuchen, die durch eine Ortskategorie beschrieben werden.
APP Nutzer, die eine mobile App installiert haben.