خواندن رشد گروههای مخاطب
در بازهای که اکنون پایان مییابد، چند مخاطب به هر گروه پیوستهاند، شمردهشده روزانه، ساعتی یا دقیقهای: نمودار رشد در صفحهٔ گروههای مخاطب. گروه مخاطب ثبت میکند کسی کی پیوسته و هرگز ثبت نمیکند کی رفته، پس هر عدد کسانی را میشمارد که امروز هنوز در فهرستاند، بر پایهٔ تاریخ پیوستنشان، و هیچ خطی پایین نمیآید.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
GET /audiences/growth
در بازهای که اکنون پایان مییابد، چند مخاطب به هر گروه پیوستهاند، شمردهشده روزانه، ساعتی یا دقیقهای: نمودار رشد در صفحهٔ گروههای مخاطب. گروه مخاطب ثبت میکند کسی کی پیوسته و هرگز ثبت نمیکند کی رفته، پس هر عدد کسانی را میشمارد که امروز هنوز در فهرستاند، بر پایهٔ تاریخ پیوستنشان، و هیچ خطی پایین نمیآید.
نمونه
به audiences:read نیاز دارد. برای همهٔ گروهها audienceIds را نفرستید، یا تا ۵۰ گروه را با ویرگول جدا کنید. بازه days (۱ تا ۱۰۹۵) یا minutes (۱ تا ۱۵۷۶۸۰۰، که اگر هر دو فرستاده شوند اولویت دارد) است، و پیشفرضش ۳۰ روز. 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 که گروه مخاطبی در این فضای کاری نیست 404 audience_not_found میدهد، و بیش از ۵۰ شناسه 422 invalid_parameter میدهد. بازه از آغاز نخستین بخشش شروع میشود، پس since ممکن است کمی زودتر از دقیقاً days روز پیش باشد.