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 sont les utilisateurs d'une audience au moment de la création de la liste. 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 listée et est partagé entre les API Analytics Data et Admin.

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

string

Uniquement en sortie. Nom à afficher descriptif de 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 de ressources de liste d'audience pour les instances de liste d'audience créées pour cette liste d'audience récurrente. Une liste d'audience est créée pour chaque jour et s'affiche ici.

Cette liste est triée de la liste d'audience la plus récente à la plus ancienne.
activeDaysRemaining

integer

Facultatif. Nombre de jours restants pendant lesquels une exportation d'audience récurrente produira une instance de liste d'audience. Ce compteur diminue d'un point chaque jour. Lorsqu'il atteint zéro, aucune nouvelle liste d'audience n'est créée.

La durée par défaut de la requête de liste d'audience récurrente pour les propriétés Analytics 360 est de 180 jours et peut aller jusqu'à 365 jours maximum. La durée par défaut des requêtes pour les propriétés Analytics standards est de 14 jours, et la durée maximale est de 30 jours.

La valeur minimale autorisée lors de la création est de 1. Les requêtes dépassant leur limite respective seront limitées à cette limite.
webhookNotification

object (WebhookNotification)

Facultatif. Configure les notifications webhook à envoyer depuis l'API Google Analytics Data vers votre serveur webhook. L'utilisation de webhooks est facultative. Si elle n'est pas utilisée, vous devrez interroger cette API pour déterminer quand une liste d'audience récurrente crée des listes d'audience. Les webhooks permettent d'envoyer une notification à vos serveurs et d'éviter les requêtes actives.

Deux requêtes 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 n'ait plus aucun jour actif restant. La première requête indiquera qu'une liste d'audience vient d'être créée et qu'elle est en cours de création. La deuxième requête sera envoyée une fois la création de la liste d'audience terminée (état ACTIVE ou FAILED).

Méthodes

create

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

get

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

list

 Répertorie toutes les listes d'audience récurrentes d'une propriété.