Skip to main content

pcLTV (Subscription) — Reference

The Subscription pcLTV model estimates the future economic value a subscriber will generate over a defined forecast window (e.g. 3, 6, or 12 months). It relies on past transactions (renewals), behavioural patterns, and customer-level attributes. It is a predictive model.

Input data: see AI Model Data Requirements → pcLTV. The requirements below are the subscription-specific view.


Data model overview

To activate a Subscription pcLTV model, BPP requires:

  • A transactional event table — one row per transaction (renewal).
  • A user table — one row per user with optional demographic and behavioural features.

Field names are examples, not mandatory — identity resolution stitches users across tables.


1. Event tables

A. Transactional event table (required)

One row per transaction. This is the core input.

Column nameTypeDescription
event_dateDATETIMEWhen the transaction occurred (UTC, mandatory)
user_idSTRINGUser identifier (mandatory)
monetaryFLOATTotal value of the transaction (mandatory)
transaction_idSTRINGUnique transaction identifier (mandatory)
subscription_typeSTRINGSubscription tier (recommended)

The table may contain other numerical and categorical features at transaction level.

One row per interaction event; improves accuracy.

Column nameTypeDescription
event_dateDATETIMEWhen the event occurred (UTC, mandatory)
user_idSTRINGUser identifier (mandatory)
event_typeSTRINGType of action performed (recommended)
payment_methodsSTRINGPayment method used (recommended)

One row per behavioural event on your site/app.

Column nameTypeDescription
event_dateDATETIMEWhen the event occurred (UTC, mandatory)
user_idSTRINGUser identifier (mandatory)
event_typeSTRINGe.g. page_view, form_submitted
OSSTRINGOperating system
BrowserSTRINGBrowser used

One row per user with enrichment features.

Example fieldTypeDescription
genderSTRINGUser's gender
ageINTEGERUser's age
countrySTRINGCountry of residence
client_typeSTRINGe.g. new vs returning
industrial_sectorSTRINGCompany's sector
job_roleSTRINGe.g. Marketing Director, HR Manager
num_employeesINTEGERCompany's employee count

Best practices

  • Forecast horizon vs history depth — historical data must be at least double the horizon (e.g. one year of history to estimate 6 months).
  • Renewal interval — a model estimates one renewal cadence at a time; you can't mix monthly and six-monthly renewals in one model.
  • User coverage — at least 20% of users should have 2+ renewals in the observation window.
  • Minimum volume — at least 2,000 users with transactions.
  • Data consistency — UTC timestamps, no duplicate transaction IDs, cleaned/standardised monetary values.
  • Feature quality — more descriptive, consistent, predictive features → better output.