REST Resource: properties.audiences

{
  "name": string,
  "displayName": string,
  "description": string,
  "membershipDurationDays": integer,
  "adsPersonalizationEnabled": boolean,
  "eventTrigger": {
    object (AudienceEventTrigger)
  },
  "exclusionDurationMode": enum (AudienceExclusionDurationMode),
  "filterClauses": [
    {
      object (AudienceFilterClause)
    }
  ],
  "createTime": string
}

string

Tylko dane wyjściowe. Nazwa zasobu związanego z odbiorcami. Format: usługi/{propertyId}/audiences/{audienceId}

string

Wymagane. Wyświetlana nazwa listy odbiorców.

string

Wymagane. Opis listy odbiorców.

integer

Wymagane. Stała. Czas, przez jaki użytkownik powinien pozostawać na liście odbiorców. Nie może być ustawiony na więcej niż 540 dni.

boolean

Tylko dane wyjściowe. Jeśli jest to lista odbiorców niespersonalizowanych i wykluczona z personalizacji reklam, automatycznie ustawia ona wartość „false” (fałsz).

object (AudienceEventTrigger)

Opcjonalnie: Określa zdarzenie do rejestrowania, gdy użytkownik dołączy do listy odbiorców. Jeśli jej nie skonfigurujesz, żadne zdarzenie nie będzie rejestrowane, gdy użytkownik dołączy do listy odbiorców.

enum (AudienceExclusionDurationMode)

Stała. Określa, jak długo ma zastosowanie wykluczenie w przypadku użytkowników spełniających warunki filtra wykluczania. Jest stosowana we wszystkich klauzulach filtra WYKLUCZ i jest ignorowana, gdy w sekcji Odbiorcy nie ma klauzuli WYKLUCZ.

object (AudienceFilterClause)

Wymagane. Stała. Lista nieuporządkowana. Filtruj klauzule definiujące listę odbiorców. Wszystkie klauzule będą połączone operatorem ORAZ.

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia listy odbiorców.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{
  "eventName": string,
  "logCondition": enum (LogCondition)
}

string

Wymagane. Nazwa zdarzenia, która zostanie zarejestrowana.

enum (LogCondition)

Wymagane. Kiedy rejestrować zdarzenie.

{
  "clauseType": enum (AudienceClauseType),

  // Union field filter can be only one of the following:
  "simpleFilter": {
    object (AudienceSimpleFilter)
  },
  "sequenceFilter": {
    object (AudienceSequenceFilter)
  }
  // End of list of possible types for union field filter.
}

enum (AudienceClauseType)

Wymagane. Określa, czy jest to klauzula filtra uwzględniania czy wykluczania.

object (AudienceSimpleFilter)

Prosty filtr, który musi spełniać użytkownik, aby znaleźć się na liście odbiorców.

object (AudienceSequenceFilter)

Filtry, które muszą wystąpić w określonej kolejności, aby użytkownik znalazł się na liście odbiorców.

{
  "scope": enum (AudienceFilterScope),
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

Wymagane. Stała. Określa zakres tego filtra.

object (AudienceFilterExpression)

Wymagane. Stała. Wyrażenie logiczne filtrów wymiarów, danych lub zdarzeń.

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (AudienceFilterExpressionList)
  },
  "orGroup": {
    object (AudienceFilterExpressionList)
  },
  "notExpression": {
    object (AudienceFilterExpression)
  },
  "dimensionOrMetricFilter": {
    object (AudienceDimensionOrMetricFilter)
  },
  "eventFilter": {
    object (AudienceEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (AudienceFilterExpressionList)

Lista wyrażeń, które mają być połączone operatorem ORAZ. Może zawierać tylko wyrażenia AudienceFilterExpressions z parametrem orGroup. Trzeba go ustawić dla parametru AudienceFilterExpression najwyższego poziomu.

object (AudienceFilterExpressionList)

Lista wyrażeń połączonych operatorem LUB. Nie może zawierać wyrażeń AudienceFilterExpressions z parametrami andGroup lub Group.

object (AudienceFilterExpression)

Wyrażenie filtra, które ma być NIEOBSŁUGIWANE (np. odwrócone, uzupełnione). Może zawierać tylko wymiar wymiarOrMetricFilter. Nie można go ustawić na najwyższym poziomie reguły AudienceFilterExpression.

object (AudienceDimensionOrMetricFilter)

Filtrowanie według jednego wymiaru lub jednego rodzaju danych. Nie można go ustawić na najwyższym poziomie reguły AudienceFilterExpression.

object (AudienceEventFilter)

Tworzy filtr, który pasuje do określonego zdarzenia. Nie można go ustawić na najwyższym poziomie reguły AudienceFilterExpression.

{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}

object (AudienceFilterExpression)

Lista wyrażeń filtra odbiorców.

{
  "fieldName": string,
  "atAnyPointInTime": boolean,
  "inAnyNDayPeriod": integer,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

Wymagane. Stała. Nazwa wymiaru lub danych do filtrowania. Jeśli nazwa pola odnosi się do wymiaru niestandardowego lub danych niestandardowych, przed nazwą wymiaru lub danych niestandardowych zostanie dodany prefiks zakresu. Więcej informacji o prefiksach zakresów lub wymiarach/danych niestandardowych znajdziesz w dokumentacji interfejsu Google Analytics Data API.

boolean

Opcjonalnie: Wskazuje, czy filtr wymaga oceny dynamicznej. Jeśli ma wartość Prawda, użytkownicy mogą dołączać do listy odbiorców, jeśli kiedykolwiek spełnili warunek (ocena statyczna). Jeśli zasada jest nieskonfigurowana lub ma wartość Fałsz, ocena użytkowników w przypadku listy odbiorców jest dynamiczna. użytkownicy są dodawani do listy odbiorców, gdy spełniają warunki, a potem usuwani, gdy już ich nie spełniają.

To ustawienie można ustawić tylko wtedy, gdy zakres odbiorców to ACROSS_ALL_SESSIONS.

integer

Opcjonalnie: Jeśli jest ustawiony, określa przedział czasu, dla którego mają być sprawdzane dane w liczbie dni. Jeśli zasada nie jest skonfigurowana, dane o odbiorcach są oceniane na podstawie danych od początku śledzenia (np. nieskończonego przedziału czasu).

Jeśli np. ustawisz wartość 1 dzień, sprawdzane będą tylko dane z bieżącego dnia. Punkt odniesienia to bieżący dzień, w którym parametr atAnyPointInTime ma wartość false (fałsz).

Tę wartość można ustawić tylko wtedy, gdy zakres odbiorców to ACROSS_ALL_SESSIONS i nie może być dłuższy niż 60 dni.

object (StringFilter)

Filtr wymiaru typu ciąg znaków, który pasuje do określonego wzorca.

object (InListFilter)

Filtr wymiaru ciągu znaków, który pasuje do konkretnej listy opcji.

object (NumericFilter)

Filtr wartości liczbowych lub dat w wymiarze lub rodzaju danych.

object (BetweenFilter)

Filtr umożliwiający filtrowanie wartości liczbowych lub dat między określonymi wartościami w wymiarze lub rodzaju danych.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

Wymagane. Typ dopasowania filtra ciągu znaków.

string

Wymagane. Wartość ciągu znaków, która ma zostać dopasowana do dopasowania.

boolean

Opcjonalnie: Jeśli parametr ma wartość prawda, dopasowanie uwzględnia wielkość liter. W przypadku wartości false (fałsz) wielkość liter nie jest rozróżniana.

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

Wymagane. Lista możliwych wartości ciągu znaków do porównania. Pole nie może być puste.

boolean

Opcjonalnie: Jeśli parametr ma wartość prawda, dopasowanie uwzględnia wielkość liter. W przypadku wartości false (fałsz) wielkość liter nie jest rozróżniana.

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

Wymagane. Operacja zastosowana do filtra liczbowego.

object (NumericValue)

Wymagane. Wartość liczbowa lub data na potrzeby dopasowania.

{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}

string (int64 format)

Liczba całkowita.

number

Podwójna wartość.

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

Wymagane. Zaczyna się od tej liczby włącznie.

object (NumericValue)

Wymagane. Kończy się tą liczbą włącznie.

{
  "eventName": string,
  "eventParameterFilterExpression": {
    object (AudienceFilterExpression)
  }
}

string

Wymagane. Stała. Nazwa zdarzenia, które ma być dopasowywane.

object (AudienceFilterExpression)

Opcjonalnie: Jeśli ten filtr zostanie określony, będzie dopasowywać zdarzenia, które pasują zarówno do nazwy pojedynczego zdarzenia, jak i wyrażeń filtra parametrów. Nie można ustawić parametru AudienceEventFilter w wyrażeniu filtra parametrów (np. zagnieżdżone filtry zdarzeń nie są obsługiwane). Powinien to być pojedyncza wartość parametru andGroup elementu dimensionsOrMetricFilter lub notExpression; Operatory I i LUB nie są obsługiwane. Poza tym jeśli zawiera on filtr „eventCount”, tylko on zostanie wzięty pod uwagę. wszystkie pozostałe filtry są ignorowane.

{
  "scope": enum (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}

enum (AudienceFilterScope)

Wymagane. Stała. Określa zakres tego filtra.

string (Duration format)

Opcjonalnie: Określa przedział czasu, w którym musi wystąpić cała sekwencja.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

object (AudienceSequenceStep)

Wymagane. Uporządkowana sekwencja kroków. Aby dołączyć do filtra sekwencji, użytkownik musi wykonać każdy krok.

{
  "scope": enum (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

Wymagane. Stała. Określa zakres tego kroku.

boolean

Opcjonalnie: Jeśli wartość to prawda, zdarzenie, które spełnia warunki do tego kroku, musi być kolejnym zdarzeniem po zdarzeniu spełniającym ostatni krok. Jeśli zasada jest nieskonfigurowana lub ma wartość Fałsz, ten krok pośrednio następuje bezpośrednio po poprzednim kroku. np. między poprzednim a tym krokiem mogą wystąpić zdarzenia. Jest ona ignorowana w pierwszym kroku.

string (Duration format)

Opcjonalnie: Jeśli ten krok jest ustawiony, musi zostać określony w elemencie constraintDuration poprzedniego kroku (na przykład t[i] – t[i-1] <= constraintDuration). Jeśli jej nie skonfigurujesz, nie będzie wymagania dotyczące czasu trwania (jest on w rzeczywistości nieograniczony). Jest ona ignorowana w pierwszym kroku.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

object (AudienceFilterExpression)

Wymagane. Stała. Wyrażenie logiczne filtrów wymiarów, danych lub zdarzeń w każdym kroku.