About Referral Links and Attribution
The Referral Links and Attribution module enables administrators to track, measure, and reward partner-driven referrals and leads. This privacy-compliant tracking system automatically attributes web form submissions and lead generation activity to the correct referring partner contact, bridging the gap between marketing engagement, partner activity, and CRM-level reporting.
Referral Links and Attribution transforms traditional manual deal registration processes into automated, data-driven partner attribution that maintains accuracy across multiple touchpoints while ensuring compliance with privacy regulations and providing defensible data chains for lead ownership and partner ROI measurement.
Core Functionality
Automated Partner Attribution
Unique Referral Links: Each partner receives a unique referral URL generated within the Magentrix portal. When prospects click these links, Magentrix automatically tracks the referring partner and maintains attribution throughout the prospect's journey across your website.
Privacy-Compliant Tracking: The script stores a persistent identifier in the visitor's browser to maintain attribution across pages. By default this identifier is stored in a browser cookie; when cookie-less mode is enabled in Referral Settings, the identifier is stored in localStorage instead. A device fingerprint (canvas, user agent, timezone) is also captured to help correlate referrals and detect duplicate submissions.
Cross-Page Attribution Persistence: Once a visitor clicks a partner's referral link, the attribution persists across multiple pages within your website. Prospects can explore different pages, return later, and complete forms on different landing pages while maintaining accurate partner attribution.
Flexible Attribution Models
First-Click Attribution: Credit is assigned to the first partner whose referral link the prospect clicked. This model rewards partners who generate initial awareness and introduce prospects to your organization.
Last-Click Attribution: Credit is assigned to the most recent partner whose referral link the prospect clicked before conversion. This model rewards partners who provide the final influence that drives prospect action.
Configurable Selection: Administrators select the attribution model that aligns with their partner program objectives and can adjust the model as business requirements evolve.
Lead Creation and CRM Integration
Flexible Lead Creation Options: Organizations can configure the system to either automatically create CRM leads when referrals are submitted, or integrate with existing form systems (HubSpot, Marketo, custom HTML forms) that handle lead creation independently while still maintaining partner attribution.
Automatic Partner Association: When a Lead is created, the system populates the configured Partner Contact lookup field, sets the Lead owner, and marks the Lead as a partner-submitted referral. The full UTM set (campaign, source, medium, term, content), device fingerprint, IP address, and the originating partner are stored on the Referral record for reporting and audit.
Campaign Integration: UTM campaign parameters from referral links can automatically associate leads with CRM campaigns, enabling multi-dimensional attribution reporting that connects partner activity to marketing campaign performance.
Tracking Mechanism and Data Capture
PartnerTrack.js Implementation: A lightweight JavaScript tracking script is deployed to your website landing pages and form pages. On page load, the script captures attribution data (referring partner, UTM parameters, device fingerprint) and persists it locally. It only transmits data to the Magentrix server when a form submission is triggered — general browsing activity is never sent.
Comprehensive Referral Data: Each referral event captures customer contact information (name, email), a customer key, a unique session key, the device fingerprint, marketing attribution parameters (UTM campaign, source, medium, term, content), the visitor's IP address, user agent, and referring partner details to create a complete audit trail.
Anti-Fraud Protection: Built-in duplicate detection automatically rejects repeat submissions matching the same partner and visitor combination (by unique key, fingerprint, or by the customer's name + email + customer key) so the same prospect is not counted twice toward partner attribution or rewards.
Integration Features
Multi-Platform Form Integration
Native Magentrix Forms: Direct integration with Magentrix Lead forms enables streamlined setup with minimal configuration, automatically handling partner attribution through hidden form fields and script integration.
Third-Party Marketing Platforms: Comprehensive integration support for HubSpot Forms, Marketo Forms, and standard HTML forms allows organizations to maintain existing marketing technology investments while adding partner attribution capabilities.
Developer-Friendly API: The PartnerTrack JavaScript API provides flexible integration options for custom forms and landing pages, with clear documentation and code examples supporting various implementation scenarios.
CRM and Reporting Integration
Native CRM Support: Direct integration with Salesforce, HubSpot, and other connected CRM systems ensures referral data flows seamlessly into existing sales processes, reporting dashboards, and analytics tools.
Referral Reporting: Built-in Referral Reports provide administrators with detailed visibility into partner referral activity, including submission dates, prospect information, attribution details, and conversion status across the entire partner ecosystem.
Partner-Level Analytics: Aggregate reporting at the Partner Account level enables analysis of referral performance across partner organizations, supporting partner program management, incentive calculations, and strategic planning.
Security and Access Control
Administrator-Only Configuration: Referral Settings configuration is restricted to administrators to ensure proper setup, maintain data integrity, and prevent unauthorized modifications to tracking behavior and attribution logic.
CORS Domain Allowlist: For browsers on partner-facing websites to successfully post referral data back to Magentrix, the originating domain must be added to the portal's CORS allowlist under Setup > Whitelisted CORS. Add each domain in full scheme + host form (for example, https://www.your-site.com). This is a portal-wide setting shared with other cross-origin integrations, not specific to referral tracking. Note that the allowlist is a browser-enforced control; treat the embed snippet as something to deploy only on sites you control, since it contains your portal's API key.
Permission-Based Partner Access: Partners access their unique referral links through the portal's Pipeline module, with role-based permissions ensuring appropriate access to referral link generation and performance reporting.
Common Use Cases
Partner-Driven Lead Generation
Referral Programs: Enable partners to share referral links with their customers and contacts, automatically attributing resulting leads to the referring partner for recognition, rewards, or commission calculation.
Co-Marketing Campaigns: Track partner participation in co-branded marketing campaigns by providing unique referral links for specific initiatives, enabling measurement of campaign effectiveness and partner contribution.
Influencer and Affiliate Programs: Extend attribution capabilities beyond traditional channel partners to influencers, affiliates, and brand advocates who drive awareness and lead generation through content marketing and social promotion.
Multi-Touch Attribution Scenarios
Partner Collaboration Tracking: In complex sales environments where multiple partners may influence a single prospect, the attribution model determines credit assignment while maintaining visibility into all partner touchpoints.
Long Sales Cycle Management: For organizations with extended sales cycles, persistent attribution ensures partners receive credit even when prospects engage over weeks or months before converting to leads.
Cross-Channel Campaign Measurement: Combine referral attribution with UTM parameter tracking to analyze how partner referrals perform across different marketing channels, content types, and campaign strategies.
Revenue Recognition and Partner Payouts
Commission Automation: Accurate partner attribution provides the data foundation for automated commission calculations, payout management, and partner incentive programs tied to verifiable lead generation activity.
Performance-Based Partnerships: Support tiered partner programs where benefits, resources, and recognition are tied to measurable referral performance and lead contribution to organizational pipeline.
ROI Measurement: Demonstrate partner program value by connecting partner-attributed leads through the entire customer lifecycle, from initial referral through opportunity creation, revenue realization, and customer lifetime value.
Administrative Management
Configuration and Customization
Enable/Disable Functionality: Administrators control whether referral tracking is active across the portal, enabling phased rollouts or temporary suspension without removing configuration settings.
Lead Creation Control: Configurable lead creation options allow organizations to choose whether Magentrix automatically generates CRM leads or integrates with existing lead capture systems while maintaining attribution.
Script Deployment Management: PartnerTrack.js script generation and deployment is managed through the administrative interface, with automatic script updates when configuration changes require redeployment.
Marketing Link Management
Centralized Link Repository: Marketing destinations are stored in the Document Library, providing centralized control over destination URLs and UTM parameters. Partner-facing referral-link assignments are configured on Summary Pages, which reference the underlying Document Library entries.
Campaign-Specific Links: Create multiple marketing links for different campaigns, products, or audience segments while maintaining unified tracking and attribution across all partner referral activity.
Link Distribution Controls: Administrators manage which partners have access to specific marketing links through the Pipeline interface, supporting targeted campaigns and segmented partner engagement strategies.
Ongoing Monitoring and Optimization
Real-Time Referral Visibility: Monitor incoming referrals through the Referral Reports interface, providing immediate visibility into partner activity, prospect engagement, and attribution accuracy.
Attribution Model Adjustment: Adjust attribution models based on partner program evolution and business requirements, with clear understanding that model changes require script redeployment to affected web properties.
Performance Analysis: Analyze referral patterns, conversion rates, and partner contribution to identify high-performing partners, optimize marketing link strategies, and refine partner engagement approaches.
Best Practices and Recommendations
Implementation Planning
Pilot Testing Approach: Deploy referral tracking initially to a limited set of landing pages and partner cohorts to validate tracking accuracy, test attribution logic, and optimize configuration before broad rollout.
Clear Partner Communication: Provide partners with clear guidance on how to use referral links, what attribution means for their recognition and rewards, and how to access their unique links within the portal.
Integration Coordination: Coordinate referral tracking implementation with marketing operations, web development, and CRM administration teams to ensure seamless integration with existing systems and workflows.
Link Management Strategy
Consistent Link Distribution: Avoid regenerating referral links unnecessarily, as each link change creates new tracking identifiers that may fragment reporting and partner performance analysis.
Campaign Naming Conventions: Establish clear, consistent naming conventions for UTM campaigns to support accurate campaign-to-CRM mapping and maintain clean, analyzable marketing attribution data.
Link Lifespan Understanding: Educate partners that referral links remain valid indefinitely and that attribution persists across prospect sessions until browser data is cleared or devices change.
Data Quality and Integrity
Regular Attribution Validation: Periodically review referral reports and CRM lead data to ensure attribution is functioning correctly, partners are being credited appropriately, and no technical issues are disrupting tracking.
Duplicate Detection Monitoring: Monitor for patterns that might indicate duplicate submissions or fraudulent activity, leveraging built-in fingerprint detection to maintain data integrity.
CRM Field Mapping Verification: Ensure Partner Contact lookup fields and Lead Source values are correctly populated in your CRM to support accurate reporting, sales workflows, and partner recognition programs.
Limitations and Considerations
Technical Requirements
JavaScript Dependency: Referral tracking requires JavaScript to be enabled in prospect browsers and functioning properly on landing pages. Prospects with JavaScript disabled will not be tracked.
Domain Scope: Browser-based referral submissions require both that the tracking script is deployed on the page and that the originating domain is on the portal's CORS allowlist (Setup > Whitelisted CORS). Otherwise the submission may reach the server but the form-page script can't read the response and the form may report an error.
Script Maintenance: Changes to attribution models or cookie-less tracking settings require script redeployment to all affected web properties, requiring coordination with web development teams.
Attribution Boundaries
Single Partner Attribution: The system attributes each lead to one partner based on the configured attribution model (first-click or last-click). Multi-partner credit sharing is not supported in the standard implementation.
Session-Based Tracking: Attribution persists based on device fingerprints, which can be cleared by browser data deletion, private browsing mode, or device changes, potentially affecting long-term attribution in some scenarios.
Cross-Domain Limitations: Attribution does not automatically persist across different domains. If prospects move from a tracked domain to an untracked domain, attribution context may be lost unless both domains are properly configured.
Integration Constraints
CRM-Specific Configuration: Lead creation and field mapping configurations may vary based on your connected CRM system (Salesforce, HubSpot, Dynamics, etc.), requiring CRM-specific setup and testing.
Campaign Mapping Complexity: Automatic campaign association from UTM parameters works only when the utm_campaign value exactly matches a single CRM Campaign by name (case-sensitive). If no campaign or multiple campaigns match, no CampaignMember record is created. Establish clear, agreed naming with marketing operations to keep this mapping reliable.
Form Platform Variations: Third-party form integrations (HubSpot, Marketo) require custom JavaScript implementation that may need updates when those platforms change their form rendering or API specifications.
The Referral Links and Attribution module provides comprehensive partner attribution capabilities that connect marketing engagement, partner activity, and CRM outcomes into defensible data chains supporting partner recognition, program optimization, and revenue attribution across your entire partner ecosystem.
Agentic Wizards Support
Referral data is available to Agentic Wizards, allowing partners to ask the Magentrix Assistant for their referral links and recent referral activity in natural language — for example, "What's my referral link for the Spring campaign?" or "How many referrals did I generate this month?"
What it enables:
- Partner self-service: Partners can retrieve their unique referral links and review their referral activity from any assistant-enabled surface, without navigating to the portal.
- Read-only access: Referral information is surfaced as it stands. Configuring referral settings, marketing links, and reporting remain administrative actions performed in the portal.
Scope: This is a partner-facing capability. Administrators continue to configure referral settings, marketing links, and reporting through the portal.
Availability: Available on portals with the Partner Attribution feature enabled and Agentic Wizards turned on in AI Assistant Settings.
Referral Links and Attribution Checklist >>