CustomAudience

Eine benutzerdefinierte Zielgruppe. Dies ist eine Liste mit Nutzern 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. Ressourcennamen für benutzerdefinierte Zielgruppen haben das folgende 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 sollte für alle benutzerdefinierten Zielgruppen, die von einem Kunden erstellt werden, eindeutig sein. Dieses Feld ist zum Erstellen von Vorgängen erforderlich.
type

enum (CustomAudienceType)

Typ der benutzerdefinierten Zielgruppe. „INTEREST“ ODER „PURCHASE_INTENT“ ist für neu erstellte benutzerdefinierte Zielgruppen nicht zulässig, wird aber für bestehende Zielgruppen beibehalten.
description

string

Beschreibung dieser benutzerdefinierten Zielgruppe.
members[]

object (CustomAudienceMember)

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

CustomAudienceStatus

Aufzählung mit möglichen Status für benutzerdefinierte Zielgruppen

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 benutzerdefinierte Zielgruppe ist aktiviert und kann für das Targeting verwendet werden.
REMOVED Status „Entfernt“: Die benutzerdefinierte Zielgruppe wurde entfernt und kann nicht für das Targeting verwendet werden.

CustomAudienceType

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

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AUTO In Google Ads wird zum Zeitpunkt der Auslieferung automatisch die beste Interpretation ausgewählt.
INTEREST Gleicht Nutzer anhand ihrer Interessen ab.
PURCHASE_INTENT Findet Nutzer basierend auf Themen, nach denen sie suchen, oder Produkten, die sie kaufen möchten.
SEARCH Gleicht Nutzer anhand ihrer Suchanfragen in der Google Suche ab.

CustomAudienceMember

Ein Mitglied der benutzerdefinierten Zielgruppe. Ein Mitglied kann ein KEYWORD, URL, PLACE_CATEGORY oder 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 benutzerdefinierten Zielgruppenmitglieds: KEYWORD, URL, PLACE_CATEGORY oder APP.
Union-Feld value. Der Wert „CustomAudienceMember“. Ein Feld wird je nach Mitgliedstyp ausgefüllt. Für value ist nur einer der folgenden Werte zulässig:
keyword

string

Ein Keyword oder eine Keyword-Wortgruppe mit höchstens 10 Wörtern und 80 Zeichen. Bei Sprachen mit Zeichen doppelter Breite wie Chinesisch, Japanisch oder Koreanisch sind 40 Zeichen zulässig, die die Interessen oder Aktionen des Nutzers beschreiben.
url

string

Eine HTTP-URL mit enthaltenem Protokoll – maximal 2.048 Zeichen, einschließlich Inhalten, an denen Nutzer interessiert sind
placeCategory

string (int64 format)

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

string

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

CustomAudienceMemberType

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

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
KEYWORD Nutzer, deren Interessen oder Aktionen durch einen Suchbegriff beschrieben werden
URL Nutzer mit Interessen, die sich auf den Inhalt der Website beziehen.
PLACE_CATEGORY Nutzer, die Ortstypen besuchen, die nach einer Ortskategorie beschrieben sind.
APP Nutzer, die eine mobile App installiert haben