REST Resource: properties.audiences

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

string

Uniquement en sortie. Nom de la 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. Elle ne peut pas être définie sur plus de 540 jours.

boolean

Uniquement en sortie. Elle est automatiquement définie par GA sur "false" s'il s'agit d'une audience ANP et si elle est exclue de la personnalisation des annonces.

object (AudienceEventTrigger)

Facultatif. Spécifie un événement à consigner 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 EXCLURE et est ignorée si aucune clause de filtre EXCLURE n'existe dans l'audience.

object (AudienceFilterClause)

Obligatoire. Immuable. Liste à puces. Clauses de filtre qui définissent l'audience. Toutes les clauses doivent être reliées par l'opérateur AND.

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

string

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

enum (LogCondition)

Obligatoire. Quand consigner l'événement

{
  "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 d'inclusion ou d'exclusion.

object (AudienceSimpleFilter)

Un filtre simple qu'un utilisateur doit satisfaire pour faire partie de l'audience.

object (AudienceSequenceFilter)

Filtres qui doivent apparaître 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 dimensions, de métriques ou d'événements 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 AudienceFilterExpressions avec orGroup. Doit être défini pour l'AudienceFilterExpression de premier niveau.

object (AudienceFilterExpressionList)

Liste d'expressions auxquelles les opérateurs OR sont associés. Il ne peut pas contenir d'AudienceFilterExpressions avec andGroup ou orGroup.

object (AudienceFilterExpression)

Expression de filtre à NE PAS AJOUTER (par exemple, inversée ou complétée). Il ne peut inclure qu'un élément dimensionOrMetricFilter. Impossible de définir cet élément au niveau "AudienceFilterExpression" de niveau supérieur.

object (AudienceDimensionOrMetricFilter)

Filtre sur une seule dimension ou métrique. Impossible de définir cet élément au niveau "AudienceFilterExpression" de niveau supérieur.

object (AudienceEventFilter)

Crée un filtre qui correspond à un événement spécifique. Impossible de définir cet élément au niveau "AudienceFilterExpression" de niveau supérieur.

{
  "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 portée sera ajouté au début du nom de la dimension ou de la métrique personnalisée. Pour en savoir plus sur les préfixes de portée ou sur 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 les utilisateurs pour une audience est dynamique. Les utilisateurs sont ajoutés à une audience lorsqu'ils remplissent les conditions, puis sont supprimés lorsqu'ils ne les remplissent plus.

Vous ne pouvez définir ce paramètre que si la portée de l'audience est ACROSS_ALL_SESSIONS.

integer

Facultatif. Si cette valeur est définie, elle 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 "1 jour", seules les données du jour en cours sont évaluées. Le point de référence correspond au jour actuel quand atAnyPointInTime n'est pas défini ou est "false".

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

object (StringFilter)

Filtre d'une dimension de type chaîne correspondant à une règle particulière.

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

Il s'agit d'un 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 pouvant être mises 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 met en correspondance 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 des paramètres (par exemple, les filtres d'événements imbriqués ne sont pas acceptés). Il doit s'agir d'un seul andGroup de dimensionOrMetricFilter ou notExpression. Les opérateurs AND des OR ne sont pas acceptés. De plus, s'il inclut un filtre "eventCount", seul celui-ci sera pris en compte. Tous les autres filtres seront 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 un maximum de neuf chiffres après la virgule, se terminant par "s". Exemple: "3.5s".

object (AudienceSequenceStep)

Obligatoire. Séquence ordonnée d'étapes. L'utilisateur doit effectuer 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 le champ d'application de cette étape.

boolean

Facultatif. Si la valeur est "true", l'événement correspondant à cette étape doit être le tout suivant après que celui-ci a satisfait à la dernière étape. Si elle 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é pour la première étape.

string (Duration format)

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

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

object (AudienceFilterExpression)

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