REST Resource: properties.recurringAudienceLists

Ressource: RecurringAudienceList

Une liste d'audience récurrente génère de nouvelles listes d'audience chaque jour. Les listes d'audience incluent les utilisateurs d'une audience au moment de leur création. Une liste d'audience récurrente vous permet de disposer d'une liste d'audience basée sur les données les plus récentes disponibles chaque jour.

Représentation JSON
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de la ressource de liste d'audience récurrente attribué lors de la création. Ce nom de ressource identifie cette RecurringAudienceList.

Format : properties/{property}/recurringAudienceLists/{recurringAudienceList}

audience

string

Obligatoire. Nom de la ressource d'audience. Ce nom de ressource identifie l'audience répertoriée et est partagé entre les API Data et Admin Analytics.

Format : properties/{property}/audiences/{audience}

audienceDisplayName

string

Uniquement en sortie. Nom à afficher descriptif pour cette audience. Par exemple, "Acheteurs".

dimensions[]

object (AudienceDimension)

Obligatoire. Dimensions demandées et affichées dans la réponse de la liste d'audience.

audienceLists[]

string

Uniquement en sortie. Noms des ressources des instances de listes d'audience créées pour cette liste d'audience récurrente. Une liste d'audience est créée pour chaque jour, avec pour affichage ici.

Les listes d'audience sont classées de la plus récente à la plus ancienne.

activeDaysRemaining

integer

Facultatif. Nombre de jours restants pendant lesquels une exportation d'audience récurrente générera une instance de liste d'audience. Ce compteur diminue d'une unité par jour et, lorsqu'il atteint zéro, aucune liste d'audience n'est créée.

Par défaut, la durée des demandes de listes d'audience récurrentes pour les propriétés Analytics 360 est de 180 jours et le délai maximal est de 365 jours. Par défaut, la durée des demandes pour les propriétés Analytics standards est de 14 jours. La durée maximale est de 30 jours.

La valeur minimale autorisée lors de la création est 1. Les requêtes supérieures à leur maximum respectif seront forcées à leur maximum.

webhookNotification

object (WebhookNotification)

Facultatif. Configure des notifications de webhook à envoyer depuis l'API Data de Google Analytics vers votre serveur de webhook. L'utilisation de webhooks est facultative. Si vous n'utilisez pas cette API, vous devrez interroger cette API pour déterminer à quel moment une liste d'audience récurrente créera d'autres listes d'audience. Les webhooks permettent d'envoyer une notification à vos serveurs et évitent d'avoir à interroger vos serveurs.

Deux demandes POST sont envoyées chaque fois qu'une liste d'audience récurrente crée une liste d'audience. Cela se produit une fois par jour jusqu'à ce qu'une liste d'audience récurrente atteigne 0 jour actif restant. La première demande sera envoyée et affichera une nouvelle liste d'audience dans son état CRÉATION. La seconde demande sera envoyée une fois la création de la liste d'audience terminée (état ACTIF ou ÉCHEC).

Méthodes

create

Crée une liste d'audience récurrente.

get

Récupère les métadonnées de configuration concernant une liste d'audience récurrente spécifique.

list

Liste toutes les listes d'audience récurrentes pour une propriété.