Subscriber Data Model

MATRIXX Engine maintains transactional subscriber data that enables you to act in real-time to subscriber needs and service usage. The subscriber management data model is exposed through MATRIXX Data Container (MDC) definitions.

The subscriber management data model classifies objects into three general categories:
  • Primary Objects
    Primary objects are exposed at the top level of the API. They can be directly accessed using a system-designated ObjectId or by using a client-supplied ExternalId. All primary objects can be extended during configuration to include new data fields. The primary objects are:
    • Subscription — A subscription contains pointers to all data required for rating, charging, and policy management. This includes pointers to groups, users, wallets, product offers, and devices. A subscription can have zero or one owner.
    • Group — A collection of subscriptions and/or groups. A group can have zero or one owner.
    • Device — A device that uses network resources.
    • User — An individual associated with zero or more subscriptions or groups. A user can own zero or more subscriptions or groups. For more information about user roles, see the discussion about user roles in MATRIXX Subscriber Management.
  • Secondary Objects
    Secondary Objects are distinct objects in the database but are not directly exposed through the APIs. They are referenced through a primary object. The secondary objects are:
    • Wallet — Fiscal information.
  • Embedded Objects
    Embedded objects are owned by, and are part of, a primary or secondary object. They are not distinct database objects. Embedded objects include:
    • PurchasedOffer — A purchased product offer. (A data client provides the structure of PurchasedOffer data and the system returns the information.)
    • PurchasedBundle — A purchased bundle. (A data client provides the structure of PurchasedBundle data and the system returns the information.)
    • Balance — A specific balance or meter.
    • Threshold — A specific threshold set on a balance or meter that overrides the default credit limit.
    • BillingCycle — Information about the billing cycle.