Lire la croissance des audiences
Combien de contacts ont rejoint chaque audience sur une période qui se termine maintenant, comptés par jour, heure ou minute : le graphique de croissance de la page des audiences. Une audience enregistre quand quelqu'un l'a rejointe et jamais quand il l'a quittée, donc chaque chiffre compte les personnes encore dans la liste aujourd'hui, selon leur date d'arrivée, et une courbe ne baisse jamais.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
GET /audiences/growth
Combien de contacts ont rejoint chaque audience sur une période qui se termine maintenant, comptés par jour, heure ou minute : le graphique de croissance de la page des audiences. Une audience enregistre quand quelqu'un l'a rejointe et jamais quand il l'a quittée, donc chaque chiffre compte les personnes encore dans la liste aujourd'hui, selon leur date d'arrivée, et une courbe ne baisse jamais.
Exemple
Nécessite audiences:read. Omettez audienceIds pour toutes les audiences, ou indiquez-en jusqu'à 50 séparées par des virgules. La période est days (1 à 1095) ou minutes (1 à 1576800, qui l'emporte si les deux sont envoyés), 30 jours par défaut. grain vaut day, hour ou minute, day par défaut, et offsetMinutes (-840 à 840) est le décalage de la personne qui consulte par rapport à UTC, pour que les tranches journalières commencent à son minuit local.
curl "$OE/audiences/growth?days=30" -H "$AUTH"{ "object": "audience_growth", "since": "2026-08-25T00:00:00.000Z", "until": "2026-09-23T12:00:00.000Z", "grain": "day", "offsetMinutes": 0, "totals": { "contacts": 412, "memberships": 415, "added": 37, "lists": 2, "busiest": "2026-09-18" }, "series": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": true, "total": 412, "before": 378, "added": 34, "buckets": [ { "bucket": "2026-09-14", "added": 9 }, { "bucket": "2026-09-18", "added": 25 } ] }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": false, "total": 3, "before": 0, "added": 3, "buckets": [{ "bucket": "2026-09-18", "added": 3 }] } ]}total correspond aux membres actuels, before à ceux d'entre eux qui ont rejoint avant since, et added à ceux qui ont rejoint pendant la période : before plus added donne donc total. Un contact qui a rejoint puis est parti n'apparaît dans aucun de ces chiffres.
totals.contacts compte chaque personne une fois, quel que soit le nombre de listes où elle figure, tandis que totals.memberships additionne les listes, si bien qu'une personne compte une fois pour chaque liste lue qui la contient, et l'audience par défaut contient tout le monde. totals.busiest est la tranche qui a reçu le plus d'arrivées toutes listes confondues, ou null si personne n'a rejoint.
Les clés de tranche sont YYYY-MM-DD par jour, YYYY-MM-DDTHH par heure et YYYY-MM-DDTHH:MM par minute, dans l'heure locale indiquée par offsetMinutes. Seules les tranches avec au moins une arrivée sont listées : comblez les trous avec zéro quand vous les tracez. series est trié par total, du plus grand au plus petit, puis par nom, et builtin vaut true sur l'audience par défaut.
Un identifiant de audienceIds qui n'est pas une audience de cet espace de travail donne un 404 audience_not_found, et plus de 50 identifiants donnent un 422 invalid_parameter. La période commence au début de sa première tranche, donc since peut tomber un peu avant exactement days jours.