Troubleshooting Your In-App Referral Program

Where the Problem Usually Sits

If your in-app referral program is not performing as expected, the cause almost always falls into one of three groups:

• Technical issues with tracking or the widget
• Participation issues, meaning low engagement
• Conversion issues, meaning referrals arrive but do not convert

Technical Issues

Referral widget not appearing

If the widget does not show up in your product, work through these checks:

1. Check that the Reditus tracking script is correctly installed on the pages where the widget should appear.
2. Verify that the widget is enabled in your Reditus dashboard under In-App Referral settings.
3. Check your browser's developer console for JavaScript errors related to the Reditus script.
4. Make sure there are no Content Security Policy (CSP) headers blocking the Reditus domain.

Referrals not being tracked

If users report that their referrals are not being attributed:

1. Verify that the tracking script is installed on your signup page, not just on the pages where the widget is displayed.
2. Check that first-party cookies are not being blocked by your cookie consent setup.
3. Confirm that the referral link format is correct and the tracking parameter is preserved through your signup flow.
4. If you use a custom domain or a redirect, ensure the tracking parameter is passed through.

Stripe events not connecting

If referral signups are tracked but paid conversions are not appearing:

1. Verify your Stripe connection in the Reditus dashboard.
2. Check that the Stripe webhook endpoint for Reditus is active and not returning errors.
3. Confirm that the Stripe customer ID matches between the signup event and the payment event.