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

Uniquement en sortie. Nom de ressource de cette ressource d'audience. Format: Properties/{propertyId}/audiences/{audienceId}

string

Obligatoire. Nom à afficher de l'audience.

string

Obligatoire. Description de l'audience.

integer

Obligatoire. Immuable. Durée pendant laquelle un utilisateur doit rester dans une audience. Il ne peut pas être supérieur à 540 jours.

boolean

Uniquement en sortie. GA est automatiquement défini sur "False" s'il s'agit d'une audience ANP et exclue de la personnalisation des annonces.

object (AudienceEventTrigger)

Facultatif. Spécifie un événement à enregistrer lorsqu'un utilisateur rejoint l'audience. Si cette règle n'est pas configurée, aucun événement n'est enregistré lorsqu'un utilisateur rejoint l'audience.

enum (AudienceExclusionDurationMode)

Immuable. Indique la durée d'une exclusion pour les utilisateurs correspondant au filtre d'exclusion. Elle est appliquée à toutes les clauses de filtre EXCLUDE et est ignorée en l'absence de clause de filtre EXCLUDE dans l'audience.

object (AudienceFilterClause)

Obligatoire. Immuable. Liste à puces. Les clauses de filtre définissant l'audience. Toutes les clauses sont reliées par l'opérateur AND (ET).

string (Timestamp format)

Uniquement en sortie. Heure à laquelle l'audience a été créée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

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

string

Obligatoire. Nom de l'événement qui sera consigné.

enum (LogCondition)

Obligatoire. Quand l'événement doit-il être consigné ?

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

Obligatoire. Indique s'il s'agit d'une clause de filtre "Inclure" ou "Exclure".

object (AudienceSimpleFilter)

Filtre simple qu'un utilisateur doit remplir pour être membre de l'audience.

object (AudienceSequenceFilter)

Filtres devant être activés dans un ordre spécifique pour que l'utilisateur soit membre de l'audience.

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

enum (AudienceFilterScope)

Obligatoire. Immuable. Spécifie la portée de ce filtre.

object (AudienceFilterExpression)

Obligatoire. Immuable. Expression logique des filtres de dimension, de métrique ou d'événement d'audience.

{

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

Liste d'expressions à associer avec l'opérateur AND. Il ne peut contenir que des expressions "AudienceFilterExpressions" associées à la valeur "orGroup". Cette valeur doit être définie pour l'AudienceFilterExpression de premier niveau.

object (AudienceFilterExpressionList)

Liste d'expressions à associer avec l'opérateur OR. Il ne peut pas contenir d'AudienceFilterExpressions avec andGroup ou orGroup.

object (AudienceFilterExpression)

Expression de filtre à exclure (par exemple, inversée ou complétée). Il ne peut inclure qu'un élément dimensionOrMetricFilter. Impossible de définir ce paramètre au niveau supérieur de l'AudienceFilterExpression.

object (AudienceDimensionOrMetricFilter)

Filtre sur une seule dimension ou métrique. Impossible de définir ce paramètre au niveau supérieur de l'AudienceFilterExpression.

object (AudienceEventFilter)

Crée un filtre qui correspond à un événement spécifique. Impossible de définir ce paramètre au niveau supérieur de l'AudienceFilterExpression.

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

object (AudienceFilterExpression)

Liste d'expressions de filtre d'audience.

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

Obligatoire. Immuable. Nom de la dimension ou de la métrique à filtrer. Si le nom du champ fait référence à une dimension ou à une métrique personnalisée, un préfixe de champ d'application sera ajouté au début du nom de la métrique ou de la dimension personnalisée. Pour en savoir plus sur les préfixes de champ d'application ou les dimensions/métriques personnalisées, consultez la documentation de l'API Google Analytics Data.

boolean

Facultatif. Indique si ce filtre nécessite une évaluation dynamique ou non. Si elle est définie sur "True", les utilisateurs rejoignent l'audience s'ils ont déjà rempli la condition (évaluation statique). Si cette règle n'est pas configurée ou si elle est définie sur "false", l'évaluation par l'utilisateur pour une audience est dynamique. Les utilisateurs sont ajoutés à une audience lorsqu'ils remplissent les conditions, puis supprimés lorsqu'ils ne les remplissent plus.

Ce paramètre ne peut être défini que si la portée de l'audience est ACROSS_ALL_SESSIONS.

integer

Facultatif. Si cet indicateur est défini, il spécifie la période pour laquelle évaluer les données en nombre de jours. Si cette règle n'est pas configurée, les données d'audience sont évaluées par rapport aux données sur la durée de vie (par exemple, une période infinie).

Par exemple, si la valeur est définie sur "1 jour", seules les données du jour sont prises en compte. Le point de référence est le jour en cours lorsque "atAnyPointInTime" n'est pas défini ou est défini sur "false".

Il ne peut être défini que si la portée de l'audience est ACROSS_ALL_SESSIONS et ne peut pas être supérieure à 60 jours.

object (StringFilter)

Filtre pour une dimension de type chaîne correspondant à un modèle particulier.

object (InListFilter)

Filtre pour une dimension de chaîne qui correspond à une liste d'options spécifique.

object (NumericFilter)

Filtre pour les valeurs numériques ou de date sur une dimension ou une métrique.

object (BetweenFilter)

Filtre pour les valeurs numériques ou de date entre certaines valeurs d'une dimension ou d'une métrique.

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

enum (MatchType)

Obligatoire. Type de correspondance du filtre de chaîne.

string

Obligatoire. Valeur de chaîne à mettre en correspondance.

boolean

Facultatif. Si la valeur est "true", la correspondance est sensible à la casse. Si la valeur est "false", la correspondance n'est pas sensible à la casse.

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

string

Obligatoire. Liste des valeurs de chaîne possibles à mettre en correspondance. Ce champ ne doit pas être vide.

boolean

Facultatif. Si la valeur est "true", la correspondance est sensible à la casse. Si la valeur est "false", la correspondance n'est pas sensible à la casse.

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

enum (Operation)

Obligatoire. Opération appliquée à un filtre numérique.

object (NumericValue)

Obligatoire. Valeur numérique ou de date à mettre en correspondance.

{

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

Valeur de nombre entier ("int").

number

Valeur double.

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

object (NumericValue)

Obligatoire. Commence par ce nombre, inclus.

object (NumericValue)

Obligatoire. Se termine par ce nombre, inclus.

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

string

Obligatoire. Immuable. Nom de l'événement à mettre en correspondance.

object (AudienceFilterExpression)

Facultatif. S'il est spécifié, ce filtre établit une correspondance avec les événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre des paramètres. Impossible de définir AudienceEventFilter dans l'expression de filtre de paramètre (par exemple, les filtres d'événement imbriqués ne sont pas acceptés). Il doit s'agir d'un seul andGroup de dimensionOrMetricFilter ou notExpression; Les opérateurs AND ou OR ne sont pas pris en charge. De plus, s'il inclut un filtre "eventCount", celui-ci uniquement sera pris en compte. tous les autres filtres sont ignorés.

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

enum (AudienceFilterScope)

Obligatoire. Immuable. Spécifie la portée de ce filtre.

string (Duration format)

Facultatif. Définit la période au cours de laquelle toute la séquence doit se produire.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

object (AudienceSequenceStep)

Obligatoire. Séquence ordonnée d'étapes. Un utilisateur doit terminer chaque étape pour rejoindre le filtre de séquence.

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

enum (AudienceFilterScope)

Obligatoire. Immuable. Spécifie la portée de cette étape.

boolean

Facultatif. Si la valeur est "true", l'événement qui répond à cette étape doit être le tout suivant après l'événement satisfaisant à la dernière étape. Si la règle n'est pas définie ou si elle est définie sur "false", cette étape suit indirectement l'étape précédente. Par exemple, il peut y avoir des événements entre l'étape précédente et cette étape. Il est ignoré lors de la première étape.

string (Duration format)

Facultatif. Lorsqu'elle est définie, cette étape doit être remplie dans la contrainte Duration de l'étape précédente (par exemple, t[i] - t[i-1] <= constraintDuration). Si cette règle n'est pas configurée, aucune durée n'est exigée (la durée est en réalité illimitée). Il est ignoré lors de la première étape.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

object (AudienceFilterExpression)

Obligatoire. Immuable. Expression logique des filtres de dimension, de métrique ou d'événement d'audience à chaque étape.