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 correspondent aux utilisateurs d'une audience au moment de leur création. Une liste d'audience récurrente garantit que votre liste d'audience est 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 ressource de la liste d'audience récurrente attribué lors de la création. Ce nom de ressource identifie ce RecurringAudienceList.

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

audience

string

Obligatoire. Nom de ressource de l'audience. Ce nom de ressource identifie l'audience répertoriée. Il est partagé entre les données Analytics et API Admin.

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

audienceDisplayName

string

Uniquement en sortie. Nom descriptif à afficher 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 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 classée par ordre décroissant en commençant par la liste d'audience la plus récente.

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 nouvelle liste d'audience n'est créée.

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

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

webhookNotification

object (WebhookNotification)

Facultatif. Configure les notifications webhook à envoyer depuis l'API Data de Google Analytics vers votre serveur de webhooks. L'utilisation de webhooks est facultative. Si elle n'est pas utilisée, vous devez interroger cette API pour déterminer à quel moment une liste d'audience récurrente crée d'autres listes d'audience. Les webhooks permettent d'envoyer une notification à vos serveurs et d'éviter d'avoir à interroger les données.

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 avec la liste d'audience que vous venez de créer à l'état CRÉATION. La deuxième demande est 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 d'une liste d'audience récurrente spécifique.

list

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