TOOL

Lifecycle Engine Docs

Variables used to match users to tracked entities, score campaign opportunities, and model funnel outcomes.

Input data fields

FieldMeaningExample / rangeUsed by
user.fullName / emailThe person who may receive a generated lifecycle message.Jordan Lee / jordan@example.comMessage personalization and candidate context
user.segmentCommercial lifecycle segment assigned to the user.FREE, TRIAL, LAPSED, ACTIVESegment contribution and eligibility
user.subscriptionStatusBilling/subscription state used to choose appropriate outreach posture.NONE, TRIALING, ACTIVE, CANCELED, EXPIREDCampaign targeting and suppression logic
user.lastActiveAtMost recent observed activity timestamp for the user.Recent date or blankRecency context and message tone
entity.name / entityTypeThe person, place, record, or object the user has shown interest in.123 Main St / propertyInterest graph and generated copy
entity.city / stateOptional location context for the tracked entity.Austin / TXMessage specificity and landing context
interestEdge.interestScoreStrength of the user's demonstrated relationship to an entity.0.72Interest contribution to priority score
interestEdge.sourceWhere the relationship signal came from.search, view, savedAuditability and operator interpretation
entityDelta.changeTypeThe type of change detected on the tracked entity.ADDRESS_CHANGE, EMPLOYEE_RECORD_ADDED, OTHER_RECORD_ADDEDChange-type contribution and message angle
entityDelta.oldValue / newValue / deltaSummaryBefore/after values and plain-language explanation of the change.Old phone -> new phone; phone addedGenerated message evidence and landing copy
simulation.topN / deltaCountOperator controls for how many opportunities to generate and how many new deltas to inject.Top 20, 8-20 deltasSimulation volume and campaign run size

Model variables and ranges

VariableTypeRangeUsed by
segmentenumFREE, TRIAL, LAPSED, ACTIVEPriority score segment contribution
subscriptionStatusenumNONE, TRIALING, ACTIVE, CANCELED, EXPIREDUser context and campaign targeting
interestScorefloat0-1Interest-edge contribution
recencyScorefloat0-1Delta freshness contribution
minPriorityScorefloat0-1Candidate filtering
openRate/clickRate/engageRate/purchaseRatefloat0-1Outcome simulation
avgOrderValuecurrency$0+Estimated revenue
topN/deltaCountinteger1-100 / 1-200Simulation volume controls

Formulas and recommendation rules

Model stepFormulaDecision rule
Priority scoreinterestContribution + recencyContribution + segmentContribution + changeTypeContributionCandidates below minPriorityScore are filtered out.
High-priority flagpriorityScore >= highPriorityThresholdHigh-priority candidates drive campaign generation and revenue projection.
Projected revenuepurchases * avgOrderValue, with purchase rate adjusted by highPriorityLiftUsed to compare scenario assumptions across campaign runs.