- Risorsa: pubblico
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Operazione
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- Metodi
Risorsa: pubblico
Un messaggio della risorsa che rappresenta un segmento di pubblico GA4.
Rappresentazione JSON |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
Campi | |
---|---|
name |
Solo output. Il nome di questa risorsa pubblico. Formato: Properties/{propertyId}/audiences/{audienceId} |
displayName |
Obbligatoria. Il nome visualizzato del segmento di pubblico. |
description |
Obbligatoria. La descrizione del segmento di pubblico. |
membershipDurationDays |
Obbligatoria. Immutabile. La durata della permanenza di un utente in un segmento di pubblico. Non può essere impostato su un valore superiore a 540 giorni. |
adsPersonalizationEnabled |
Solo output. Viene impostato automaticamente da GA su false se si tratta di un segmento di pubblico ANP ed è escluso dalla personalizzazione degli annunci. |
eventTrigger |
Campo facoltativo. Specifica un evento da registrare quando un utente entra nel segmento di pubblico. Se non viene configurato, non viene registrato alcun evento quando un utente entra a far parte del segmento di pubblico. |
exclusionDurationMode |
Immutabile. Specifica la durata di un'esclusione per gli utenti che soddisfano il filtro di esclusione. Viene applicato a tutte le clausole di filtro EXCLUDE e viene ignorato quando non è presente alcuna clausola di filtro EXCLUDE nel segmento di pubblico. |
filterClauses[] |
Obbligatoria. Immutabile. Elenco non ordinato. Clausole di filtro che definiscono il segmento di pubblico. Tutte le clausole saranno unite insieme. |
AudienceEventTrigger
Specifica un evento da registrare quando un utente entra nel segmento di pubblico.
Rappresentazione JSON |
---|
{
"eventName": string,
"logCondition": enum ( |
Campi | |
---|---|
eventName |
Obbligatoria. Il nome dell'evento che verrà registrato. |
logCondition |
Obbligatoria. Quando registrare l'evento. |
LogCondition
Determina quando registrare l'evento.
Enum | |
---|---|
LOG_CONDITION_UNSPECIFIED |
Condizione di log non specificata. |
AUDIENCE_JOINED |
L'evento deve essere registrato solo quando un utente partecipa. |
AUDIENCE_MEMBERSHIP_RENEWED |
L'evento deve essere registrato ogni volta che la condizione del segmento di pubblico è soddisfatta, anche se l'utente è già membro del segmento di pubblico. |
AudienceExclusionDurationMode
Specifica la durata di un'esclusione per gli utenti che soddisfano il filtro di esclusione.
Enum | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
Non specificato. |
EXCLUDE_TEMPORARILY |
Escludi gli utenti dal segmento di pubblico durante i periodi in cui soddisfano la clausola del filtro. |
EXCLUDE_PERMANENTLY |
Escludi dal segmento di pubblico gli utenti che hanno soddisfatto la clausola di filtro. |
AudienceFilterClause
Una clausola per definire un filtro semplice o in sequenza. Un filtro può essere inclusivo (ad esempio, gli utenti che soddisfano la clausola di filtro sono inclusi nel segmento di pubblico) o esclusivo (ad esempio, gli utenti che soddisfano la clausola di filtro vengono esclusi dal segmento di pubblico).
Rappresentazione JSON |
---|
{ "clauseType": enum ( |
Campi | |
---|---|
clauseType |
Obbligatoria. Specifica se si tratta di una clausola di filtro di inclusione o esclusione. |
Campo di unione
|
|
simpleFilter |
Un semplice filtro che un utente deve soddisfare per diventare membro del segmento di pubblico. |
sequenceFilter |
Filtri che devono essere applicati in un ordine specifico affinché l'utente diventi membro del segmento di pubblico. |
AudienceSimpleFilter
Definisce un semplice filtro che un utente deve soddisfare per diventare membro del segmento di pubblico.
Rappresentazione JSON |
---|
{ "scope": enum ( |
Campi | |
---|---|
scope |
Obbligatoria. Immutabile. Specifica l'ambito di questo filtro. |
filterExpression |
Obbligatoria. Immutabile. Un'espressione logica di filtri di eventi, metriche o dimensioni Pubblico. |
AudienceFilterScope
Consente di specificare come valutare gli utenti per partecipare a un segmento di pubblico.
Enum | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
L'ambito non è specificato. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
L'utente entra nel segmento di pubblico se la condizione del filtro è soddisfatta in un singolo evento. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
L'utente entra nel segmento di pubblico se la condizione del filtro è soddisfatta in una sessione. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
L'utente entra nel segmento di pubblico se la condizione del filtro è soddisfatta da un evento in una sessione. |
AudienceFilterExpression
Un'espressione logica di filtri di eventi, metriche o dimensioni Pubblico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione expr . L'espressione applicata a un filtro. expr può essere solo uno dei seguenti: |
|
andGroup |
Un elenco di espressioni da unire con una relazione AND. Può contenere solo AudienceFilterExpressions con orGroup. Deve essere impostato per AudienceFilterExpression di primo livello. |
orGroup |
Un elenco di espressioni da combinare con l'operatore OR. Non può contenere AudienceFilterExpressions con andGroup o orGroup. |
notExpression |
Un'espressione di filtro da NOTARE (ad esempio invertito, completato). Può includere solo un valore dimensionOrMetricFilter. Questa opzione non può essere impostata nel livello di primo livello di AudienceFilterExpression. |
dimensionOrMetricFilter |
Un filtro su una singola dimensione o metrica. Questa opzione non può essere impostata nel livello di primo livello di AudienceFilterExpression. |
eventFilter |
Crea un filtro che corrisponde a un evento specifico. Questa opzione non può essere impostata nel livello di primo livello di AudienceFilterExpression. |
AudienceFilterExpressionList
Un elenco di espressioni di filtro del pubblico.
Rappresentazione JSON |
---|
{
"filterExpressions": [
{
object ( |
Campi | |
---|---|
filterExpressions[] |
Un elenco di espressioni di filtro del pubblico. |
AudienceDimensionOrMetricFilter
Un filtro specifico per una singola dimensione o metrica.
Rappresentazione JSON |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
Campi | |
---|---|
fieldName |
Obbligatoria. 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 dell'ambito alla parte anteriore del nome delle dimensioni o della metrica personalizzate. Per saperne di più sui prefissi degli ambiti o sulle dimensioni/metriche personalizzate, consulta la documentazione relativa all'API di dati di Google Analytics. |
atAnyPointInTime |
Campo facoltativo. Indica se questo filtro richiede o meno una valutazione dinamica. Se è impostato su true, gli utenti entrano a far parte del 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 le soddisfano più. Può essere impostato solo quando l'ambito del pubblico è ACROSS_ALL_SESSIONS. |
inAnyNDayPeriod |
Campo facoltativo. Se impostato, specifica la finestra temporale per la valutazione dei dati, espressa in giorni. Se il criterio non viene configurato, i dati sul pubblico vengono valutati in base a dati relativi all'intero lifetime, ad esempio un periodo di tempo infinito. Ad esempio, se è impostata su 1 giorno, vengono valutati solo i dati del giorno corrente. Il punto di riferimento è il giorno corrente in cui atAnyPointInTime non è impostato o è false. Può essere impostato solo quando l'ambito del pubblico è ACROSS_ALL_SESSIONS e non può essere superiore a 60 giorni. |
Campo di unione one_filter . Uno dei filtri precedenti. one_filter può essere solo uno dei seguenti: |
|
stringFilter |
Un filtro per una dimensione di tipo stringa che corrisponde a un determinato pattern. |
inListFilter |
Un filtro per una dimensione stringa che corrisponde a un determinato elenco di opzioni. |
numericFilter |
Un filtro per i valori numerici o di data in una dimensione o una metrica. |
betweenFilter |
Un filtro per i valori numerici o di data tra determinati valori di una dimensione o una metrica. |
StringFilter
Un filtro per una dimensione di tipo stringa che corrisponde a un determinato pattern.
Rappresentazione JSON |
---|
{
"matchType": enum ( |
Campi | |
---|---|
matchType |
Obbligatoria. Il tipo di corrispondenza per il filtro stringa. |
value |
Obbligatoria. Il valore della stringa di cui trovare una corrispondenza. |
caseSensitive |
Campo facoltativo. Se true, la corrispondenza è sensibile alle maiuscole. Se il valore è false, la corrispondenza non fa distinzione tra maiuscole e minuscole. |
MatchType
Il tipo di corrispondenza per il filtro stringa.
Enum | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Non specificato |
EXACT |
Corrispondenza esatta del valore della stringa. |
BEGINS_WITH |
Inizia con il valore stringa. |
ENDS_WITH |
Finisce con il valore stringa. |
CONTAINS |
Contiene il valore della stringa. |
FULL_REGEXP |
L'espressione regolare completa corrisponde al valore della stringa. |
InListFilter
Un filtro per una dimensione stringa che corrisponde a un determinato elenco di opzioni.
Rappresentazione JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Campi | |
---|---|
values[] |
Obbligatoria. L'elenco di possibili valori di stringa con cui effettuare una corrispondenza. Il campo non deve essere vuoto. |
caseSensitive |
Campo facoltativo. Se true, la corrispondenza è sensibile alle maiuscole. Se il valore è false, la corrispondenza non fa distinzione tra maiuscole e minuscole. |
NumericFilter
Un filtro per i valori numerici o di data in una dimensione o una metrica.
Rappresentazione JSON |
---|
{ "operation": enum ( |
Campi | |
---|---|
operation |
Obbligatoria. L'operazione applicata a un filtro numerico. |
value |
Obbligatoria. Il valore numerico o di data da confrontare. |
Operazione
L'operazione applicata a un filtro numerico.
Enum | |
---|---|
OPERATION_UNSPECIFIED |
Non specificato. |
EQUAL |
Uguale. |
LESS_THAN |
Minore di. |
GREATER_THAN |
Maggiore di. |
NumericValue
Per rappresentare un numero.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione one_value . Uno di un valore numerico. one_value può essere solo uno dei seguenti: |
|
int64Value |
Valore intero. |
doubleValue |
Valore doppio. |
BetweenFilter
Un filtro per i valori numerici o di data tra determinati valori di una dimensione o una metrica.
Rappresentazione JSON |
---|
{ "fromValue": { object ( |
Campi | |
---|---|
fromValue |
Obbligatoria. Inizia con questo numero incluso. |
toValue |
Obbligatoria. Termina con questo numero, incluso. |
AudienceEventFilter
Un filtro che associa gli eventi di un singolo nome di evento. Se viene specificato un parametro evento, solo il sottoinsieme di eventi che corrispondono sia al nome del singolo evento sia alle espressioni di filtro dei parametri corrispondono a questo filtro eventi.
Rappresentazione JSON |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
Campi | |
---|---|
eventName |
Obbligatoria. Immutabile. Il nome dell'evento con cui stabilire una corrispondenza. |
eventParameterFilterExpression |
Campo facoltativo. Se specificato, questo filtro crea corrispondenze per 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 del parametro (ad esempio, i filtri di eventi nidificati non sono supportati). Deve essere un singolo andGroup of dimensionOrMetricFilter o notExpression; gli AND di OR non sono supportati. Inoltre, se include un filtro per "eventCount", verrà preso in considerazione solo quello, mentre tutti gli altri filtri verranno ignorati. |
AudienceSequenceFilter
Definisce i filtri che devono essere applicati in un ordine specifico affinché l'utente possa essere membro del segmento di pubblico.
Rappresentazione JSON |
---|
{ "scope": enum ( |
Campi | |
---|---|
scope |
Obbligatoria. Immutabile. Specifica l'ambito di questo filtro. |
sequenceMaximumDuration |
Campo facoltativo. Definisce il periodo di tempo in cui deve verificarsi l'intera sequenza. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
sequenceSteps[] |
Obbligatoria. Una sequenza ordinata di passaggi. Un utente deve completare ogni passaggio per unirsi al filtro della sequenza. |
AudienceSequenceStep
Una condizione che deve verificarsi nell'ordine dei passaggi specificato affinché l'utente corrisponda alla sequenza.
Rappresentazione JSON |
---|
{ "scope": enum ( |
Campi | |
---|---|
scope |
Obbligatoria. Immutabile. Specifica l'ambito di questo passaggio. |
immediatelyFollows |
Campo facoltativo. Se il valore è true, l'evento che soddisfa questo passaggio deve essere l'evento immediatamente successivo che soddisfa l'ultimo passaggio. Se il criterio non viene configurato o se viene impostato su false, questo passaggio segue indirettamente quello precedente; ad esempio, potrebbero verificarsi eventi tra il passaggio precedente e questo. Viene ignorato nel primo passaggio. |
constraintDuration |
Campo facoltativo. Se impostato, questo passaggio deve essere soddisfatto entro il vincoloDurata del passaggio precedente (ad esempio, t[i] - t[i-1] <= vincoloDuration). Se non viene configurato, non è prevista alcuna durata (la durata è effettivamente illimitata). Viene ignorato nel primo passaggio. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
filterExpression |
Obbligatoria. Immutabile. Un'espressione logica di filtri eventi, metriche o dimensioni Pubblico in ogni passaggio. |
AudienceClauseType
Specifica se si tratta di una clausola di filtro di inclusione o esclusione.
Enum | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
Tipo di clausola non specificato. |
INCLUDE |
Gli utenti verranno inclusi nel segmento di pubblico se viene soddisfatta la clausola del filtro. |
EXCLUDE |
Gli utenti verranno esclusi dal segmento di pubblico se viene soddisfatta la clausola del filtro. |
Metodi |
|
---|---|
|
Archivia un segmento di pubblico su una proprietà. |
|
Crea un segmento di pubblico. |
|
Ricerca per un singolo segmento di pubblico. |
|
Elenca i segmenti di pubblico all'interno di una proprietà. |
|
Aggiorna un segmento di pubblico su una proprietà. |