UserList

Eine Nutzerliste. Dies ist eine Liste von Nutzern, auf die ein Kunde ein Targeting vornehmen kann.

JSON-Darstellung
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  },
  "lookalikeUserList": {
    object (LookalikeUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname der Nutzerliste. Ressourcennamen von Nutzerlisten haben das folgende Format:

customers/{customerId}/userLists/{userListId}

membershipStatus

enum (UserListMembershipStatus)

Mitgliedschaftsstatus dieser Nutzerliste. Gibt an, ob eine Nutzerliste offen oder aktiv ist. Nur offene Nutzerlisten können weitere Nutzer aufnehmen und als Ziel dienen.

sizeRangeForDisplay

enum (UserListSizeRange)

Nur Ausgabe Größenbereich, ausgedrückt als Anzahl der Nutzer der Nutzerliste im Google Displaynetzwerk

Dieses Feld ist schreibgeschützt.

type

enum (UserListType)

Nur Ausgabe Der Typ dieser Liste.

Dieses Feld ist schreibgeschützt.

closingReason

enum (UserListClosingReason)

Gibt den Grund an, warum der Mitgliedsstatus dieser Nutzerliste geschlossen ist. Es wird nur für Listen gefüllt, die aufgrund von Inaktivität automatisch geschlossen wurden. Sie wird gelöscht, sobald der Status der Listenmitgliedschaft „Offen“ wird.

accessReason

enum (AccessReason)

Nur Ausgabe Gibt an, warum diesem Konto Zugriff auf die Liste gewährt wurde. Der Grund kann GETEILT, EIGENTUM, LIZENZIERT oder ABONNIERT sein.

Dieses Feld ist schreibgeschützt.

accountUserListStatus

enum (UserListAccessStatus)

Gibt an, ob diese Freigabe noch aktiviert ist. Wenn eine Nutzerliste für den Nutzer freigegeben wird, wird dieses Feld auf AKTIVIERT gesetzt. Später kann der Inhaber der Nutzerliste entscheiden, die Freigabe zurückzuziehen und sie zu DEAKTIVIEREN. Der Standardwert für dieses Feld ist AKTIVIERT.

id

string (int64 format)

Nur Ausgabe Die ID der Nutzerliste.

readOnly

boolean

Nur Ausgabe Mit dieser Option wird angegeben, ob ein Nutzer eine Liste bearbeiten darf. Hängt von der Listeninhaberschaft und vom Listentyp ab. Externe Remarketing-Nutzerlisten können beispielsweise nicht bearbeitet werden.

Dieses Feld ist schreibgeschützt.

name

string

Name dieser Nutzerliste. Je nach accessReason ist der Name der Nutzerliste möglicherweise nicht eindeutig (z. B. accessReason=SHARED)

description

string

Beschreibung dieser Nutzerliste.

integrationCode

string

ID aus einem externen System. Sie wird von Verkäufern auf Nutzerlisten verwendet, um IDs in ihren Systemen in Beziehung zu setzen.

membershipLifeSpan

string (int64 format)

Anzahl der Tage, die ein Nutzer-Cookie seit dem letzten Hinzufügen zur Liste auf der Liste bleibt Der Wert in diesem Feld muss zwischen 0 und 540 liegen. Bei CRM-basierten Nutzerlisten kann das Feld jedoch auf 10.000 gesetzt werden, sodass es kein Ablaufdatum gibt.

Dieses Feld wird für die Typen „logicalBenutzerliste“ und „ruleBased Spieler“ ignoriert. Die Zugehörigkeit zu Listen dieser Typen hängt von den durch die Listen definierten Regeln ab.

sizeForDisplay

string (int64 format)

Nur Ausgabe Geschätzte Anzahl der Nutzer in dieser Nutzerliste im Google Displaynetzwerk Dieser Wert ist null, wenn die Anzahl der Nutzer noch nicht ermittelt wurde.

Dieses Feld ist schreibgeschützt.

eligibleForDisplay

boolean

Nur Ausgabe Gibt an, dass diese Nutzerliste für das Google Displaynetzwerk aktiviert ist.

Dieses Feld ist schreibgeschützt.

matchRatePercentage

integer

Nur Ausgabe Gibt die Abgleichsrate für Listen zum Kundenabgleich an. Der Bereich dieses Felds ist [0-100]. Bei anderen Listentypen oder wenn die Abgleichsrate nicht berechnet werden kann, ist dieser Wert null.

Dieses Feld ist schreibgeschützt.

Union-Feld user_list. Die Nutzerliste.

Es muss genau eins festgelegt werden. Für user_list ist nur einer der folgenden Werte zulässig:

crmBasedUserList

object (CrmBasedUserListInfo)

Nutzerliste mit CRM-Nutzern, die vom Werbetreibenden bereitgestellt wurde

similarUserList

object (SimilarUserListInfo)

Nur Ausgabe Nutzerlisten, die Nutzern aus einer anderen Nutzerliste ähneln. Diese Listen sind schreibgeschützt und werden von Google automatisch erstellt.

ruleBasedUserList

object (RuleBasedUserListInfo)

Nutzerliste, die durch eine Regel generiert wurde.

logicalUserList

object (LogicalUserListInfo)

Eine Nutzerliste, die eine benutzerdefinierte Kombination aus Nutzerlisten und Nutzerinteressen darstellt.

basicUserList

object (BasicUserListInfo)

Nutzerlisten-Targeting als Sammlung von Conversion- oder Remarketing-Aktionen.

lookalikeUserList

object (LookalikeUserListInfo)

Nicht veränderbar. Lookalike User List (Ähnliche Nutzerliste).

UserListMembershipStatus

Enum-Wert, der die möglichen Mitgliedschaftsstatus der Nutzerliste enthält.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
OPEN Status „Offen“: Die Liste nimmt Mitglieder auf und kann als Zielgruppe ausgewählt werden.
CLOSED Geschlossener Status: Es können keine neuen Mitglieder hinzugefügt werden. Kann nicht für das Targeting verwendet werden.

UserListSizeRange

Enum-Wert, der mögliche Größenbereiche der Nutzerliste enthält.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LESS_THAN_FIVE_HUNDRED Die Nutzerliste enthält weniger als 500 Nutzer.
LESS_THAN_ONE_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer zwischen 500 und 1.000.
ONE_THOUSAND_TO_TEN_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer zwischen 1.000 und 10.000.
TEN_THOUSAND_TO_FIFTY_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer zwischen 10.000 und 50.000.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer zwischen 50.000 und 100.000.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer zwischen 100.000 und 300.000.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND Die Nutzerliste enthält die Anzahl der Nutzer im Bereich von 300.000 bis 500.000.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION Die Nutzerliste enthält Nutzer im Bereich von 500.000 bis 1 Million.
ONE_MILLION_TO_TWO_MILLION Die Nutzerliste enthält Nutzer im Bereich von 1 bis 2 Millionen.
TWO_MILLION_TO_THREE_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 2 und 3 Millionen.
THREE_MILLION_TO_FIVE_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 3 und 5 Millionen.
FIVE_MILLION_TO_TEN_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 5 und 10 Millionen.
TEN_MILLION_TO_TWENTY_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 10 und 20 Millionen.
TWENTY_MILLION_TO_THIRTY_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 20 und 30 Millionen.
THIRTY_MILLION_TO_FIFTY_MILLION Die Nutzerliste enthält Nutzer im Bereich zwischen 30 und 50 Millionen.
OVER_FIFTY_MILLION Die Nutzerliste umfasst mehr als 50 Millionen Nutzer.

UserListType

Enum mit möglichen Nutzerlistentypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
REMARKETING Als Sammlung von Conversion-Typen dargestellte Nutzerliste
LOGICAL Als Kombination anderer Nutzerlisten/-interessen dargestellte Nutzerlisten
EXTERNAL_REMARKETING Auf der Google Ad Manager-Plattform erstellte Nutzerliste
RULE_BASED Nutzerliste, die einer Regel zugeordnet ist
SIMILAR Nutzerliste mit Nutzern, die denen einer anderen Nutzerliste ähnlich sind
CRM_BASED Eine Nutzerliste mit eigenen CRM-Daten, die vom Werbetreibenden in Form von E-Mails oder anderen Formaten bereitgestellt wurde.
LOOKALIKE LookalikeUserlist, bestehend aus Nutzern, die denen eines konfigurierbaren Startwerts ähneln (Satz von Nutzerlisten)

UserListClosingReason

Aufzählung, die mögliche Gründe für das Schließen von Nutzerlisten beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
UNUSED Die Nutzerliste wurde geschlossen, weil sie länger als ein Jahr nicht verwendet wurde.

AccessReason

Aufzählung zur Beschreibung möglicher Gründe für den Zugriff

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
OWNED Die Ressource ist Eigentum des Nutzers.
SHARED Die Ressource wird für den Nutzer freigegeben.
LICENSED Die Ressource ist für den Nutzer lizenziert.
SUBSCRIBED Der Nutzer hat die Ressource abonniert.
AFFILIATED Die Ressource ist für den Nutzer zugänglich.

UserListAccessStatus

Enum-Wert, der die möglichen Zugriffsstatus für Nutzerlisten enthält.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Der Zugriff ist aktiviert.
DISABLED Der Zugriff ist deaktiviert.

CrmBasedUserListInfo

Vom Werbetreibenden bereitgestellte Nutzerliste mit CRM-Nutzern

JSON-Darstellung
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
Felder
uploadKeyType

enum (CustomerMatchUploadKeyType)

Übereinstimmender Schlüsseltyp der Liste. Gemischte Datentypen sind in derselben Liste nicht zulässig. Dieses Feld ist für einen ADD-Vorgang erforderlich.

dataSourceType

enum (UserListCrmDataSourceType)

Datenquelle der Liste. Der Standardwert ist FIRST_PARTY. Nur Kunden auf der Zulassungsliste können CRM-Listen von Drittanbietern erstellen.

appId

string

Ein String, der eine mobile App, aus der die Daten gesammelt wurden, eindeutig identifiziert. Für iOS ist der ID-String der 9-stellige String, der am Ende einer App Store-URL angezeigt wird. Beispiel: „476943146“ für „Flood-It! 2", deren App Store-Link http://itunes.apple.com/us/app/flood-it!-2/id476943146) lautet. Bei Android ist der ID-String der Paketname der App (z. B. „com.labpixies.colordrips“ für „Color Drips“ über den Google Play-Link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Erforderlich beim Erstellen von CrmBasedsprich, um mobile Werbe-IDs hochzuladen.

CustomerMatchUploadKeyType

Aufzählung zur Beschreibung möglicher Upload-Schlüsseltypen für den Kundenabgleich

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CONTACT_INFO Mitglieder werden anhand von Kundendaten wie E-Mail-Adresse, Telefonnummer oder Postanschrift abgeglichen.
CRM_ID Die Mitglieder werden anhand einer vom Werbetreibenden generierten und zugewiesenen User-ID abgeglichen.
MOBILE_ADVERTISING_ID Die Mitglieder werden anhand der IDs für mobile Werbung abgeglichen.

UserListCrmDataSourceType

Aufzählung, die einen möglichen CRM-Datenquellentyp für Nutzerlisten beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
FIRST_PARTY Bei den hochgeladenen Daten handelt es sich um selbst erhobene Daten.
THIRD_PARTY_CREDIT_BUREAU Die hochgeladenen Daten stammen von einem externen Kreditbüro.
THIRD_PARTY_VOTER_FILE Die hochgeladenen Daten stammen aus der Wählerdatei eines Drittanbieters.

SimilarUserListInfo

ähnliche Nutzerliste ist eine Liste mit Nutzern, die denen aus einer anderen Nutzerliste ähnlich sind. Diese Listen sind schreibgeschützt und werden von Google automatisch erstellt.

JSON-Darstellung
{
  "seedUserList": string
}
Felder
seedUserList

string

Quell-Nutzerliste, von der diese Liste abgeleitet ist

RuleBasedUserListInfo

Darstellung einer Nutzerliste, die durch eine Regel generiert wird.

JSON-Darstellung
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
Felder
prepopulationStatus

enum (UserListPrepopulationStatus)

Status der Vorabausfüllung Wenn nichts festgelegt ist, ist das Feld standardmäßig auf NONE gesetzt. Das bedeutet, dass vorherige Nutzer nicht berücksichtigt werden. Wenn die Richtlinie auf REQUESTED festgelegt ist, werden frühere Websitebesucher oder App-Nutzer, die der Listendefinition entsprechen, in die Liste aufgenommen (funktioniert nur im Displaynetzwerk). Dabei werden nur Nutzer der letzten 30 Tage hinzugefügt. Dies ist abhängig von der Gültigkeitsdauer der Liste und dem Datum, an dem das Remarketing-Tag hinzugefügt wurde. Der Status wird in FINISHED aktualisiert, sobald die Anfrage verarbeitet wurde, oder auf FAILED, wenn die Anfrage fehlschlägt.

flexibleRuleUserList

object (FlexibleRuleUserListInfo)

Darstellung von Besuchern mit einer oder mehreren Aktionen durch flexible Regel Die flexible Nutzerliste wird durch zwei Listen mit Operanden definiert: inclusiveOperands und exklusiveOperands. Jeder Operand steht für eine Gruppe von Nutzern, die auf Aktionen basieren, die diese in einem bestimmten Zeitraum ausgeführt haben. Diese Operandenlisten werden mit dem Operator AND_NOT kombiniert, sodass Nutzer, die durch die einschließenden Operanden dargestellt werden, in die Nutzerliste aufgenommen werden, abzüglich der Nutzer, die durch die exklusiven Operanden dargestellt werden.

UserListPrepopulationStatus

Aufzählung zur Beschreibung des möglichen Status der Vorabausfüllung von Nutzerlisten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
REQUESTED Die Vorabausfüllung wird angefordert.
FINISHED Die Vorabausfüllung ist abgeschlossen.
FAILED Fehler beim Vorabausfüllen.

FlexibleRuleUserListInfo

Darstellung von Besuchern mit einer oder mehreren Aktionen durch flexible Regel Die flexible Nutzerliste wird durch zwei Listen mit Operanden definiert: inclusiveOperands und exklusiveOperands. Jeder Operand steht für eine Gruppe von Nutzern, die auf Aktionen basieren, die diese in einem bestimmten Zeitraum ausgeführt haben. Diese Operandenlisten werden mit dem Operator AND_NOT kombiniert, sodass Nutzer, die durch die einschließenden Operanden dargestellt werden, in die Nutzerliste aufgenommen werden, abzüglich der Nutzer, die durch die exklusiven Operanden dargestellt werden.

JSON-Darstellung
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
Felder
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

Operator, der definiert, wie die einschließenden Operanden kombiniert werden.

inclusiveOperands[]

object (FlexibleRuleOperandInfo)

Regeln für Nutzer, die in die Nutzerliste aufgenommen werden sollen. Diese befinden sich auf der linken Seite des AND_NOT-Operators und werden durch den Operator „inclusiveRuleOperator“ entweder mit AND/OR verbunden.

exclusiveOperands[]

object (FlexibleRuleOperandInfo)

Regeln für Nutzer, die von der Nutzerliste ausgeschlossen werden sollen. Diese befinden sich auf der rechten Seite des AND_NOT-Operators und werden durch OR miteinander verbunden.

UserListFlexibleRuleOperator

Aufzählung, die mögliche kombinierte Regeloperatoren für Nutzerlisten beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AND A UND B.
OR A ODER B.

FlexibleRuleOperandInfo

Flexible Regel, die die allgemeine Regel und ein Lookback-Window umschließt.

JSON-Darstellung
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
Felder
rule

object (UserListRuleInfo)

Liste der Regelelementgruppen, die diese Regel definieren. Regelelementgruppen werden gruppiert.

lookbackWindowDays

string (int64 format)

Lookback-Window für diese Regel in Tagen Von jetzt bis vor X Tagen.

UserListRuleInfo

Eine benutzerdefinierte Regel, die auf benutzerdefinierten Parametern basiert, die von Websites gesendet oder vom Werbetreibenden hochgeladen wurden.

JSON-Darstellung
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
Felder
ruleType

enum (UserListRuleType)

Anhand des Regeltyps wird festgelegt, wie Regelelemente gruppiert werden.

Die Standardeinstellung ist ODER aus AND (disjunktive Normalform). Das heißt, Regelelemente werden innerhalb von Regelelementgruppen mit UND verbunden und die Gruppen selbst werden mit OR verbunden.

Der Typ „OR“ mit UND ist der einzige unterstützte Typ für die FlexibleRuleRule.

ruleItemGroups[]

object (UserListRuleItemGroupInfo)

Liste der Regelelementgruppen, die diese Regel definieren. Regelelementgruppen werden basierend auf dem Regeltyp gruppiert.

UserListRuleType

Aufzählung, die mögliche Nutzerlistenregeltypen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AND_OF_ORS Konjunktive Normalform.
OR_OF_ANDS Disjunktive Normalform.

UserListRuleItemGroupInfo

Eine Gruppe von Regelelementen.

JSON-Darstellung
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
Felder
ruleItems[]

object (UserListRuleItemInfo)

Regelelemente, die anhand des Regeltyps gruppiert werden.

UserListRuleItemInfo

Ein atomares Regelelement.

JSON-Darstellung
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
Felder
name

string

Name der Regelvariablen. Er sollte dem entsprechenden Schlüsselnamen entsprechen, der vom Pixel ausgelöst wird. Ein Name muss mit US-ASCII-Buchstaben oder Unterstrich oder UTF8-Code größer als 127 beginnen und aus US-ASCII-Buchstaben oder -Ziffern oder Unterstrichen oder UTF8-Code größer als 127 bestehen. Für Websites gibt es zwei integrierte Variablen-URLs (name = 'url__') und Referrer-URL (name = 'ref_url__'). Dieses Feld muss ausgefüllt werden, wenn ein neues Regelelement erstellt wird.

Union-Feld rule_item. Ein atomares Regelelement. Für rule_item ist nur einer der folgenden Werte zulässig:
numberRuleItem

object (UserListNumberRuleItemInfo)

Ein atomares Regelelement, das aus einer Zahlenoperation besteht.

stringRuleItem

object (UserListStringRuleItemInfo)

Ein atomares Regelelement, das aus einem Stringvorgang besteht.

dateRuleItem

object (UserListDateRuleItemInfo)

Ein atomares Regelelement, das aus einem Datumsvorgang besteht.

UserListNumberRuleItemInfo

Ein Regelelement, das aus einer Zahlenoperation besteht.

JSON-Darstellung
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
Felder
operator

enum (UserListNumberRuleItemOperator)

Zahlenvergleichsoperator. Dieses Feld ist erforderlich und muss ausgefüllt werden, wenn ein neues Nummernregelelement erstellt wird.

value

number

Zahlenwert, der mit der Variablen verglichen werden soll. Dieses Feld ist erforderlich und muss ausgefüllt werden, wenn ein neues Nummernregelelement erstellt wird.

UserListNumberRuleItemOperator

Aufzählung, die mögliche Operatoren für Regelelemente von Nutzerlistennummern beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
GREATER_THAN Größer als.
GREATER_THAN_OR_EQUAL Größer als oder gleich.
EQUALS Ist gleich
NOT_EQUALS Ungleich
LESS_THAN Kleiner als.
LESS_THAN_OR_EQUAL Kleiner als oder gleich.

UserListStringRuleItemInfo

Ein Regelelement, das aus einer Zeichenfolgenoperation besteht.

JSON-Darstellung
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
Felder
operator

enum (UserListStringRuleItemOperator)

Stringvergleichsoperator. Dieses Feld ist erforderlich und muss ausgefüllt werden, wenn ein neues Stringregelelement erstellt wird.

value

string

Rechts neben dem Stringregelelement. Für URLs oder Verweis-URLs darf der Wert keine unzulässigen URL-Zeichen wie Zeilenumbrüche, Anführungszeichen, Tabulatoren oder Klammern enthalten. Dieses Feld ist erforderlich und muss ausgefüllt werden, wenn ein neues Stringregelelement erstellt wird.

UserListStringRuleItemOperator

Aufzählung zur Beschreibung möglicher Operatoren für String-Regelelemente von Nutzerlisten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CONTAINS Enthält.
EQUALS Ist gleich
STARTS_WITH Beginnt mit.
ENDS_WITH Endet mit.
NOT_EQUALS Ungleich
NOT_CONTAINS Enthält nicht.
NOT_STARTS_WITH Beginnt nicht mit.
NOT_ENDS_WITH Endet nicht mit.

UserListDateRuleItemInfo

Ein Regelelement, das aus einem Datumsvorgang besteht.

JSON-Darstellung
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
Felder
operator

enum (UserListDateRuleItemOperator)

Operator für Datumsvergleich Dieses Feld ist erforderlich und muss ausgefüllt werden, wenn ein neues Datumsregelelement erstellt wird.

value

string

String, der den Datumswert darstellt, der mit der Regelvariablen verglichen werden soll. Das unterstützte Datumsformat ist JJJJ-MM-TT. Die Zeiten werden in der Zeitzone des Kunden angegeben.

offsetInDays

string (int64 format)

Der relative Datumswert auf der rechten Seite, angegeben durch die Anzahl der Tage, die ab jetzt verschoben sind. Sind beide Felder vorhanden, wird sie mit dem Wertfeld überschrieben.

UserListDateRuleItemOperator

Aufzählung zur Beschreibung möglicher Operatoren für Datumsregeln für Nutzerlisten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
EQUALS Ist gleich
NOT_EQUALS Ist nicht gleich.
BEFORE Vorher.
AFTER Nachher.

LogicalUserListInfo

Eine Nutzerliste, die eine benutzerdefinierte Kombination von Nutzerlisten ist.

JSON-Darstellung
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
Felder
rules[]

object (UserListLogicalRuleInfo)

Logische Listenregeln, die diese Nutzerliste definieren. Die Regeln bestehen aus einem logischen Operator (ALL/ANY/NONE) und einer Liste mit Nutzerlisten. Alle Regeln werden bei ihrer Auswertung mit UND verbunden.

Erforderlich zum Erstellen einer logischen Nutzerliste.

UserListLogicalRuleInfo

Logische Regel einer Nutzerliste. Eine Regel hat einen logischen Operator (und/oder/nicht) und eine Liste von Nutzerlisten als Operanden.

JSON-Darstellung
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
Felder
operator

enum (UserListLogicalRuleOperator)

Der logische Operator der Regel.

ruleOperands[]

object (LogicalUserListOperandInfo)

Die Liste der Operanden der Regel.

UserListLogicalRuleOperator

Aufzählung zur Beschreibung möglicher Operatoren für logische Nutzerlistenregeln.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ALL Und: alle Operanden
ANY Oder: mindestens einer der Operanden
NONE Not: keiner der Operanden

LogicalUserListOperandInfo

Operand der logischen Nutzerliste, die aus einer Nutzerliste besteht

JSON-Darstellung
{
  "userList": string
}
Felder
userList

string

Ressourcenname einer Nutzerliste als Operand.

BasicUserListInfo

Nutzerlisten-Targeting als Sammlung von Conversions oder Remarketing-Aktionen.

JSON-Darstellung
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
Felder
actions[]

object (UserListActionInfo)

Mit dieser Nutzerliste verknüpfte Aktionen.

UserListActionInfo

Ein Aktionstyp, der zum Erstellen von Remarketing-Nutzerlisten verwendet wird

JSON-Darstellung
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
Felder
Union-Feld user_list_action. Subtypen von Nutzerlistenaktionen. Für user_list_action ist nur einer der folgenden Werte zulässig:
conversionAction

string

Eine Conversion-Aktion, die nicht durch Remarketing generiert wurde.

remarketingAction

string

Eine Remarketing-Aktion.

LookalikeUserListInfo

LookalikeUserlist, bestehend aus Nutzern, die denen eines konfigurierbaren Startwerts ähneln (Satz von Nutzerlisten)

JSON-Darstellung
{
  "seedUserListIds": [
    string
  ],
  "expansionLevel": enum (LookalikeExpansionLevel),
  "countryCodes": [
    string
  ]
}
Felder
seedUserListIds[]

string (int64 format)

Die ID der Quellnutzerliste, von der die Liste abgeleitet wurde, die vom Nutzer bereitgestellt wurde.

expansionLevel

enum (LookalikeExpansionLevel)

Ausweitungsstufe, d. h. die Größe der ähnlichen Zielgruppe

countryCodes[]

string

Länder, auf die sich das ähnliche Element bezieht. Ländercode mit zwei Buchstaben gemäß ISO-3166-Definition

LookalikeExpansionLevel

Ausweitungsstufe, d. h. die Größe der ähnlichen Zielgruppe

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Ungültige Ausweitungsstufe.
NARROW Erweiterung auf eine kleine Gruppe von Nutzern, die den Quelllisten ähneln
BALANCED Erweiterung auf eine mittlere Gruppe von Nutzern, die den Quelllisten ähneln. Umfasst alle Nutzer von EXPANSION_LEVEL_NARROW und weiteren Nutzern.
BROAD Erweiterung auf eine große Gruppe von Nutzern, die den Quelllisten ähneln. Umfasst alle Nutzer von EXPANSION_LEVEL_BALANCED und mehr.