- Ressource: Zielgruppe
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Vorgang
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- Methoden
Ressource: Zielgruppe
Eine Ressourcennachricht für eine GA4-Zielgruppe.
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 auf mehr als 540 Tage festgelegt werden. |
adsPersonalizationEnabled |
Nur Ausgabe. Er wird von GA automatisch auf „false“ gesetzt, wenn es sich um eine Zielgruppe für NPA handelt und sie 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 AUSSCHLIESSEN-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 beigetreten ist. |
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 |
Sie können 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 schon einmal die Filterklausel erfüllt haben |
AudienceFilterClause
Eine Klausel zum Definieren eines einfachen oder Sequenzfilters. Ein Filter kann inklusiv sein, d. h., Nutzer, die die Filterklausel erfüllen, werden in die Zielgruppe aufgenommen, oder exklusiv. Nutzer, die die Filterklausel erfüllen, werden beispielsweise aus der Zielgruppe ausgeschlossen.
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 angewendet werden müssen, damit der Nutzer Mitglied der Zielgruppe wird. |
AudienceSimpleFilter
Hier ist ein einfacher Filter definiert, den ein Nutzer erfüllen muss, um Mitglied der Zielgruppe zu werden.
JSON-Darstellung |
---|
{ "scope": enum ( |
Felder | |
---|---|
scope |
Erforderlich. Nicht veränderbar. Gibt den Bereich für diesen Filter an. |
filterExpression |
Erforderlich. Nicht veränderbar. Ein logischer Ausdruck für Dimensionen, Messwerte oder Ereignisfilter des Typs „Zielgruppe“. |
AudienceFilterScope
Gibt an, wie Nutzer für den Beitritt zu einer Zielgruppe bewertet werden.
Enums | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
Der 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 die Filterbedingung in einer Sitzung durch ein Ereignis erfüllt ist. |
AudienceFilterExpression
Ein logischer Ausdruck für Dimensionen, Messwerte oder Ereignisfilter des Typs „Zielgruppe“.
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 mit AND verbunden 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 sollen. Er darf keine AudienceFilterExpressions mit andGroup oder orGroup enthalten. |
notExpression |
Ein Filterausdruck, der NICHT verwendet werden soll (z. B. invertiert, komplementiert) Er darf nur einen „dimensionOrMetricFilter“ enthalten. Dies kann nicht auf der obersten Ebene „AudienceFilterExpression“ festgelegt werden. |
dimensionOrMetricFilter |
Ein Filter für eine einzelne Dimension oder einen einzelnen Messwert. Dies kann nicht auf der obersten Ebene „AudienceFilterExpression“ festgelegt werden. |
eventFilter |
Erstellt einen Filter, der einem bestimmten Ereignis entspricht. Dies kann nicht auf der obersten Ebene „AudienceFilterExpression“ festgelegt werden. |
AudienceFilterExpressionList
Eine Liste mit Filterausdrücken für Zielgruppen.
JSON-Darstellung |
---|
{
"filterExpressions": [
{
object ( |
Felder | |
---|---|
filterExpressions[] |
Eine Liste mit Filterausdrücken für Zielgruppen. |
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 Name der Dimension oder des Messwerts, 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 Messwerts ein Präfix für den Umfang hinzugefügt. Weitere Informationen zu Bereichspräfixen oder benutzerdefinierten Dimensionen und Messwerten finden Sie in der Dokumentation zur Google Analytics Data API. |
atAnyPointInTime |
Optional. Gibt an, ob dieser Filter dynamisch ausgewertet werden muss. Wenn die Richtlinie auf „true“ gesetzt ist, werden Nutzer der Zielgruppe hinzugefügt, sobald sie die Bedingung irgendwann einmal 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 unbegrenztes 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. Er kann nur festgelegt werden, wenn der Umfang der Zielgruppe „ACROSS_ALL_SESSIONS“ ist und nicht länger als 60 Tage sein darf. |
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 Dimension vom Typ „String“, die mit einem bestimmten Muster übereinstimmt. |
inListFilter |
Ein Filter für eine Stringdimension, die einer bestimmten Liste von Optionen entspricht. |
numericFilter |
Ein Filter für numerische Werte oder Datumswerte in einer Dimension oder einem Messwert. |
betweenFilter |
Ein Filter für numerische Werte oder Datumswerte zwischen bestimmten Werten einer Dimension oder eines Messwerts. |
StringFilter
Ein Filter für eine Dimension vom Typ „String“, die mit einem bestimmten Muster übereinstimmt.
JSON-Darstellung |
---|
{
"matchType": enum ( |
Felder | |
---|---|
matchType |
Erforderlich. Der Übereinstimmungstyp für den Stringfilter. |
value |
Erforderlich. Stringwert, der abgeglichen werden soll |
caseSensitive |
Optional. Wenn „true“ festgelegt ist, 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 |
Er 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 einer bestimmten Liste von Optionen entspricht.
JSON-Darstellung |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Felder | |
---|---|
values[] |
Erforderlich. Die Liste möglicher Stringwerte für den Abgleich. Darf nicht leer sein. |
caseSensitive |
Optional. Wenn „true“ festgelegt ist, wird zwischen Groß- und Kleinschreibung unterschieden. Bei „false“ wird die Groß-/Kleinschreibung nicht berücksichtigt. |
NumericFilter
Ein Filter für numerische Werte oder Datumswerte in einer Dimension oder einem Messwert.
JSON-Darstellung |
---|
{ "operation": enum ( |
Felder | |
---|---|
operation |
Erforderlich. Der Vorgang, der auf einen numerischen Filter angewendet wird. |
value |
Erforderlich. Der numerische oder Datumswert, der abgeglichen werden soll. |
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
Um eine Zahl darzustellen.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Ein Wert mit 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 dem einzelnen Ereignisnamen als auch den Parameterfilterausdrücken entsprechen, 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 angegeben, ermittelt dieser Filter Ereignisse, die sowohl mit dem einzelnen Ereignisnamen als auch mit den Parameterfilterausdrücken übereinstimmen. „AudienceEventFilter“ innerhalb des Parameterfilterausdrucks kann nicht festgelegt werden. Verschachtelte Ereignisfilter werden beispielsweise nicht unterstützt. Dies sollte eine einzelne andGroup mit „dimensionOrMetricFilter“ oder „notExpression“ sein. UNDs von ORs werden nicht unterstützt. Wenn es einen Filter für „eventCount“ enthält, wird nur dieser berücksichtigt. Alle anderen Filter werden ignoriert. |
AudienceSequenceFilter
Hier werden Filter definiert, 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 Bereich 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 den Sequenzfilter verwenden 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, das diesen Schritt erfüllt, das nächste Ereignis nach dem Ereignis sein, das den letzten Schritt erfüllt. Wenn nicht festgelegt oder „false“, folgt dieser Schritt indirekt 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 für die Dimension „Zielgruppe“, den Messwert oder die 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 |
|
---|---|
|
Archiviert eine Zielgruppe für eine Property. |
|
Eine Zielgruppe wird erstellt. |
|
Suchen Sie nach einer einzelnen Zielgruppe. |
|
Listet Zielgruppen für eine Property auf. |
|
Aktualisiert eine Zielgruppe für eine Property. |