Feature · Payment providers

Paddle Analytics Dashboard: Add the Missing Traffic Source

Paddle reports revenue and subscriptions, not the marketing channel behind each one. Pass a visitor id in customData and see Paddle revenue by source.

· 3 min read

Traffic lines leading to a revenue target and a payment card

Paddle takes care of payments, tax and subscriptions as your merchant of record, and its dashboard reports revenue, transactions and subscription metrics. Like every billing system, it starts counting at checkout. The visit that led there, and its source, is outside its view.

The gap

Paddle knows that a customer subscribed to your Pro plan on 3 November. It doesn't know they found you through a comparison article, came back from a newsletter a week later and then subscribed. Without that, you can't tell which marketing deserves more time.

Pass the visitor in customData

Paddle Checkout accepts customData, an object you set when you open the checkout. Paddle stores it on the transaction and includes it in webhooks. Put the visitor id there:

const { df_visitor_id } = window.datafair.attribution();
Paddle.Checkout.open({
  items: [{ priceId: 'pri_123', quantity: 1 }],
  customData: { df_visitor_id },
});

That's the only code change. DataFair reads it from the webhook and credits the payment to the visitor's source.

Add the webhook

  1. Add the DataFair script to your site.
  2. In DataFair, open Integrations, pick Paddle and click Get webhook URL.
  3. In Paddle, add a notification destination with that URL and tick transaction.completed, transaction.payment_failed, adjustment.created, adjustment.updated and subscription.canceled.
  4. Copy Paddle's secret key into DataFair.

The sandbox has its own destinations and secrets, at sandbox-vendors.paddle.com.

What you see

  1. 1Paddle transactionCarries df_visitor_id in customData
  2. 2DataFair webhookMatches the visitor and their source
  3. 3DashboardRevenue by channel, referrer, campaign, page and country
  4. 4Recurring revenueMRR, new subscribers and churn by source
From Paddle payment to report

Adjustments (refunds and credits) reduce the revenue credited to the original source, so the numbers stay honest.

MRR, subscribers and churn by source in DataFair
Recurring revenue by source in the DataFair demo (sample data).

Read more about MRR by acquisition channel and revenue per visitor, the two numbers that matter most once Paddle revenue has a source.

Related guide: Paddle revenue attribution.

Questions

Can Paddle show which channel a customer came from?
Not from its dashboard. Paddle records what you pass in customData, so it needs an analytics tool on your site to supply the visitor and their source.
Does this work with Paddle Billing and subscriptions?
Yes. Transactions and subscription renewals arrive through the same webhook, so renewals keep the source of the first payment.
What happens to payments without customData?
They're reported as unattributed, so your totals stay complete and you can see how many payments still need the visitor id.

Related