Setup & Integration

Multi-Site Tracking Architecture

Design a scalable tracking structure for products operating across multiple sites, domains, or environments.

As products grow, tracking often extends beyond a single website.

Marketing pages, application dashboards, checkout systems, partner environments, and regional deployments may all contribute to the same user journey.

A clear multi-site tracking architecture helps maintain attribution accuracy and data consistency.

Defining Site Boundaries

Each tracked surface can be represented as a distinct site context within OneLence.

Typical examples include:

  • marketing website
  • SaaS application domain
  • checkout or payment environment
  • regional or language-specific deployments
  • partner or white-label storefronts

Using a dedicated site_id for each logical surface enables clearer funnel analysis and campaign attribution auditing.

Maintaining Attribution Continuity

When users navigate between sites, attribution signals should remain consistent.

To support continuity:

  • align cross-domain cookie configuration across controlled domains
  • ensure consistent SDK initialization timing
  • preserve visitor identifiers during controlled redirects
  • validate attribution persistence during staging tests

Hybrid browser-plus-server tracking is recommended when journeys span external checkout or payment providers.

Environment Segmentation

Tracking behaviour should be clearly separated between environments such as:

  • production
  • staging
  • development
  • preview deployments

Using environment-specific tracking keys or site identifiers helps prevent:

  • attribution contamination
  • misleading campaign performance signals
  • debugging complexity during release cycles

Multi-Tenant and White-Label Considerations

Platforms supporting multiple customer workspaces or storefronts may require dynamic tracking context.

Common approaches include:

  • overriding site_id per tenant event
  • associating partner domains with distinct tracking configurations
  • routing server-validated conversion events through tenant-aware pipelines

Careful governance ensures attribution data remains interpretable at both global and tenant levels.

Planning for Long-Term Data Reliability

A well-designed tracking architecture should be documented alongside product infrastructure decisions.

Recommended practices include:

  • defining naming conventions for site identifiers
  • aligning marketing campaign link structures with domain strategy
  • periodically auditing attribution data integrity
  • combining browser and server tracking for high-value conversions

Scalable tracking design reduces re-implementation effort as marketing complexity and product surface area expand.