Skip to main content
Common questions about DATALYR setup, tracking, integrations, and billing.

​
General

​
What is DATALYR?

DATALYR is a marketing attribution platform that tracks user behavior and sends conversion data to ad platforms (Meta, Google, TikTok) to improve ad targeting and reporting.

​
How is DATALYR different from Google Analytics?

Google Analytics: Tracks website visitors and behavior for reporting. DATALYR: Tracks attribution data and sends conversions to ad platforms to optimize ad delivery. Use both: GA for internal reporting, DATALYR for ad optimization.

​
Do I need to remove my existing analytics?

No. DATALYR works alongside Google Analytics, Meta Pixel, and other tools.

​
What platforms does DATALYR integrate with?

Ad Platforms:
  • Meta Ads (Facebook/Instagram)
  • Google Ads
  • TikTok Ads
E-commerce:
  • Shopify
  • Stripe
Data Sources:
  • Website (JavaScript SDK)
  • Server (Node.js SDK)
  • Mobile (iOS, React Native SDKs)

​
Tracking & Installation

​
How do I install DATALYR?

Web: Copy tracking script from Settings → Tracking Script and paste in <head> tag. See Installation Guide. Mobile: Install SDK for your platform (iOS, React Native). See Mobile SDKs.

​
Where should I place the tracking script?

Place in <head> section of every page, before closing </head> tag. Example: 
<head>
  <!-- Other tags -->
  <script defer src="https://track.datalyr.com/dl.js"
    data-workspace-id="your_workspace_id">
  </script>
</head>

​
Does DATALYR work with single-page apps?

Yes. DATALYR automatically tracks navigation in SPAs (React, Vue, Angular, Next.js). Enable in SDK initialization: 
datalyr.init({
  workspaceId: 'your_workspace_id',
  trackSPA: true
});

​
Will DATALYR slow down my website?

No. Script uses defer attribute to load asynchronously without blocking page render. Size is ~15-20KB minified and gzipped.

​
Can I track multiple domains?

Yes. Enable cross-domain tracking in Settings → Advanced → Cross-Domain Tracking. See Cross-Domain Tracking.

​
Does DATALYR work with Shopify checkout?

Yes, but requires additional setup for Shopify Plus stores. See Shopify Checkout Tracking. For standard Shopify, use App Store installation which handles checkout automatically.

​
Attribution & Conversions

​
How does attribution work?

DATALYR captures click IDs (gclid, fbclid, ttclid) when users click ads, stores them in cookies, then attributes conversions back to the ad when user converts. See How Attribution Works.

​
What is a click ID?

Unique identifier added to URL when user clicks ad:
  • Google: gclid
  • Meta: fbclid
  • TikTok: ttclid
DATALYR stores click ID and uses it to attribute conversions.

​
How long does attribution last?

Default: 30 days from click Platform Limits:
  • Meta: 7-day click
  • Google: 90-day click
  • TikTok: 28-day click
Conversion must occur within platform’s window to be attributed.

​
What is a conversion?

Event that represents valuable action (purchase, signup, etc.) sent to ad platforms to optimize ad delivery.

​
How do I track conversions?

  1. Track event in DATALYR
  2. Create Conversion Rule
  3. Map event to ad platforms
See Conversion Rules.

​
Why aren’t my conversions showing in ad platforms?

Common causes:
  • Conversion Rule not configured
  • Integration not connected
  • No click ID captured
  • Outside attribution window
See Missing Conversions.

​
Can I track revenue with conversions?

Yes. Include revenue in event: 
datalyr.track('purchase', {
  revenue: 99.99,
  currency: 'USD'
});

​
What attribution model does DATALYR use?

Last-click attribution by default. User attributed to most recent ad click before conversion. Multi-touch attribution available for tracking full customer journey. See Attribution Models.

​
Integrations

​
How do I connect ad platforms?

  1. Go to Integrations → [Platform]
  2. Click “Connect”
  3. Authorize DATALYR in OAuth popup
  4. Select ad account
  5. Save
See integration guides: Meta, Google, TikTok.

​
Do I need to remove Meta Pixel?

No. Keep both installed. DATALYR automatically deduplicates conversions between pixel and CAPI using event IDs.

​
How often does data sync?

Real-time:
  • Website events (seconds)
  • Shopify webhooks (seconds)
  • Stripe webhooks (seconds)
Batch:
  • Ad platform conversions (15 minutes)

​
Can I disconnect integrations?

Yes. Integrations → [Platform] → Disconnect. Historical data retained, stops syncing new data.

​
What happens if integration expires?

OAuth tokens expire after 60-90 days. You’ll receive email notification. Reconnect in Integrations page.

​
Do I need Shopify Plus?

No. Basic Shopify and higher supported. Shopify Plus offers additional checkout customization options.

​
Data & Privacy

​
Is DATALYR GDPR compliant?

Yes. DATALYR provides:
  • Cookie consent management
  • IP anonymization
  • Do Not Track respect
  • Data deletion on request
Configure in Settings → Privacy.

​
What data does DATALYR collect?

Automatic:
  • Pageviews and navigation
  • Device information (browser, OS)
  • Attribution data (UTM params, click IDs)
  • Session data
Optional:
  • User identification (email, user ID)
  • Custom event properties
Not Collected:
  • Passwords
  • Credit card numbers
  • Personal conversations

​
Where is data stored?

Data stored in secure cloud infrastructure with encryption at rest and in transit. Data Centers:
  • United States (primary)
  • Europe (available on request)

​
Can I export my data?

Yes. Use Event Stream or contact [email protected] for bulk export.

​
How long is data retained?

Default: Indefinitely Custom: Set retention period (Enterprise plans). Contact [email protected] to configure.

​
Can users opt out of tracking?

Yes. Use opt-out functionality: 
datalyr.optOut();  // Stops tracking
datalyr.optIn();   // Resumes tracking

​
Does DATALYR use cookies?

Yes. Cookies used for:
  • Visitor identification
  • Session tracking
  • Attribution data storage
All first-party cookies on your domain.

​
Billing & Plans

​
How much does DATALYR cost?

Plans:
  • Starter: $49/month (50K events)
  • Growth: $199/month (250K events)
  • Scale: $399/month (1M events)
  • Enterprise: Custom pricing
See Pricing.

​
What counts as an event?

  • Pageviews
  • Custom events you track
  • Shopify orders
  • Stripe payments
Not Counted:
  • System events
  • Failed events
  • Duplicates

​
What are overage charges?

If you exceed plan limits:
  • $2 per 1,000 additional events
  • $2 per 1,000 additional conversions sent to ad platforms

​
Can I upgrade mid-month?

Yes. Upgrade takes effect immediately with prorated billing.

​
How do refunds work?

No refunds for monthly plans. Can cancel anytime, access until period end.

​
Is there a free trial?

Yes. 14-day free trial with 50,000 events. No credit card required.

​
Can I cancel anytime?

Yes. Cancel in Settings → Billing. Access until period end, no further charges.

​
Technical

​
What browsers are supported?

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+
  • Mobile browsers

​
Does DATALYR work offline?

Yes. Events queue offline and send when connection restored.

​
Can I track server-side events?

Yes. Use Server SDK (Node.js) to track events from backend. See Server SDK.

​
Does DATALYR support mobile apps?

Yes. SDKs available for:
  • iOS (Swift)
  • React Native
See Mobile SDKs.

​
Can I track events from multiple domains?

Yes. Install script on all domains and enable cross-domain tracking. See Cross-Domain Tracking.

​
How do I identify users?

Call identify() after user logs in: 
datalyr.identify('user_123', {
  email: '[email protected]',
  name: 'John Doe'
});

​
Can I track custom events?

Yes. Track any event: 
datalyr.track('button_click', {
  button_name: 'signup',
  page: 'homepage'
});

​
Does DATALYR have an API?

Yes. Server SDK provides API for backend tracking. API documentation: Contact [email protected] for advanced API access.

​
Support

​
How do I contact support?

Email: [email protected] Include:
  • Workspace ID
  • Description of issue
  • Screenshots (if applicable)

​
What’s the response time?

Standard Plans: 24-48 hours Enterprise Plans: Priority support with faster response

​
Is there documentation?

Yes. Full documentation at docs.datalyr.com.

​
Can I schedule a demo?

Yes. Contact [email protected] to schedule demo with our team.

​
Do you offer onboarding?

Scale and Enterprise: Onboarding included Starter and Growth: Self-service with documentation and email support

​
Common Issues

​
Why isn’t tracking working?

See Tracking Not Working guide. Quick checks:
  1. Script in <head> tag?
  2. Workspace ID correct?
  3. Events in Event Stream?
  4. Console errors?

​
Why aren’t conversions appearing in ad platforms?

See Missing Conversions guide. Quick checks:
  1. Conversion Rule configured?
  2. Integration connected?
  3. Event has revenue/value?
  4. Click ID captured?

​
Why don’t numbers match between platforms?

See Data Discrepancies guide. Common reasons:
  • Different attribution windows
  • Time zone differences
  • Attribution model differences
  • 5-15% variance normal

​
How do I debug postback failures?

See Postback Debugging guide. Check Event Stream → Event details → Postbacks section for error messages.

​
Still Have Questions?

Resources: Popular Guides:

Quick Start

Get started in 5 minutes

Installation

Install tracking script

Conversion Rules

Configure conversions

Troubleshooting

Fix common issues