> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Frequently Asked Questions
> Common questions about DATALYR attribution tracking
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 & Revenue:**
* Shopify
* Stripe
* Superwall
* RevenueCat
**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 `` tag.
See [Installation Guide](/getting-started/installation/overview).
**Mobile:**
Install SDK for your platform (iOS, React Native).
See [Mobile SDKs](/sdks/mobile).
### Where should I place the tracking script?
Place in `` section of every page, before closing `` tag.
**Example:**
```html theme={null}
```
### Does DATALYR work with single-page apps?
Yes. DATALYR automatically tracks navigation in SPAs (React, Vue, Angular, Next.js).
Enable in SDK initialization:
```javascript theme={null}
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](/understanding-data/cross-domain-tracking).
### Does DATALYR work with Shopify checkout?
Yes, but requires additional setup for Shopify Plus stores.
See [Shopify Checkout Tracking](/getting-started/installation/platforms/shopify-manual#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](/introduction/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](/integrations/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](/troubleshooting/missing-conversions).
### Can I track revenue with conversions?
Yes. Include revenue in event:
```javascript theme={null}
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](/understanding-data/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](/integrations/meta-ads), [Google](/integrations/google-ads), [TikTok](/integrations/tiktok-ads).
### 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 [hello@datalyr.com](mailto:hello@datalyr.com) for bulk export.
### How long is data retained?
**Default:** Indefinitely
**Custom:** Set retention period (Enterprise plans).
Contact [hello@datalyr.com](mailto:hello@datalyr.com) to configure.
### Can users opt out of tracking?
Yes. Use opt-out functionality:
```javascript theme={null}
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 (per workspace):**
* Starter: \$79/month (250K events, 25K conversions)
* Growth: \$199/month (1.5M events, 125K conversions)
* Scale: \$399/month (5M events, 500K conversions)
* Performance: \$599/month (15M events, 1.5M conversions)
* Enterprise: Custom pricing
Shopify merchants installing via the Shopify App Store are billed through Shopify Billing on the Starter / Growth / Scale plans (same prices).
See [Pricing](/account/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 50,000 additional events
* \$2 per 10,000 additional postbacks 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. 7-day free trial on every workspace, no credit card required. Each new workspace starts a fresh trial.
### 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](/sdks/server).
### Does DATALYR support mobile apps?
Yes. SDKs available for:
* iOS (Swift)
* React Native
See [Mobile SDKs](/sdks/mobile).
### Can I track events from multiple domains?
Yes. Install script on all domains and enable cross-domain tracking.
See [Cross-Domain Tracking](/understanding-data/cross-domain-tracking).
### How do I identify users?
Call `identify()` after user logs in:
```javascript theme={null}
datalyr.identify('user_123', {
email: 'user@example.com',
name: 'John Doe'
});
```
### Can I track custom events?
Yes. Track any event:
```javascript theme={null}
datalyr.track('button_click', {
button_name: 'signup',
page: 'homepage'
});
```
### Does DATALYR have an API?
Yes. The Public API provides read-only access to all your analytics data via 14 REST endpoints. Authenticate with your SDK key (`dk_`) or Agent key (`dk_agent_`). Rate limit is 100 requests/minute. See the [API documentation](/sdks/api) for details.
### What is the AI Chat feature?
AI Chat lets you ask questions about your DATALYR data in natural language. It can query your traffic, conversions, attribution, user journeys, and ad performance. Generate an Agent API key in Settings -> API Keys to enable it.
### How do AI chat messages count toward my plan?
Every plan includes a monthly AI credit pool that you spend per message. Growth: $25/month, Scale: $50/month, Performance: $75/month, Enterprise: custom, Shopify Starter: $10/month. Top up any time from Settings → Billing if you need more inside a cycle. Unused credits don't roll over.
## Support
### How do I contact support?
Email: [hello@datalyr.com](mailto:hello@datalyr.com)
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](https://docs.datalyr.com).
### Can I schedule a demo?
Yes. Contact [hello@datalyr.com](mailto:hello@datalyr.com) to schedule demo with our team.
### Do you offer onboarding?
**Scale, Performance, and Enterprise:** 1:1 onboarding included
**Growth and Shopify Starter:** Self-service with documentation and email support
## Common Issues
### Why isn't tracking working?
See [Tracking Not Working](/troubleshooting/tracking-not-working) guide.
**Quick checks:**
1. Script in `` tag?
2. Workspace ID correct?
3. Events in Event Stream?
4. Console errors?
### Why aren't conversions appearing in ad platforms?
See [Missing Conversions](/troubleshooting/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](/troubleshooting/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](/troubleshooting/postback-debugging) guide.
Check Event Stream → Event details → Postbacks section for error messages.
## Still Have Questions?
**Resources:**
* [Documentation](https://docs.datalyr.com)
* [Blog](https://datalyr.com/blog)
* [Email Support](mailto:hello@datalyr.com)
**Popular Guides:**
Get started in 5 minutes
Install tracking script
Configure conversions
Fix common issues