fix(audience): add missing click IDs and attribution fields per event reference

Add dclid (Google DV360) and li_fat_id (LinkedIn) to match the
Tracking Pixel Event Reference doc. Also add referral_code parsing
and touchpoint_type derivation (set to 'click' when UTMs or click
IDs are present).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: bkbooth

packages/audience/pixel/src/attribution.test.ts

@@ -31,14 +31,16 @@ describe('collectAttribution', () => {
 
   it('parses ad network click IDs', () => {
     setLocation(
-      'https://example.com/?gclid=abc123&fbclid=fb456&ttclid=tt789&msclkid=ms000',
+      'https://example.com/?gclid=abc&dclid=dc1&fbclid=fb2&ttclid=tt3&msclkid=ms4&li_fat_id=li5',
     );
 
     const result = collectAttribution();
-    expect(result.gclid).toBe('abc123');
-    expect(result.fbclid).toBe('fb456');
-    expect(result.ttclid).toBe('tt789');
-    expect(result.msclkid).toBe('ms000');
+    expect(result.gclid).toBe('abc');
+    expect(result.dclid).toBe('dc1');
+    expect(result.fbclid).toBe('fb2');
+    expect(result.ttclid).toBe('tt3');
+    expect(result.msclkid).toBe('ms4');
+    expect(result.li_fat_id).toBe('li5');
   });
 
   it('captures referrer and landing page', () => {
@@ -65,6 +67,35 @@ describe('collectAttribution', () => {
     expect(second.utm_source).toBe('google');
   });
 
+  it('parses referral_code from the URL', () => {
+    setLocation('https://example.com/?referral_code=PARTNER42');
+
+    const result = collectAttribution();
+    expect(result.referral_code).toBe('PARTNER42');
+  });
+
+  it('sets touchpoint_type to click when UTMs are present', () => {
+    setLocation('https://example.com/?utm_source=google');
+
+    const result = collectAttribution();
+    expect(result.touchpoint_type).toBe('click');
+  });
+
+  it('sets touchpoint_type to click when a click ID is present', () => {
+    setLocation('https://example.com/?gclid=abc123');
+
+    const result = collectAttribution();
+    expect(result.touchpoint_type).toBe('click');
+  });
+
+  it('does not set touchpoint_type when no UTMs or click IDs are present', () => {
+    setLocation('https://example.com/');
+    Object.defineProperty(document, 'referrer', { value: 'https://other.com', configurable: true });
+
+    const result = collectAttribution();
+    expect(result.touchpoint_type).toBeUndefined();
+  });
+
   it('returns empty attribution when no params are present', () => {
     setLocation('https://example.com/');
     Object.defineProperty(document, 'referrer', { value: '', configurable: true });

packages/audience/pixel/src/attribution.ts

@@ -8,9 +8,11 @@ const UTM_PARAMS = [
 
 const CLICK_ID_PARAMS = [
   'gclid',
+  'dclid',
   'fbclid',
   'ttclid',
   'msclkid',
+  'li_fat_id',
 ] as const;
 
 const STORAGE_KEY = '__imtbl_attribution';
@@ -22,11 +24,15 @@ export interface Attribution {
   utm_content?: string;
   utm_term?: string;
   gclid?: string;
+  dclid?: string;
   fbclid?: string;
   ttclid?: string;
   msclkid?: string;
+  li_fat_id?: string;
+  referral_code?: string;
   referrer?: string;
   landing_page?: string;
+  touchpoint_type?: string;
 }
 
 type AttributionKey = keyof Attribution;
@@ -46,6 +52,12 @@ function parseParams(url: string): Attribution {
       result[key as AttributionKey] = value;
     }
   }
+
+  const referralCode = params.get('referral_code');
+  if (referralCode) {
+    result.referral_code = referralCode;
+  }
+
   return result;
 }
 
@@ -79,10 +91,14 @@ export function collectAttribution(): Attribution {
     ? window.location.href
     : undefined;
 
+  const hasClickId = CLICK_ID_PARAMS.some((key) => key in urlParams);
+  const hasUtm = UTM_PARAMS.some((key) => key in urlParams);
+
   const attribution: Attribution = {
     ...urlParams,
     referrer,
     landing_page: landingPage,
+    touchpoint_type: hasClickId || hasUtm ? 'click' : undefined,
   };
 
   saveToStorage(attribution);