- Ressource: Zielgruppe
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Vorgang
- NumericValue (Numerischer Wert)
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- Methoden
Ressource: Zielgruppe
Eine Ressourcenmitteilung, die eine GA4-Zielgruppe darstellt.
JSON-Darstellung |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
Felder | |
---|---|
name |
Nur Ausgabe Der Ressourcenname für diese Zielgruppenressource. Format: Properties/{propertyId}/audiences/{audienceId} |
displayName |
Erforderlich. Der Anzeigename der Zielgruppe. |
description |
Erforderlich. Die Beschreibung der Zielgruppe. |
membershipDurationDays |
Erforderlich. Nicht veränderbar. Die Dauer, die ein Nutzer in einer Zielgruppe bleiben soll. Er darf nicht mehr als 540 Tage betragen. |
adsPersonalizationEnabled |
Nur Ausgabe Er wird von GA automatisch auf „false“ gesetzt, wenn es sich um eine NPA-Zielgruppe handelt, die von der Personalisierung von Anzeigen ausgeschlossen ist. |
eventTrigger |
Optional. Gibt ein Ereignis an, das protokolliert werden soll, wenn ein Nutzer der Zielgruppe beitritt. Ist die Richtlinie nicht konfiguriert, wird kein Ereignis protokolliert, wenn ein Nutzer der Zielgruppe beitritt. |
exclusionDurationMode |
Nicht veränderbar. Gibt an, wie lange ein Ausschluss für Nutzer gilt, die den Ausschlussfilter erfüllen. Sie wird auf alle AUSSCHLUSS-Filterklauseln angewendet und ignoriert, wenn in der Zielgruppe keine AUSSCHLUSS-Filterklausel vorhanden ist. |
filterClauses[] |
Erforderlich. Nicht veränderbar. Unsortierte Liste. Filterklauseln, die die Zielgruppe definieren. Alle Klauseln werden durch UND verbunden. |
AudienceEventTrigger
Gibt ein Ereignis an, das protokolliert werden soll, wenn ein Nutzer der Zielgruppe beitritt.
JSON-Darstellung |
---|
{
"eventName": string,
"logCondition": enum ( |
Felder | |
---|---|
eventName |
Erforderlich. Der Name des Ereignisses, das protokolliert wird. |
logCondition |
Erforderlich. Wann das Ereignis protokolliert werden soll. |
LogCondition
Legt fest, wann das Ereignis protokolliert wird.
Enums | |
---|---|
LOG_CONDITION_UNSPECIFIED |
Logbedingung ist nicht angegeben. |
AUDIENCE_JOINED |
Das Ereignis sollte nur protokolliert werden, wenn ein Nutzer beitritt. |
AUDIENCE_MEMBERSHIP_RENEWED |
Das Ereignis sollte immer dann protokolliert werden, wenn die Zielgruppenbedingung erfüllt ist, auch wenn der Nutzer bereits Mitglied der Zielgruppe ist. |
AudienceExclusionDurationMode
Gibt an, wie lange ein Ausschluss für Nutzer gilt, die den Ausschlussfilter erfüllen.
Enums | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
Nicht angegeben. |
EXCLUDE_TEMPORARILY |
Nutzer in bestimmten Zeiträumen aus der Zielgruppe ausschließen, in denen sie die Filterklausel erfüllen |
EXCLUDE_PERMANENTLY |
Nutzer aus der Zielgruppe ausschließen, die die Filterklausel schon einmal erfüllt haben |
AudienceFilterClause
Eine Klausel zum Definieren eines einfachen oder Sequenzfilters. Ein Filter kann einschließend (Nutzer, die die Filterklausel erfüllen, z. B. in die Zielgruppe aufgenommen werden) oder exklusiv (Nutzer, die die Filterklausel erfüllen, von der Zielgruppe ausgeschlossen) sein.
JSON-Darstellung |
---|
{ "clauseType": enum ( |
Felder | |
---|---|
clauseType |
Erforderlich. Gibt an, ob es sich um eine Einschließen- oder Ausschließen-Filterklausel handelt. |
Union-Feld Für |
|
simpleFilter |
Ein einfacher Filter, den ein Nutzer erfüllen muss, um Mitglied der Zielgruppe zu werden. |
sequenceFilter |
Filter, die in einer bestimmten Reihenfolge angezeigt werden müssen, damit der Nutzer Mitglied der Zielgruppe wird. |
AudienceSimpleFilter
Definiert einen einfachen Filter, den ein Nutzer erfüllen muss, um Mitglied der Zielgruppe zu werden.
JSON-Darstellung |
---|
{ "scope": enum ( |
Felder | |
---|---|
scope |
Erforderlich. Nicht veränderbar. Gibt den Umfang für diesen Filter an. |
filterExpression |
Erforderlich. Nicht veränderbar. Ein logischer Ausdruck der Dimension „Zielgruppe“, des Messwerts oder der Ereignisfilter. |
AudienceFilterScope
Gibt an, wie Nutzer für den Beitritt zu einer Zielgruppe bewertet werden.
Enums | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
Bereich ist nicht angegeben. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
Der Nutzer wird der Zielgruppe hinzugefügt, wenn die Filterbedingung innerhalb eines Ereignisses erfüllt ist. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
Der Nutzer wird der Zielgruppe hinzugefügt, wenn die Filterbedingung innerhalb einer Sitzung erfüllt ist. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
Der Nutzer wird der Zielgruppe hinzugefügt, wenn in einer Sitzung die Filterbedingung durch ein Ereignis erfüllt ist. |
AudienceFilterExpression
Ein logischer Ausdruck der Dimension „Zielgruppe“, des Messwerts oder der Ereignisfilter.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld expr . Ausdruck, der auf einen Filter angewendet wird. Für expr ist nur einer der folgenden Werte zulässig: |
|
andGroup |
Eine Liste von Ausdrücken, die durch eine UND-Verbindung verknüpft werden sollen. Er darf nur AudienceFilterExpressions mit orGroup enthalten. Dies muss für die AudienceFilterExpression der obersten Ebene festgelegt werden. |
orGroup |
Eine Liste von Ausdrücken, die mit ODER verbunden werden können. Er darf keine AudienceFilterExpressions mit andGroup oder orGroup enthalten. |
notExpression |
Ein Filterausdruck, der NICHT behandelt werden soll (z. B. invertiert oder komplementiert). Er darf nur einen dimensionOrMetricFilter enthalten. Dies kann nicht auf der obersten Ebene von AudienceFilterExpression festgelegt werden. |
dimensionOrMetricFilter |
Ein Filter für eine einzelne Dimension oder einen einzelnen Messwert. Dies kann nicht auf der obersten Ebene von AudienceFilterExpression festgelegt werden. |
eventFilter |
Erstellt einen Filter, der einem bestimmten Ereignis entspricht. Dies kann nicht auf der obersten Ebene von AudienceFilterExpression festgelegt werden. |
AudienceFilterExpressionList
Eine Liste mit Ausdrücken für Zielgruppenfilter.
JSON-Darstellung |
---|
{
"filterExpressions": [
{
object ( |
Felder | |
---|---|
filterExpressions[] |
Eine Liste mit Ausdrücken für Zielgruppenfilter. |
AudienceDimensionOrMetricFilter
Ein spezifischer Filter für eine einzelne Dimension oder einen einzelnen Messwert.
JSON-Darstellung |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
Felder | |
---|---|
fieldName |
Erforderlich. Nicht veränderbar. Der Dimensions- oder Messwertname, der gefiltert werden soll. Wenn sich der Feldname auf eine benutzerdefinierte Dimension oder einen benutzerdefinierten Messwert bezieht, wird dem Namen der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts ein Präfix vorangestellt. Weitere Informationen zu Bereichspräfixen oder benutzerdefinierten Dimensionen/Messwerten finden Sie in der Dokumentation zur Google Analytics Data API. |
atAnyPointInTime |
Optional. Gibt an, ob dieser Filter dynamisch ausgewertet werden muss oder nicht. Ist die Richtlinie auf „true“ gesetzt, werden Nutzer der Zielgruppe hinzugefügt, wenn sie die Bedingung jemals erfüllt haben (statische Auswertung). Wenn die Richtlinie nicht konfiguriert oder auf „false“ gesetzt ist, ist die Nutzerauswertung für eine Zielgruppe dynamisch. Nutzer werden einer Zielgruppe hinzugefügt, wenn sie die Bedingungen erfüllen, und entfernt, wenn sie sie nicht mehr erfüllen. Dies kann nur festgelegt werden, wenn der Zielgruppenumfang ACROSS_ALL_SESSIONS ist. |
inAnyNDayPeriod |
Optional. Gibt das Zeitfenster an, für das Daten in Tagen ausgewertet werden sollen. Wenn die Richtlinie nicht konfiguriert ist, werden die Zielgruppendaten mit den Lifetime-Daten verglichen (z. B. ein unendliches Zeitfenster). Wenn Sie beispielsweise 1 Tag festlegen, werden nur die Daten des aktuellen Tages ausgewertet. Der Bezugspunkt ist der aktuelle Tag, an dem „atAnyPointInTime“ nicht festgelegt oder „false“ ist. Sie kann nur festgelegt werden, wenn der Umfang der Zielgruppe ACROSS_ALL_SESSIONS ist und darf nicht länger als 60 Tage sein. |
Union-Feld one_filter . Einer der oben genannten Filter. Für one_filter ist nur einer der folgenden Werte zulässig: |
|
stringFilter |
Ein Filter für eine String-Dimension, die einem bestimmten Muster entspricht. |
inListFilter |
Ein Filter für eine Stringdimension, die mit einer bestimmten Liste von Optionen übereinstimmt. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte für eine Dimension oder einen Messwert. |
betweenFilter |
Ein Filter für numerische Werte oder Datumswerte zwischen bestimmten Werten einer Dimension oder eines Messwerts. |
StringFilter
Ein Filter für eine String-Dimension, die einem bestimmten Muster entspricht.
JSON-Darstellung |
---|
{
"matchType": enum ( |
Felder | |
---|---|
matchType |
Erforderlich. Der Übereinstimmungstyp für den Stringfilter. |
value |
Erforderlich. Stringwert, der abgeglichen werden soll |
caseSensitive |
Optional. Bei „true“ wird zwischen Groß- und Kleinschreibung unterschieden. Bei „false“ wird die Groß-/Kleinschreibung nicht berücksichtigt. |
MatchType
Der Übereinstimmungstyp für den Stringfilter.
Enums | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Ohne Angabe |
EXACT |
Genaue Übereinstimmung mit dem Stringwert. |
BEGINS_WITH |
Beginnt mit dem Stringwert. |
ENDS_WITH |
Endet mit dem Stringwert. |
CONTAINS |
Enthält den Stringwert. |
FULL_REGEXP |
Der vollständige reguläre Ausdruck stimmt mit dem Stringwert überein. |
InListFilter
Ein Filter für eine Stringdimension, die mit einer bestimmten Liste von Optionen übereinstimmt.
JSON-Darstellung |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Felder | |
---|---|
values[] |
Erforderlich. Die Liste möglicher Stringwerte für den Abgleich. Darf nicht leer sein. |
caseSensitive |
Optional. Bei „true“ wird zwischen Groß- und Kleinschreibung unterschieden. Bei „false“ wird die Groß-/Kleinschreibung nicht berücksichtigt. |
NumericFilter
Ein Filter für numerische Werte oder Datumswerte für eine Dimension oder einen Messwert.
JSON-Darstellung |
---|
{ "operation": enum ( |
Felder | |
---|---|
operation |
Erforderlich. Der Vorgang, der auf einen numerischen Filter angewendet wird. |
value |
Erforderlich. Der numerische oder Datumswert für den Abgleich. |
Vorgang
Der Vorgang, der auf einen numerischen Filter angewendet wird.
Enums | |
---|---|
OPERATION_UNSPECIFIED |
Nicht angegeben |
EQUAL |
Gleich |
LESS_THAN |
Kleiner als. |
GREATER_THAN |
Größer als. |
NumericValue
Zur Darstellung einer Zahl.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Entspricht einem numerischen Wert. Für one_value ist nur einer der folgenden Werte zulässig: |
|
int64Value |
Ganzzahlwert. |
doubleValue |
Doppelter Wert. |
BetweenFilter
Ein Filter für numerische Werte oder Datumswerte zwischen bestimmten Werten einer Dimension oder eines Messwerts.
JSON-Darstellung |
---|
{ "fromValue": { object ( |
Felder | |
---|---|
fromValue |
Erforderlich. Beginnt mit dieser Zahl (einschließlich) |
toValue |
Erforderlich. Endet mit dieser Zahl (einschließlich). |
AudienceEventFilter
Ein Filter, der Ereignissen eines einzelnen Ereignisnamens entspricht. Wenn ein Ereignisparameter angegeben ist, entspricht nur die Teilmenge der Ereignisse, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen, diesem Ereignisfilter.
JSON-Darstellung |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
Felder | |
---|---|
eventName |
Erforderlich. Nicht veränderbar. Der Name des Ereignisses, das abgeglichen werden soll. |
eventParameterFilterExpression |
Optional. Wenn dieses Flag angegeben ist, sucht dieser Filter nach Ereignissen, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. Im Parameterfilterausdruck kann kein AudienceEventFilter festgelegt werden. Verschachtelte Ereignisfilter werden beispielsweise nicht unterstützt. Dies sollte eine einzelne andGroup mit „dimensionOrMetricFilter“ oder „notExpression“ sein. UNDs von ODERs werden nicht unterstützt. Wenn es außerdem einen Filter für „eventCount“ enthält, wird nur dieser Filter berücksichtigt. Alle anderen Filter werden ignoriert. |
AudienceSequenceFilter
Definiert Filter, die in einer bestimmten Reihenfolge angewendet werden müssen, damit der Nutzer Mitglied der Zielgruppe wird.
JSON-Darstellung |
---|
{ "scope": enum ( |
Felder | |
---|---|
scope |
Erforderlich. Nicht veränderbar. Gibt den Umfang für diesen Filter an. |
sequenceMaximumDuration |
Optional. Definiert den Zeitraum, in dem die gesamte Sequenz auftreten muss. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
sequenceSteps[] |
Erforderlich. Eine geordnete Abfolge von Schritten. Ein Nutzer muss jeden Schritt ausführen, um dem Sequenzfilter beitreten zu können. |
AudienceSequenceStep
Eine Bedingung, die in der angegebenen Schrittreihenfolge eintreten muss, damit der Nutzer der Sequenz entspricht.
JSON-Darstellung |
---|
{ "scope": enum ( |
Felder | |
---|---|
scope |
Erforderlich. Nicht veränderbar. Gibt den Bereich für diesen Schritt an. |
immediatelyFollows |
Optional. Bei „true“ muss das Ereignis, für das dieser Schritt ausgeführt wird, das nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Ist die Richtlinie nicht konfiguriert oder auf „false“ gesetzt, folgt dieser Schritt indirekt nach dem vorherigen Schritt. Es können beispielsweise Ereignisse zwischen dem vorherigen und diesem Schritt auftreten. Er wird im ersten Schritt ignoriert. |
constraintDuration |
Optional. Wenn dieser Schritt festgelegt ist, muss er innerhalb der constraintDuration des vorherigen Schritts erfüllt sein (z. B. t[i] – t[i-1] <= constraintDuration). Wenn die Richtlinie nicht konfiguriert ist, ist keine Dauer erforderlich. Die Dauer ist praktisch unbegrenzt. Er wird im ersten Schritt ignoriert. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
filterExpression |
Erforderlich. Nicht veränderbar. Ein logischer Ausdruck der Dimension „Zielgruppe“, des Messwerts oder der Ereignisfilter in jedem Schritt. |
AudienceClauseType
Gibt an, ob es sich um eine Einschließen- oder Ausschließen-Filterklausel handelt.
Enums | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
Nicht angegebener Klauseltyp. |
INCLUDE |
Nutzer werden in die Zielgruppe aufgenommen, wenn die Filterklausel erfüllt ist. |
EXCLUDE |
Nutzer werden aus der Zielgruppe ausgeschlossen, wenn die Filterklausel erfüllt ist. |
Methoden |
|
---|---|
|
Hiermit wird eine Zielgruppe für eine Property archiviert. |
|
Eine Zielgruppe wird erstellt. |
|
Nach einer einzelnen Zielgruppe suchen. |
|
Listet die Zielgruppen für eine Property auf. |
|
Aktualisiert eine Zielgruppe für eine Property. |