Tracking & Analytics
Why does Lago need data?
We decided to open-source the billing API we would have dreamt to use. As a consequence of building a self hosted product, we are not able to easily collect any usage metrics or insights to help us build a better product. This analytic help us understand crucial behaviors and ship better quality to serve your needs.
We decided to track, by default, so basic behaviors and metrics that are important to understand the usage of Lago. We have built a minimum required tracking plan to minimize the security impact of collecting those events. All the metrics collected are listed in a further section. We make this as transparent as possible, and we don't track financial information (amounts of invoices, for instance).
The metrics are collected through the server side Ruby source from Segment.com.
Lago will not collect any financial information about your customers or your invoices.
As detailed previously, we ask you to keep as much as possible those tracked metrics, unless you have a specific reason to opt out. Keeping the metrics enabled is the easiest way for Lago to get feedback based on product usage.
In the case you need to remove it, we've created a very easy process to opt out. In the environment variables, by passing the field
true, you prevent the entire tracking logic to run in your application.
Detail of events collected by Lago
This event flow enables Lago to understand the full activation flow, from the registration to the first invoice generated.
organization_registered: when you create your organization by signing up to Lago
billable_metric_created: whenever you create a new billable metric
plan_created: whenever you create a new plan
customer_created: whenever a customer is created in Lago
subscription_created: when a subscription is assigned to a customer
coupon_created: whenever a new coupon is created
applied_coupon_created: when a coupon is assigned to a customer
add_on_created: whenever a new add-on is created
invoice_created: when a new invoice is emitted for a specific customer
payment_status_changed: when the payment status of an invoice changes
credit_note_issued: when a new credit note is issued for a customer
billable_metric_deleted: when a billable metric is deleted
plan_deleted: when a plan is deleted
customer_deleted: when a customer account is deleted
Detail of data collected about your organization
By default, we collect data of your organization that you used in the signup form:
- Your organization's email; and
- Your organization's name.
By opting out, your organization's data won't be tracked anymore.
Examples of collected payloads