Magidoc

AudienceGrowthHealth
Object

Growth and health metrics for a subscriber list including trends and churn analysis

Fields

#

activeContacts

Int !
Non-null

Number of active contacts (subscribed and deliverable)

churnComplaints

Int !
Non-null

Number of spam complaints in the last 30 days

churnCount30Day

Int !
Non-null

Total number of contacts lost to churn in the last 30 days

churnHardBounces

Int !
Non-null

Number of hard bounces in the last 30 days

churnHealthLevel

Int !
Non-null

Churn health level: 0=Excellent (<0.5%), 1=Good (0.5-1%), 2=Fair (1-2%), 3=Poor (>2%)

churnLost

Int !
Non-null

Number of contacts who became 'lost' (90+ days inactive) in the last 30 days

churnRate30Day

Decimal !
Non-null

Churn rate as a percentage over the last 30 days (contacts lost / total contacts)

churnTrendData

String

Monthly churn rate trend data for the last 6 months as JSON array with date, count, rate, and per-type breakdown (unsubscribes, hardBounces, complaints, lost)

churnUnsubscribes

Int !
Non-null

Number of contacts who unsubscribed in the last 30 days

dataAsOfUtc

DateTime !
Non-null

Timestamp when this data was last calculated

deliverabilityHealthScore

Int !
Non-null

Deliverability health score (0-100)

deliverabilityScoreChange

Int !
Non-null

Change in deliverability health score over the last 30 days

deliverabilityStatus

String !
Non-null

Deliverability status: 'Healthy' (>=80), 'Monitor' (60-79), 'Act Soon' (<60)

growthHealthLevel

Int !
Non-null

Growth health level: 0=Excellent (>2%), 1=Good (0.5-2%), 2=Fair (-0.5-0.5%), 3=Poor (<-0.5%)

growthRate30Day

Decimal !
Non-null

Growth rate as a percentage over the last 30 days

growthRate90Day

Decimal !
Non-null

Growth rate as a percentage over the last 90 days

growthRateAnnual

Decimal !
Non-null

Growth rate as a percentage over the last 365 days

growthTrendData

String

Daily growth trend data for the last 90 days as JSON array with date, total, new, and lost fields

insights

[GrowthHealthInsight !]!
Non-null

Collection of contextual insights about growth and churn health with actionable recommendations

netGrowth30Day

Int !
Non-null

Net growth (new subscribers minus unsubscribes) over the last 30 days

netGrowth90Day

Int !
Non-null

Net growth (new subscribers minus unsubscribes) over the last 90 days

netGrowthAnnual

Int !
Non-null

Net growth (new subscribers minus unsubscribes) over the last 365 days

newSubscribers30Day

Int !
Non-null

Number of new subscribers added in the last 30 days

newSubscribers90Day

Int !
Non-null

Number of new subscribers added in the last 90 days

newSubscribersAnnual

Int !
Non-null

Number of new subscribers added in the last 365 days

totalContacts

Int !
Non-null

Total number of contacts in the audience

unsubscribes30Day

Int !
Non-null

Number of unsubscribes in the last 30 days

unsubscribes90Day

Int !
Non-null

Number of unsubscribes in the last 90 days

unsubscribesAnnual

Int !
Non-null

Number of unsubscribes in the last 365 days

Usages

#

References

#

  • Field growthHealth from Query