Integration Errors

​

Quick Diagnostic

1. Go to Integrations → Overview
2. Look for each integration’s status
3. Check “Last Sync” timestamp

• Connected: Working properly
• Disconnected: Not connected or expired
• Error: Connection issue or sync failure
• Syncing: Currently pulling data

​

Common Integration Errors

​

”OAuth Connection Expired”

• Integration shows “Disconnected”
• Conversions not sending to platform
• Error: “Access token expired”

1. Go to Integrations → [Platform]
2. Click “Reconnect”
3. Authorize DATALYR again in popup
4. Verify “Connected” status

​

”Invalid Access Token”

• Integration connects but immediately fails
• Postbacks show “Failed” status
• Error: “Invalid OAuth 2.0 Access Token”

• Token revoked in ad platform
• User permissions changed
• Account access removed

1. Go to Meta Business Settings
2. System Users → Check DATALYR has admin access
3. Reconnect in DATALYR

1. Go to Google Account Permissions
2. Remove DATALYR access
3. Reconnect in DATALYR (grants fresh token)

1. Go to TikTok Business Center
2. Settings → Authorized Apps → Remove DATALYR
3. Reconnect in DATALYR

​

”Missing Required Permissions”

• Connection succeeds but features don’t work
• Can’t send conversions
• Error: “Insufficient permissions”

• ads_management
• business_management

• Google Ads API access
• Conversion tracking permissions

• Event Management
• Ad Account access

1. Disconnect integration
2. Reconnect using admin account with full permissions
3. Grant all requested permissions during OAuth

​

”Account Not Found”

• Can’t select ad account during setup
• Error: “No eligible accounts found”

• Wrong account used for OAuth
• Ad account not accessible to user
• Business Manager not configured

• Meta Business Manager account
• Ad account you want to track

• Use account with Google Ads access
• Verify ad account ID is correct

• Use TikTok Business Center admin account
• Verify ad account is active

​

Shopify Integration Errors

​

”Store Not Accessible”

• Can’t connect Shopify store
• Error: “Unable to access store”

• Wrong store URL
• Store not on paid plan
• App not installed

1. Visit Shopify App Store
2. Search “DATALYR”
3. Install app
4. Authorize access

​

”Webhook Delivery Failed”

• Integration connected
• Orders not syncing
• Error in webhook logs

• Webhook URL blocked
• Shopify webhook limit reached
• Store firewall blocking requests

1. Shopify Admin → Settings → Notifications
2. Scroll to Webhooks
3. Look for DATALYR webhooks
4. Verify status is “Active”

1. DATALYR: Disconnect Shopify
2. Wait 1 minute
3. Reconnect Shopify (recreates webhooks)

​

“Missing Order Data”

• Orders syncing
• Revenue or products missing
• Incomplete data

• Order status not “paid”
• Custom checkout fields not mapped
• Product metadata missing

1. Shopify → Products → Select product
2. Metafields → Add “cost_per_item”
3. Enter cost value

​

”CORS Error”

• Shopify Web Pixels installation
• Browser console: “CORS policy error”

​

Stripe Integration Errors

​

”Invalid API Key”

• Can’t connect Stripe
• Error: “API key invalid”

• Wrong API key type
• Key from test mode
• Key revoked

1. Go to Settings → Integrations
2. Disconnect the existing Stripe connection
3. Click “Connect” to start a new OAuth flow
4. Authorize DATALYR in Stripe
5. Verify the connection shows “Connected”

​

”No Events Found”

• Stripe connected
• Zero payments in DATALYR
• Error: “No events to sync”

• No recent payments
• Wrong event types tracked
• API key permissions too restrictive

1. Stripe Dashboard → Developers → Events
2. Look for charge.succeeded events
3. Verify events exist in last 30 days

​

”Customer Metadata Missing”

• Payments syncing
• Not attributed to website visitors
• All showing as “Direct”

• Customer metadata not set
• Anonymous ID not passed to Stripe

const anonymousId = datalyr.getAnonymousId();

const customer = await stripe.customers.create({
  email: '[email protected]',
  metadata: {
    datalyr_visitor_id: anonymousId,
    datalyr_user_id: userId  // Optional
  }
});

​

”MRR Calculation Incorrect”

• Subscriptions syncing
• MRR showing wrong amount

• Baseline not set
• Mixed intervals (monthly, annual)
• Duplicate subscriptions

1. Integrations → Stripe
2. Click “Reset MRR Baseline”
3. Takes snapshot of current MRR
4. Future changes calculated from baseline

• Annual: Amount / 12
• Quarterly: Amount / 3
• Weekly: Amount * 4.33

​

Ad Platform Integration Errors

​

Meta Ads

• Pixel ID incorrect
• Dataset deleted
• No access to pixel

1. Meta Events Manager → Data Sources
2. Find your pixel
3. Copy pixel ID
4. Update in DATALYR → Integrations → Meta

​

Google Ads

• Wrong conversion action name
• Conversion action deleted
• Wrong account linked

1. Google Ads → Tools → Conversions
2. Copy exact conversion action name
3. Update in DATALYR Conversion Rule

1. Google Ads → Tools → Conversions
2. Select conversion action
3. Settings → Enhanced conversions → Turn on

• Email not SHA-256 hashed
• Email format incorrect
• User not in Google audience

datalyr.track('purchase', {
  revenue: 99.99,
  email: '[email protected]'  // DATALYR hashes automatically
});

​

TikTok Ads

• Pixel ID not configured
• Wrong pixel ID
• Pixel not installed

1. TikTok Ads Manager → Assets → Events
2. Copy pixel code
3. DATALYR → Integrations → TikTok → Enter pixel code

datalyr.track('purchase', {
  revenue: 99.99,
  currency: 'USD',
  contents: [
    {
      content_id: 'prod_123',
      quantity: 1,
      price: 99.99
    }
  ]
});

1. Integrations → Conversion Rules
2. Edit rule → Enable “Test Mode”
3. Send test event
4. Check TikTok Events Manager → Test Events

​

Superwall

1. Verify the webhook URL in Superwall Dashboard -> Settings -> Webhooks
2. Check that the DATALYR workspace is connected (Settings -> Integrations)
3. Ensure the Superwall Project ID matches your DATALYR connection
4. Check for sandbox events (only production events are processed)

1. Verify the user’s email is set in Superwall’s userAttributes
2. Check that identify() was called in the DATALYR mobile SDK before the purchase
3. Confirm the email matches between Superwall and DATALYR

​

RevenueCat

1. Verify the webhook URL in RevenueCat Dashboard -> Project Settings -> Webhooks
2. Check the Authorization header matches your DATALYR configuration
3. Ensure sandbox events are filtered (production only)

1. Verify the user’s $email is set in RevenueCat subscriber attributes
2. Check that identify() was called in the DATALYR mobile SDK
3. Confirm aliases include a non-anonymous user ID

​

Sync Frequency Issues

• Shopify: Real-time (webhooks)
• Stripe: Real-time (webhooks)
• Ad Platforms: 15 minutes (batch)

1. Disconnect integration
2. Wait 1 minute
3. Reconnect integration
4. Monitor sync status

​

Webhook Failures

• Shopify/Stripe connected
• Orders/payments not syncing
• Error logs showing failures

1. Disconnect integration
2. Reconnect (regenerates webhook secret)

​

Testing Integrations

1. Connect integration
2. Verify “Connected” status
3. Check “Last Sync” updates

​

Rate Limits

• Meta: 200 requests/hour
• Google: 2,000 requests/day
• TikTok: 1,000 requests/hour
• Shopify: 2 requests/second
• Stripe: 100 requests/second

​

Still Having Issues?

1. Integration shows “Connected”?
2. Last sync timestamp recent?
3. Permissions granted during OAuth?
4. Using correct account (admin access)?
5. Webhook endpoints accessible?
6. Test transaction completed?

• Integration name (Shopify, Stripe, Meta, etc.)
• Error message screenshot
• Integration status screenshot
• Example transaction (order ID, timestamp)
• Workspace ID

​

Next Steps