Revenue from custom events
Add a numericrevenue property to the event that marks a purchase:
Provider payments as events
A payment from Stripe or Paddle becomes apurchase event, and a refund becomes a refund event. These are the names that Google Analytics and game analytics tools use.
You see these records in three places:
- Overview. The Revenue metric adds provider payments to the revenue of your own events, net of refunds.
- Activity. Each payment and refund is a row, for example “Paid $15.00 (Stripe)”.
- Attribution. Choose the goal
purchase.
One sale is counted once
Many studios also send their ownpurchase event with a revenue property. To count such a sale once, the provider record wins: when a user has a payment record from a provider, the revenue of that user’s own events is left out of the Overview metric, and that user’s own purchase events are left out of the purchase goal in Attribution. A user with no provider record keeps the revenue of the own events. The rule also covers an own event that the browser sent before identify, when its anonymous ID links to that one user.
Provider payments have no page, source or device of their own. In the Overview cards and the chart split with the Revenue metric, a payment takes the source, country and device of the buyer’s first website page view in the 90 days before the payment. A payment with no known buyer shows as Direct or Unknown. When you add a filter, the Overview and Activity show your own events only.
With the Revenue metric, a legend under the Overview chart shows where the revenue comes from: your own events, Stripe, Paddle, itch.io and Steam. The legend shows only when a source other than your own events has an amount.
Steam net sales
With a Steam connection, the Revenue metric of the Overview includes the Steam net sales of each day. In the chart split, Steam is one group named “Steam”.- The amount is sales less returns and taxes, before the Steam revenue share. It is not your payout.
- The day is the Pacific Time day of Steam.
- Steam amounts are in USD. In a report with another currency, they are converted with the exchange rate of the day.
- With a filter on the Overview, Steam is left out.
- Steam gives totals with no buyer, so Steam sales are not in the cards, the user profiles or the Activity feed.
Connect Stripe or Paddle
You need the owner or admin role and a verified MFA session.1
Create the webhook endpoint
Open Settings, then Integrations. In the Stripe or the Paddle section, click Create webhook endpoint.
2
Register it with your provider
Copy the endpoint URL into your provider’s webhook settings.
3
Save the signing secret
Copy the provider’s webhook signing secret, paste it into Webhook signing secret and click Save signing secret. Revenue ingestion starts.
4
Import history (optional)
Enter a restricted Read API key with read access to invoices or transactions, refunds or adjustments, and subscriptions. For Stripe, also give read access to Checkout Sessions to import one-time Checkout payments. A key without it imports the rest and skips them. Then import historical revenue. Imports resume automatically, and completed imports are reconciled daily.
Supported provider events
Every webhook is verified against its signature. Other event types are acknowledged and ignored.
One-time Stripe Checkout payments
A one-time Checkout Session (modepayment, also from a Payment Link) has no invoice unless you turn on invoice creation. Untitled Analytics records it from checkout.session.completed when the session is paid. A delayed payment method (for example a bank debit) is recorded from checkout.session.async_payment_succeeded. The record ID is the payment intent (pi_…), so a refund of the payment links to it.
A sale is counted once. A session with an invoice is counted by invoice.paid, and a subscription session is counted by its invoices, so these sessions are skipped.
Link revenue to users
Untitled Analytics links a billing record to a user in one of two ways:- A
user_idin the provider’s metadata (Stripe) orcustom_data(Paddle). For a Stripe Checkout Session, the sessionmetadata.user_id, else itsclient_reference_id. - An identify trait
stripe_customer_idorpaddle_customer_id:
Currency
Amounts keep their original currency. Each report shows one report currency: the project’s Reporting currency (Project settings, USD by default). Addcurrency=EUR to a report URL to see another one. The setting needs an owner or admin with MFA. By default every amount is converted to the report currency with the European Central Bank reference rate of the event day (the last known rate on weekends and holidays). A currency that the ECB does not publish is left out. An event without a currency counts in the report currency, so send currency when you sell in more than one currency. The currency property is not case-sensitive. Add currency_mode=only to count only revenue in the report currency, without conversion. Converted totals use reference rates, not the rate that your payment provider used.