قراءة نمو الجماهير
كم جهة اتصال انضمت إلى كل جمهور خلال فترة تنتهي الآن، معدودة باليوم أو الساعة أو الدقيقة: مخطط النمو في صفحة الجماهير. يسجّل الجمهور متى انضم شخص ما ولا يسجّل أبدًا متى غادر، لذا فكل رقم يعدّ الأشخاص الذين ما زالوا في القائمة اليوم بحسب تاريخ انضمامهم، ولا ينخفض أي خط أبدًا.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
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 الذي ليس جمهورًا في مساحة العمل هذه يعطي 404 audience_not_found، وأكثر من 50 معرّفًا يعطي 422 invalid_parameter. وتبدأ الفترة من بداية أول فترة فرعية فيها، لذا قد يقع since قبل days يومًا بالضبط بقليل.