Skip to main content

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:

ReportWhat it gives youCadence
Analytics dashboardA funnel + traffic view of your experience, near real-timeNear real-time
Daily conversion fileEvery conversion with order details, your partner code, and the utm_campaign value — for marketing attribution. Delivered by email or SFTP/FTP.Daily
Monthly commission reportDetail 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).