Click ID Restorer — Server-side Click ID restoration

What is the Click ID Restorer?

The Click ID Restorer is an add-on that solves the problem of losing Click IDs (gclid, fbclid, ttclid, etc.) due to iOS tracking prevention and Safari ITP. It automatically restores Click IDs server-side and adds them back to the query string.

The problem: iOS Tracking Prevention

• iOS 14.5+ Safari removes Click IDs from the URL after clicking an ad
• ?fbclid=xxx → disappears during the redirect
• Meta/Google loses attribution → "direct traffic"
• Result: Inaccurate ROAS, poor campaign optimization

The solution: Server-side restoration

1. The first request with ?fbclid=xxx → DataNostro saves the Click ID to a server-side cookie
2. A second request without a Click ID → DataNostro restores the Click ID from the server-side cookie
3. The request is redirected to a URL with the restored Click ID
4. GA4/Meta/TikTok sees the Click ID and attributes the conversion correctly

How to activate

1. Go to Dashboard → Add-ons
2. Turn on the "Click ID Restorer" toggle
3. Configure the Click ID mappings (or use the defaults)
4. Click "Save Click ID mappings"

Supported Click IDs

# Google Ads
gclid → _gcl_aw (cookie)

# Meta (Facebook/Instagram)
fbclid → _fbc (cookie)

# TikTok
ttclid → _ttp (cookie)

# Microsoft Ads
msclkid → _uetsid (cookie)

# LinkedIn
li_fat_id → li_fat_id (cookie)

Custom Click ID mappings

You can add custom Click ID mappings for custom platforms:

mycustomclid → _my_custom_cookie
partnerclid → _partner_click_id

How does it work technically?

1. A request arrives at nginx: GET /page?fbclid=abc123
2. Nginx proxy_pass → DataNostro tracking middleware
3. The middleware detects fbclid=abc123
4. Saves it to a server-side cookie: _dn_fbclid=abc123; Max-Age=2592000 (30 days)
5. The next request arrives WITHOUT fbclid: GET /page
6. The middleware detects the missing fbclid, but finds the _dn_fbclid cookie
7. Redirects to: 302 /page?fbclid=abc123
8. Meta Pixel/GA4 sees the fbclid and attributes the conversion correctly

Compatibility

• ✅ Safari (iOS 14.5+, macOS Big Sur+)
• ✅ Firefox (Enhanced Tracking Protection)
• ✅ Brave Browser (Shields Up)
• ✅ Edge (Tracking Prevention)