CustomAudience

Eine benutzerdefinierte Zielgruppe Dies ist eine Liste von 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. Er sollte für alle benutzerdefinierten Zielgruppen, die ein Kunde erstellt hat, 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 vorhandene 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 aufgeführt 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 den in dieser Version unbekannten Wert dar.
ENABLED Status „Aktiviert“: Die benutzerdefinierte Zielgruppe ist aktiviert und kann für das Targeting verwendet werden.
REMOVED Status „Entfernt“: Die benutzerdefinierte Zielgruppe wird entfernt und kann nicht für die Ausrichtung verwendet werden.

CustomAudienceType

Aufzählung mit möglichen benutzerdefinierten Zielgruppentypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
AUTO In Google Ads wird zum Zeitpunkt der Auslieferung automatisch die beste Interpretation ausgewählt.
INTEREST Findet Nutzer auf Grundlage ihrer Interessen.
PURCHASE_INTENT Zuordnung von Nutzern nach Themen, nach denen sie suchen, oder nach Produkten, die sie zum Kauf in Betracht ziehen.
SEARCH Findet Nutzer basierend auf ihren Suchanfragen in der Google Suche.

CustomAudienceMember

Ein Mitglied einer benutzerdefinierten Zielgruppe. Ein Mitglied kann ein KEYWORD, URL, PLACE_CATEGORY oder APP sein. Ein Mitglied 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“. Eines der Felder 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 – maximal 10 Wörter und 80 Zeichen In Sprachen mit Zeichen doppelter Breite wie Chinesisch, Japanisch oder Koreanisch sind 40 Zeichen erlaubt, mit denen die Interessen oder Aktionen des Nutzers beschrieben werden.
url

string

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

string (int64 format)

Ortstyp, der durch eine von Nutzern aufgerufene Ortskategorie beschrieben wird
app

string

Ein Paketname von Android-Apps, die Nutzer installiert haben, z. B. com.google.example.

CustomAudienceMemberType

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

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