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

Solo output. Il nome della risorsa per questa risorsa Audience. Formato: proprietà/{propertyId}/audiences/{audienceId}

string

Obbligatorio. Il nome visualizzato del segmento di pubblico.

string

Obbligatorio. La descrizione del segmento di pubblico.

integer

Obbligatorio. Immutabile. La durata della permanenza di un utente in un segmento di pubblico. Non può essere impostato su più di 540 giorni.

boolean

Solo output. Viene impostato automaticamente da GA su false se si tratta di un segmento di pubblico ANP ed è escluso dalla personalizzazione degli annunci.

object (AudienceEventTrigger)

(Facoltativo) Specifica un evento da registrare quando un utente si unisce al segmento di pubblico. Se il criterio non viene configurato, non viene registrato alcun evento quando un utente entra a far parte del segmento di pubblico.

enum (AudienceExclusionDurationMode)

Immutabile. Specifica la durata di un'esclusione per gli utenti che soddisfano il filtro di esclusione. Viene applicato a tutte le clausole di filtro ESCLUDI e viene ignorato quando nel segmento di pubblico non è presente alcuna clausola di filtro ESCLUDI.

object (AudienceFilterClause)

Obbligatorio. Immutabile. Elenco non ordinato. Clausole di filtro che definiscono il segmento di pubblico. Tutte le clausole saranno unite insieme tramite AND.

string (Timestamp format)

Solo output. Data e ora di creazione del segmento di pubblico.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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

string

Obbligatorio. Il nome dell'evento che verrà registrato.

enum (LogCondition)

Obbligatorio. Quando registrare l'evento.

{
  "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)

Obbligatorio. Specifica se si tratta di una clausola di filtro di inclusione o esclusione.

object (AudienceSimpleFilter)

Un filtro semplice che un utente deve soddisfare per essere membro del segmento di pubblico.

object (AudienceSequenceFilter)

Filtri che devono essere applicati in un ordine specifico affinché l'utente sia membro del segmento di pubblico.

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

enum (AudienceFilterScope)

Obbligatorio. Immutabile. Specifica l'ambito di questo filtro.

object (AudienceFilterExpression)

Obbligatorio. Immutabile. Un'espressione logica dei filtri relativi a dimensione, metrica o eventi relativi al pubblico.

{

  // 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)

Un elenco di espressioni da unire insieme. Può contenere solo AudienceFilterExpressions con orGroup. Deve essere impostato per AudienceFilterExpression di primo livello.

object (AudienceFilterExpressionList)

Un elenco di espressioni da unire con OR. Non può contenere AudienceFilterExpressions con andGroup o orGroup.

object (AudienceFilterExpression)

Un'espressione di filtro da NON modificare (ad esempio, invertita, completata). Può includere solo un valore dimensionOrMetricFilter. Impossibile impostare AudienceFilterExpression di primo livello.

object (AudienceDimensionOrMetricFilter)

Un filtro su una singola dimensione o metrica. Impossibile impostare AudienceFilterExpression di primo livello.

object (AudienceEventFilter)

Crea un filtro che corrisponde a un evento specifico. Impossibile impostare AudienceFilterExpression di primo livello.

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

object (AudienceFilterExpression)

Un elenco di espressioni di filtro per i segmenti di pubblico.

{
  "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

Obbligatorio. Immutabile. Il nome della dimensione o della metrica da filtrare. Se il nome del campo fa riferimento a una dimensione o a una metrica personalizzata, verrà aggiunto un prefisso di ambito all'inizio del nome delle dimensioni o delle metriche personalizzate. Per saperne di più sui prefissi dell'ambito o sulle dimensioni/metriche personalizzate, consulta la documentazione dell'API di dati di Google Analytics.

boolean

(Facoltativo) Indica se questo filtro richiede o meno una valutazione dinamica. Se impostato su true, gli utenti si uniscono al segmento di pubblico se hanno soddisfatto la condizione almeno una volta (valutazione statica). Se il criterio non viene configurato o se viene impostato su false, la valutazione degli utenti per un segmento di pubblico è dinamica. gli utenti vengono aggiunti a un segmento di pubblico quando soddisfano le condizioni e poi rimossi quando non li soddisfano più.

Può essere impostato solo se l'ambito del segmento di pubblico è ACROSS_ALL_SESSIONS.

integer

(Facoltativo) Se impostato, specifica l'intervallo di tempo durante il quale valutare i dati in numero di giorni. Se il criterio non viene configurato, i dati sul pubblico vengono valutati in base ai dati relativi al lifetime dell'utente (ad esempio, una finestra temporale infinita).

Ad esempio, se il valore è impostato su 1 giorno, vengono valutati solo i dati del giorno corrente. Il punto di riferimento è il giorno corrente quando atAnyPointInTime non è impostato o è false.

Può essere impostato solo se l'ambito del segmento di pubblico è ACROSS_ALL_SESSIONS e non può essere superiore a 60 giorni.

object (StringFilter)

Un filtro per una dimensione di tipo stringa corrispondente a un determinato pattern.

object (InListFilter)

Un filtro per una dimensione stringa che corrisponde a un determinato elenco di opzioni.

object (NumericFilter)

Un filtro per i valori numerici o di data in una dimensione o metrica.

object (BetweenFilter)

Un filtro per valori numerici o delle date tra determinati valori in una dimensione o metrica.

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

enum (MatchType)

Obbligatorio. Il tipo di corrispondenza per il filtro stringa.

string

Obbligatorio. Il valore della stringa da abbinare.

boolean

(Facoltativo) Se true, la corrispondenza è sensibile alle maiuscole. Se il valore è false, la corrispondenza non fa distinzione tra maiuscole e minuscole.

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

string

Obbligatorio. L'elenco di possibili valori di stringa con cui creare una corrispondenza. Il campo non può essere vuoto.

boolean

(Facoltativo) Se true, la corrispondenza è sensibile alle maiuscole. Se il valore è false, la corrispondenza non fa distinzione tra maiuscole e minuscole.

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

enum (Operation)

Obbligatorio. L'operazione applicata a un filtro numerico.

object (NumericValue)

Obbligatorio. Il valore numerico o della data da abbinare.

{

  // 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)

Valore intero.

number

Valore doppio.

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

object (NumericValue)

Obbligatorio. Inizia con questo numero incluso.

object (NumericValue)

Obbligatorio. Termina con questo numero incluso.

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

string

Obbligatorio. Immutabile. Il nome dell'evento con cui stabilire una corrispondenza.

object (AudienceFilterExpression)

(Facoltativo) Se specificato, questo filtro associa gli eventi che corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri. Impossibile impostare AudienceEventFilter all'interno dell'espressione di filtro dei parametri (ad esempio, i filtri di eventi nidificati non sono supportati). Deve essere un singolo andGroup di dimensionOrMetricFilter o notExpression; Gli AND degli OR non sono supportati. Inoltre, se include un filtro per "eventCount", verrà preso in considerazione solo questo: tutti gli altri filtri verranno ignorati.

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

enum (AudienceFilterScope)

Obbligatorio. Immutabile. Specifica l'ambito di questo filtro.

string (Duration format)

(Facoltativo) Definisce il periodo di tempo in cui deve verificarsi l'intera sequenza.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

object (AudienceSequenceStep)

Obbligatorio. Una sequenza ordinata di passaggi. Un utente deve completare ogni passaggio per poter unire il filtro sequenza.

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

enum (AudienceFilterScope)

Obbligatorio. Immutabile. Specifica l'ambito di questo passaggio.

boolean

(Facoltativo) Se true, l'evento che soddisfa questo passaggio deve essere l'evento successivo dopo quello che soddisfa l'ultimo passaggio. Se il criterio non viene configurato o se è false, questo passaggio segue indirettamente quello precedente. Ad esempio, potrebbero verificarsi eventi tra il passaggio precedente e questo. Viene ignorato per il primo passaggio.

string (Duration format)

(Facoltativo) Se impostato, questo passaggio deve essere soddisfatto entro il constraintDuration del passaggio precedente (ad esempio, t[i] - t[i-1] <= constraintDuration). Se il criterio non viene configurato, non è previsto alcun requisito di durata (la durata è a tutti gli effetti illimitata). Viene ignorato per il primo passaggio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

object (AudienceFilterExpression)

Obbligatorio. Immutabile. Un'espressione logica dei filtri di dimensione, metrica o evento relativi al pubblico in ogni passaggio.