Skip to main content

Automated Syncing

The automated syncing feature keeps your discounts synchronized between the Datora Multi-Discount App and Shopify's discount system, ensuring consistency and accurate tracking across your store.

What is Syncing?​

Syncing is the process of keeping discount data synchronized between:

  • The Datora Multi-Discount App database
  • Shopify's native discount system
  • Your storefront display

This ensures that all discount information is up-to-date and consistent across all systems.

Why Syncing is Important​

Data Consistency​

  • Ensures discount codes work correctly at checkout
  • Keeps usage statistics accurate
  • Maintains campaign status across systems
  • Prevents data conflicts

Real-Time Updates​

  • Campaign changes reflected immediately
  • Usage counts updated regularly
  • Status changes propagated quickly
  • Product selections synchronized

Performance Tracking​

  • Reliable conversion data
  • Correct revenue attribution
  • Up-to-date performance metrics

How Syncing Works​

Automatic Synchronization​

The app automatically syncs data at regular intervals based on your settings:

  1. Campaign Syncing

    • Active campaigns pushed to Shopify
    • Discount rules updated
    • Product selections synchronized
    • Status changes propagated

  2. Influencer Code Syncing

    • New codes created in Shopify
    • Usage statistics updated
    • Expiration dates synchronized
    • Status changes reflected

  3. Usage Data Syncing

    • Order data collected from Shopify
    • Usage counts updated in app
    • Revenue metrics calculated

Sync Frequency Options​

Configure how often syncing occurs in Settings:

  • Every 15 minutes: Most up-to-date, higher server load
  • Every hour: Balanced approach (recommended)
  • Every 6 hours: Less frequent, lighter load
  • Daily: Minimal syncing, once per day
  • Manual only: No automatic syncing

Manual Syncing​

When to Use Manual Sync​

Trigger a manual sync when:

  • You've just created a new campaign
  • Discount codes aren't appearing at checkout
  • Usage statistics seem outdated
  • After making bulk changes
  • Troubleshooting sync issues

How to Manually Sync​

  1. Open the Datora Multi-Discount App
  2. Navigate to Settings
  3. Scroll to Syncing Settings
  4. Click Sync Now button
  5. Wait for sync to complete (usually 10-30 seconds)
  6. Check confirmation message

What Gets Synced​

A manual sync updates:

  • All active campaigns
  • All influencer codes
  • Usage statistics from last 7 days
  • Product availability
  • Customer eligibility data

Sync Status Monitoring​

Viewing Sync Status​

Check the current sync status:

  1. Open Settings page
  2. Look for Syncing Settings section
  3. View Last Sync timestamp
  4. Check Sync Status indicator:
    • 🟢 Success: Last sync completed successfully
    • 🟡 In Progress: Sync currently running
    • 🔴 Failed: Last sync encountered errors

Sync History​

View detailed sync history:

  1. Navigate to Settings > Syncing
  2. Click View Sync History
  3. See list of recent syncs with:
    • Timestamp
    • Duration
    • Items synced
    • Success/failure status
    • Error messages (if any)

Sync Conflicts​

What are Sync Conflicts?​

Conflicts occur when data differs between the app and Shopify, such as:

  • Discount code modified in Shopify
  • Campaign deleted in Shopify but active in app
  • Product removed from store but in campaign
  • Usage count discrepancies

Conflict Resolution Options​

Configure in Settings how conflicts are handled:

App Wins (Recommended)

  • App data overwrites Shopify
  • Maintains app as source of truth
  • Best for most use cases

Shopify Wins

  • Shopify data overwrites app
  • Use if manually managing discounts in Shopify
  • Can cause app data loss

Manual Resolution

  • System notifies you of conflicts
  • You choose which data to keep
  • Most control but requires monitoring

Resolving Conflicts Manually​

If conflicts occur:

  1. Navigate to Settings > Syncing
  2. Click View Conflicts
  3. Review each conflict with:
    • Type of conflict
    • App data vs. Shopify data
    • Recommended action
  4. Choose resolution for each
  5. Click Resolve Conflicts

Syncing Campaign Discounts​

What Gets Synced​

For each campaign:

  • Discount code or automatic discount status
  • Discount type (percentage, fixed amount)
  • Discount value
  • Product selections
  • Customer eligibility
  • Start and end dates
  • Usage limits
  • Active/inactive status

Campaign Sync Process​

  1. Creation: New campaigns pushed to Shopify
  2. Updates: Changes synced to Shopify
  3. Activation: Status changes reflected immediately
  4. Deactivation: Campaigns removed from Shopify
  5. Deletion: Campaigns cleaned up in both systems

Campaign-Specific Settings​

Configure per-campaign sync behavior:

  • Immediate sync on save
  • Batch sync with other campaigns
  • Sync priority (high/normal/low)

Syncing Influencer Codes​

What Gets Synced​

For each influencer code:

  • Discount code
  • Discount value and type
  • Usage limits
  • Expiration dates
  • Active status
  • Usage count
  • Associated orders

Code Sync Process​

  1. Generation: Codes created in both systems
  2. Usage Tracking: Orders sync from Shopify
  3. Status Updates: Active/inactive synced
  4. Expiration: Codes deactivated automatically
  5. Deletion: Codes removed from both systems

Bulk Code Syncing​

When generating codes in bulk:

  • Codes synced in batches of 50
  • Progress indicator shows status
  • Retry automatically on failure
  • Notification when complete

Syncing Best Practices​

Optimization Tips​

  1. Choose Appropriate Frequency

    • High-volume stores: Every 15 minutes
    • Medium-volume stores: Every hour
    • Low-volume stores: Every 6 hours

  2. Monitor Sync Status

    • Check sync history weekly
    • Address failures promptly
    • Review conflicts regularly

  3. Manual Sync Strategically

    • After creating campaigns
    • Before major promotions
    • When troubleshooting issues
    • After bulk changes

  4. Maintain Clean Data

    • Delete old campaigns
    • Archive expired codes
    • Remove unused products from campaigns

Performance Considerations​

Server Load

  • More frequent syncing = higher load
  • Balance freshness vs. performance
  • Consider store size and traffic

API Rate Limits

  • Shopify has API call limits
  • App respects these limits automatically
  • Very frequent syncing may hit limits

Data Volume

  • Large stores with many campaigns sync slower
  • Consider archiving old campaigns
  • Keep active campaigns under 100 for best performance

Automated Syncing Features​

Scheduled Syncing​

Set up automated sync schedules:

  1. Time-Based

    • Sync at specific times (e.g., midnight, 6am, noon)
    • Good for off-peak syncing
    • Reduces load during business hours

  2. Event-Based

    • Sync when campaigns are created
    • Sync when codes are generated
    • Sync after significant changes

  3. Conditional

    • Sync only if changes detected
    • Reduces unnecessary syncing
    • Improves performance

Sync Notifications​

Configure notifications for sync events:

Email Notifications

  • Sync failures
  • Conflict detection
  • Daily sync summary
  • Weekly performance report

In-App Notifications

  • Sync completion
  • Error alerts
  • Conflict warnings
  • Performance tips

Troubleshooting Sync Issues​

Common Sync Problems​

Sync Keeps Failing​

Possible Causes:

  • Shopify API issues
  • Network connectivity problems
  • Invalid discount data
  • Rate limit exceeded

Solutions:

  1. Check Shopify status (status.shopify.com)
  2. Verify internet connection
  3. Review sync error messages
  4. Wait 15 minutes and try again
  5. Contact support if persistent

Usage Counts Don't Match​

Possible Causes:

  • Sync hasn't run recently
  • Time zone differences
  • Orders placed during sync
  • Shopify data delay

Solutions:

  1. Trigger manual sync
  2. Check timezone settings
  3. Wait for next scheduled sync
  4. Compare specific order data

Campaigns Not Appearing at Checkout​

Possible Causes:

  • Sync hasn't completed
  • Campaign not active in Shopify
  • Product selection issues
  • Customer eligibility problems

Solutions:

  1. Verify campaign is active in app
  2. Trigger manual sync
  3. Check Shopify discounts admin
  4. Review campaign conditions

Codes Not Working​

Possible Causes:

  • Code not synced to Shopify
  • Sync failed for specific code
  • Code exists in Shopify but different settings
  • Conflict resolution needed

Solutions:

  1. Check code status in app
  2. Manual sync
  3. View sync history for code
  4. Check for conflicts
  5. Recreate code if necessary

Advanced Syncing​

Webhook Integration (Enterprise)​

Enterprise plans can use webhooks for real-time syncing:

Shopify → App Webhooks

  • Order created → Update usage
  • Order updated → Recalculate stats
  • Discount deleted → Update app
  • Product deleted → Update campaigns

App → External System Webhooks

  • Campaign created → Notify marketing platform
  • Code used → Update CRM
  • Threshold reached → Trigger email
  • Sync completed → Update dashboard

Custom Sync Rules (Enterprise)​

Create custom sync rules:

  • Sync specific campaigns only
  • Exclude certain products
  • Priority-based syncing
  • Conditional sync triggers

Sync Performance Metrics​

Monitor sync performance:

  • Sync Duration: How long each sync takes
  • Items Synced: Number of campaigns/codes updated
  • Success Rate: Percentage of successful syncs
  • Error Rate: Frequency of failures
  • Conflict Rate: How often conflicts occur

View in Settings > Syncing > Performance

Need Help?​

If you're experiencing sync issues: