ऑडियंस की वृद्धि पढ़ें
अभी ख़त्म होने वाली अवधि में हर ऑडियंस में कितने संपर्क जुड़े, दिन, घंटे या मिनट के हिसाब से गिने गए: ऑडियंस पेज का वृद्धि चार्ट। ऑडियंस दर्ज करती है कि कोई कब जुड़ा, यह कभी नहीं कि कब गया, इसलिए हर संख्या उन लोगों को गिनती है जो आज भी सूची में हैं, उनके जुड़ने की तारीख़ के हिसाब से, और कोई रेखा कभी नीचे नहीं जाती।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
GET /audiences/growth
अभी ख़त्म होने वाली अवधि में हर ऑडियंस में कितने संपर्क जुड़े, दिन, घंटे या मिनट के हिसाब से गिने गए: ऑडियंस पेज का वृद्धि चार्ट। ऑडियंस दर्ज करती है कि कोई कब जुड़ा, यह कभी नहीं कि कब गया, इसलिए हर संख्या उन लोगों को गिनती है जो आज भी सूची में हैं, उनके जुड़ने की तारीख़ के हिसाब से, और कोई रेखा कभी नीचे नहीं जाती।
उदाहरण
audiences:read चाहिए। सभी ऑडियंस के लिए audienceIds छोड़ दें, या अल्पविराम से अलग करके 50 तक बताएँ। अवधि days (1 से 1095) या minutes (1 से 1576800, दोनों भेजने पर यही मान्य होता है) है, डिफ़ॉल्ट 30 दिन। grain day, hour या minute है, डिफ़ॉल्ट day, और offsetMinutes (-840 से 840) देखने वाले का UTC से अंतर है, ताकि दिन के बकेट उसकी स्थानीय आधी रात से शुरू हों।
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 अभी के सदस्य हैं, before उनमें से वे जो since से पहले जुड़े, और added वे जो अवधि के भीतर जुड़े, इसलिए before और added का जोड़ total है। जो संपर्क जुड़ा और बाद में चला गया वह इनमें से किसी में नहीं है।
totals.contacts हर व्यक्ति को एक बार गिनता है, चाहे वह कितनी भी सूचियों में हो, जबकि totals.memberships सूचियों को जोड़ता है, इसलिए कोई व्यक्ति पढ़ी गई हर उस सूची के लिए एक बार गिना जाता है जिसमें वह है, और डिफ़ॉल्ट ऑडियंस में सब हैं। totals.busiest सभी सूचियों में सबसे ज़्यादा जुड़ाव वाला बकेट है, या null अगर कोई नहीं जुड़ा।
बकेट कुंजियाँ दिन के लिए YYYY-MM-DD, घंटे के लिए YYYY-MM-DDTHH और मिनट के लिए YYYY-MM-DDTHH:MM हैं, offsetMinutes द्वारा बताए स्थानीय समय में। सिर्फ़ वे बकेट सूचीबद्ध होते हैं जिनमें कोई जुड़ा, इसलिए चार्ट बनाते समय खाली जगहों को शून्य से भरें। series total के हिसाब से बड़े से छोटे, फिर नाम से क्रमबद्ध है, और डिफ़ॉल्ट ऑडियंस पर builtin true है।
audienceIds में ऐसी ID जो इस वर्कस्पेस की ऑडियंस नहीं है 404 audience_not_found देती है, और 50 से ज़्यादा ID 422 invalid_parameter देती हैं। अवधि अपने पहले बकेट की शुरुआत से शुरू होती है, इसलिए since ठीक days दिन पहले से थोड़ा पहले पड़ सकता है।