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 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. Elle ne peut pas être supérieure à 540 jours.

boolean

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

object (AudienceEventTrigger)

Facultatif. Spécifie un événement à enregistrer lorsqu'un utilisateur rejoint l'audience. Si ce champ n'est pas défini, aucun événement n'est consigné lorsqu'un utilisateur rejoint l'audience.

enum (AudienceExclusionDurationMode)

Immuable. Indique la durée de l'exclusion pour les utilisateurs correspondant au filtre d'exclusion. Elle est appliquée à toutes les clauses de filtrage EXCLURE et est ignorée lorsqu'il n'existe aucune clause de filtre EXCLURE dans l'audience.

object (AudienceFilterClause)

Obligatoire. Immuable. Liste à puces. Filtrer les clauses définissant l'audience Toutes les clauses sont reliées par l'opérateur ET.

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

string

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

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 "Inclure" ou "Exclure".

object (AudienceSimpleFilter)

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

object (AudienceSequenceFilter)

Filtres 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 le champ d'application de ce filtre.

object (AudienceFilterExpression)

Obligatoire. Immuable. Une expression logique de 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 par l'opérateur ET. Il ne peut contenir que des "AudienceFilterExpressions" avec orGroup. Ce champ doit être défini pour "AudienceFilterExpression" de premier niveau.

object (AudienceFilterExpressionList)

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

object (AudienceFilterExpression)

Expression de filtre à ne PAS inclure (par exemple, inversée, complétée). Il ne peut inclure qu'un dimensionOrOrFilter. Cette valeur ne peut pas être définie au niveau de l'élément "AudienceFilterExpression" de premier niveau.

object (AudienceDimensionOrMetricFilter)

Un filtre sur une seule dimension ou métrique. Cette valeur ne peut pas être définie au niveau de l'élément "AudienceFilterExpression" de premier niveau.

object (AudienceEventFilter)

Crée un filtre correspondant à un événement spécifique. Cette valeur ne peut pas être définie au niveau de l'élément "AudienceFilterExpression" de premier niveau.

{
  "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 est 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 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 ce paramètre est défini sur "true", les utilisateurs rejoignent l'audience s'ils ont rempli la condition (évaluation statique). Si cette règle n'est pas configurée ou qu'elle est définie sur "False", l'évaluation par les utilisateurs est dynamique. Les utilisateurs sont ajoutés à une audience lorsqu'ils remplissent les conditions spécifiées et sont supprimés lorsqu'ils ne les remplissent plus.

Ce paramètre ne peut être défini que si le champ d'application de l'audience est ACROSS_ALL_SESSIONS.

integer

Facultatif. Si ce champ est défini, spécifie la période pour laquelle évaluer les données en nombre de jours. Si ce champ n'est pas défini, les données d'audience sont évaluées par rapport aux données permanentes (par exemple, la période est illimitée).

Par exemple, si elle est définie sur 1 jour, seules les données du jour sont évaluées. Le point de référence correspond au jour actuel où atanyPointInTime n'est pas défini ou est faux.

Il ne peut être défini que si le champ d'application de l'audience est ACROSS_ALL_SESSIONS et ne peut pas dépasser 60 jours.

object (StringFilter)

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

object (InListFilter)

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

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 pour le 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 définie sur "false", la correspondance n'est pas sensible à la casse.

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

string

Obligatoire. Liste des valeurs de chaîne possibles. Ce champ est obligatoire.

boolean

Facultatif. Si la valeur est "true", la correspondance est sensible à la casse. Si la valeur est définie sur "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. Si ce filtre est spécifié, il correspond aux événements qui correspondent à la fois au nom de l'événement unique et aux expressions de filtre de 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 et unique groupe de dimensionOrMetricFilter ou notExpression. Les opérateurs AND ou OR ne sont pas acceptés. De plus, si elle inclut un filtre pour "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 le champ d'application de ce filtre.

string (Duration format)

Facultatif. Définit la période pendant laquelle toute la séquence doit se produire.

Durée en secondes avec neuf chiffres au maximum, finissant par "s". Exemple: "3.5s".

object (AudienceSequenceStep)

Obligatoire. Une séquence ordonnée d'étapes. Un 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 définie sur "true", l'événement satisfaisant à cette étape doit être le tout suivant après celui de la dernière étape. Si cette règle n'est pas configurée ou qu'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 remplie dans les limites de la durée de l'étape précédente (par exemple, t[i] - t[i-1] <= contrainteDuration). Si elle n'est pas définie, aucune durée n'est requise (la durée est illimitée). Il est ignoré pour la première étape.

Durée en secondes avec neuf chiffres au maximum, finissant par "s". Exemple: "3.5s".

object (AudienceFilterExpression)

Obligatoire. Immuable. Expression logique de filtres de dimensions, de métriques ou d'événements d'audience à chaque étape.