Das Wachstum von Audiences lesen
Wie viele Kontakte jeder Audience in einem Zeitraum bis jetzt beigetreten sind, gezählt nach Tag, Stunde oder Minute: das Wachstumsdiagramm auf der Audiences-Seite. Eine Audience hält fest, wann jemand beigetreten ist, nie, wann er gegangen ist; jede Zahl zählt also die Personen, die heute noch in der Liste sind, nach ihrem Beitrittsdatum, und eine Linie fällt nie.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /audiences/growth
Wie viele Kontakte jeder Audience in einem Zeitraum bis jetzt beigetreten sind, gezählt nach Tag, Stunde oder Minute: das Wachstumsdiagramm auf der Audiences-Seite. Eine Audience hält fest, wann jemand beigetreten ist, nie, wann er gegangen ist; jede Zahl zählt also die Personen, die heute noch in der Liste sind, nach ihrem Beitrittsdatum, und eine Linie fällt nie.
Beispiel
Erfordert audiences:read. Lassen Sie audienceIds für alle Audiences weg oder nennen Sie bis zu 50, durch Kommas getrennt. Der Zeitraum ist days (1 bis 1095) oder minutes (1 bis 1576800, hat Vorrang, wenn beide gesendet werden), standardmäßig 30 Tage. grain ist day, hour oder minute, standardmäßig day, und offsetMinutes (-840 bis 840) ist der Abstand des Betrachters zu UTC, damit Tages-Buckets um seine lokale Mitternacht beginnen.
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 sind die Mitglieder jetzt, before die unter ihnen, die vor since beigetreten sind, und added die, die innerhalb des Zeitraums beigetreten sind; before plus added ergibt also total. Ein Kontakt, der beigetreten ist und später gegangen ist, steckt in keiner dieser Zahlen.
totals.contacts zählt jede Person einmal, egal in wie vielen Listen sie ist, während totals.memberships die Listen aufaddiert, sodass eine Person für jede gelesene Liste, in der sie ist, einmal zählt, und die Standard-Audience enthält alle. totals.busiest ist der Bucket mit den meisten Beitritten über alle Listen, oder null, wenn niemand beigetreten ist.
Bucket-Schlüssel sind YYYY-MM-DD nach Tag, YYYY-MM-DDTHH nach Stunde und YYYY-MM-DDTHH:MM nach Minute, in der Ortszeit, die offsetMinutes angibt. Aufgeführt werden nur Buckets mit einem Beitritt; füllen Sie die Lücken beim Zeichnen also mit null. series ist nach total sortiert, größte zuerst, dann nach Name, und builtin ist bei der Standard-Audience true.
Eine ID in audienceIds, die keine Audience in diesem Workspace ist, ergibt ein 404 audience_not_found, und mehr als 50 IDs ergeben ein 422 invalid_parameter. Der Zeitraum beginnt am Anfang seines ersten Buckets, since kann also etwas früher liegen als genau days zuvor.