BEAM Test Mode

Comprehensive click ID attribution testing system for complete journey tracing from first visit to conversion. Test attribution flows across all advertising platforms with detailed logging and validation.

BEAM Test Mode - Operational

Tested and verified on live production sites with full attribution tracking.

Overview

BEAM Test Mode provides comprehensive click ID attribution testing, allowing you to test complete attribution flows from first visit to conversion with full journey tracing across all advertising platforms.

Live Site Verified

Tested on live production sites with LinkedIn attribution and confirmed working for conversion tracking.

Quick Start Testing

Test any website instantly by adding beam-test=true with click ID parameters to any URL.

Live Site Examples

# LinkedIn Attribution test
https://yoursite.com/page?beam-test=true&li_fat_id=test_linkedin_123
# Verified working for conversion events

Multi-Platform Testing

# Test multiple platforms simultaneously
https://example.com/page?beam-test=true&gclid=test_123&fbclid=test_456&msclkid=test_789

Supported Click ID Parameters

gclid
Google Ads
Ready
fbclid
Meta/Facebook
Ready
msclkid
Microsoft Ads
Ready
ttclid
TikTok Ads
Ready
li_fat_id
LinkedIn Ads
Verified
twclid
Twitter Ads
Ready
pin_click_id
Pinterest Ads
Ready

Test Mode Features

When beam-test=true is detected, all Tandem Beam components automatically:

Enhanced Logging

[BEAM TEST] prefixed logs for easy identification across all components.

Click ID Extraction

Automatic detection and processing of click IDs across all supported platforms.

Master Trace IDs

Complete journey correlation from visit to conversion with searchable trace IDs.

Real-time Monitoring

Live test trace tracking with status indicators and follow mode support.

Component Integration

The BEAM Test Mode works seamlessly across all Tandem Beam components:

SkyBeam Workers
Cloudflare Edge Workers

Automatic test mode detection with comprehensive logging and click ID processing.

ClickBeam Client
Client-side JavaScript

Enhanced console logging and test data capture with automatic click ID extraction.

API Controllers
Laravel Backend

Complete server-side test processing with trace integration and click ID validation.

Database
Test Metadata Storage

Test metadata persistence with journey correlation and searchable is_test flags.

Production Fixes Applied

TrackingController Enhancement (August 8, 2025)

  • Issue: Click ID validation failed due to browser_data format mismatch
  • Solution: Enhanced test mode to inject click IDs into proper browser_data format
  • Result: All conversion events now track successfully
  • Backend Processing: Tandem Beam automatically processes test events with enhanced validation and logging

Platform Compatibility Status

LinkedIn Ads
Fully operational with li_fat_id parameter
Live verified
Multi-Platform
All platforms supported with proper click ID mapping
Operational
Live Testing
Verified on production deployment
Available

DEV+NULL Testing Platform

The DEV+NULL platform is a safe testing destination that captures your transformed event payloads without sending data to external advertising platforms. Perfect for validating your tracking setup.

Benefits

  • Zero risk - no real data sent to ad platforms
  • Inspect transformed payloads before production
  • Test event mappings and configurations
  • Validate PII hashing and data transformations
  • Debug platform adapter issues safely

Use Cases

  • • Testing new event configurations
  • • Validating conversion tracking setup
  • • Training and onboarding
  • • Debugging attribution issues
  • • Pre-production validation

Setup Steps

1

Add DEV+NULL Platform

Go to Platform Configurations → Add New Configuration → Select "DEV+NULL"

2

Optional: Add Label

Provide a display label to identify this test destination (e.g., "Testing Setup", "QA Environment")

3

Send Test Events

Events configured to send to DEV+NULL will be captured and stored for inspection

4

Inspect Captured Events

View captured events in the Attribution Dashboard or via the DEV+NULL events API

Testing Platform Only

DEV+NULL does not send data to external advertising platforms. Use it for testing and validation only. Configure real platforms (Meta, Google Ads, etc.) when you're ready for production conversion tracking.

Next Steps

Ready to start testing? Here are some recommended next steps:

1. Quick URL Test

Test any URL instantly by adding beam-test parameters.

Copy Test Parameters

2. Run Journey Test

Execute complete attribution journey testing.

Copy Multi-Platform Test