Affiliate Tracking App Embed

Sprusify uses a Shopify theme app embed extension to enable affiliate tracking without manual theme edits.

Why Use the App Embed Extension

• No direct theme code editing required.
• Works across theme updates.
• Can be enabled or disabled from Theme Customizer.
• Includes optional debug mode for troubleshooting.

Enable the Extension

1. In Shopify Admin, open Online Store and then Themes.
2. Select Customize on the active theme.
3. Open the App embeds section.
4. Find Affiliate Tracking.
5. Toggle it on.
6. Save changes.

Optional Debug Mode

1. In Theme Customizer, click the Affiliate Tracking embed.
2. Enable debug mode.
3. Save.

Debug mode helps verify script load, referral capture, and cart attribute updates.

How Tracking Works

1. Shopper lands with an affiliate parameter, such as ref.
2. Extension records referral context in first-party cookies.
3. Extension updates cart attributes with affiliate context.
4. Order webhook processing reads attribution context.
5. Sprusify creates conversion records and earnings states.

Validation Checklist

1. Open storefront and confirm tracking script is present.
2. Test a referral URL in an incognito window.
3. Confirm affiliate cookie is set.
4. Place a test order.
5. Confirm conversion appears in Sprusify.

Common Issues

• Embed not visible in Theme Customizer:

  • Confirm extension is deployed with your app version.
  • Refresh the customizer after deployment.

• Clicks recorded but no order attribution:

  • Confirm affiliate is active and mapped to an eligible program.
  • Verify order includes affiliate-related cart or note attributes.
  • Check webhook delivery and processing logs.

Deployment Notes

• Deploying app updates also deploys extension updates.
• If extension behavior changes, redeploy and retest with an incognito session.

Privacy Notes

• Uses first-party cookies for attribution context.
• Avoid storing sensitive personal data in tracking cookies.