Attribution & reporting
How attribution works
Your partner code is already baked into every plan's enrollment URLs (both enrollmentUrl and headlessEnrollmentUrl) returned by the API — there's nothing to add for PowerHQ to credit you. Any customer who completes checkout through that URL is automatically attributed to your account.
Your own campaign attribution
For your own marketing attribution, append a utm_campaign parameter to the headlessEnrollmentUrl before you embed it:
<iframe src="PLAN_HEADLESS_ENROLLMENT_URL&utm_campaign=YOUR_CAMPAIGN" …></iframe>
Whatever value is present at conversion flows through to your conversion file and commission report. Use it however fits — a campaign name/placement, or a unique ID you match back on your end. Your partner code still tags every conversion regardless, so you're credited even if you omit utm_campaign.
What counts as activity
An API partner's funnel begins when a customer enters the PowerHQ checkout from the headlessEnrollmentUrl you embedded. Anything earlier — plan browsing in your own UI — happens outside PowerHQ, so track that on your end if you want full top-of-funnel visibility.
Reports you receive
Once you're live, PowerHQ reports conversions back to you automatically:
| Report | What it gives you | Cadence |
|---|---|---|
| Analytics dashboard | A funnel + traffic view of your experience, near real-time | Near real-time |
| Daily conversion file | Every conversion with order details, your partner code, and the utm_campaign value — for marketing attribution. Delivered by email or SFTP/FTP. | Daily |
| Monthly commission report | Detail on every conversion and the payments owed to you, including partner code and utm_campaign. | Monthly |
Daily conversion file — fields
Order ID · Conversion DateTime · Estimated Conversion Value · Customer Name · UTM Campaign · Referral Code (your partner code) · Term Length · Start Date · Annual Usage · Customer Type (RESIDENTIAL / BUSINESS).
Related
- Embedded checkout — where the attributed conversion happens.