After you complete the initial integration, you can sync your existing Shopify users and their historical order data to MoEngage. This process allows you to build segments, trigger campaigns, and personalize communication based on past user behavior from the moment you start using MoEngage.
Data Available for Sync
The synchronization process imports two primary data types into MoEngage:
| Data Type | Description |
|---|---|
| Order history | MoEngage ingests past orders within your selected date range as individual Shopify - Order Placed events. Each event uses the original order timestamp from Shopify. |
| User profiles | MoEngage imports all registered users in your Shopify store. The system creates or updates profiles using the unique identifier (email or mobile number) you selected during integration setup. |
User Attribute Mapping
MoEngage synchronizes the following attributes to the user profile if they are available in the Shopify record:
- First name
- Last name
- Phone
- City
- Country
- State
- Shopify ID
- Accepts marketing
- Order count
| info |
Excluded Data By default, MoEngage does not sync Shopify customer metafields (custom data fields). If your personalization requires metafield data, refer to the Events and User Data Tracking article for custom integration steps. |
Sync Prerequisites
Event Retention Period
To ensure your event retention settings accommodate the data range you intend to sync, perform the following check before you begin the synchronization process:
MoEngage stores events for a specific retention window. If your selected sync range exceeds your retention window, MoEngage stops syncing orders once it reaches the limit. The sync status will show as "Sync successful," but older data will be missing from the dashboard.
| warning |
Warning If you plan to sync more than 60 days of history, contact your Customer Success Manager or raise a support ticket to increase your event retention period before starting the sync. You cannot apply these changes retroactively. |
User Identifiers
MoEngage synchronizes users and their orders based on the unique identifier you selected during integration setup:
- If you selected email, the system silently excludes users who do not have an email address.
- The system does not generate error messages for skipped records.
Sync Process
To synchronize your Shopify data, perform the following steps:
- Open your MoEngage Shopify app and click the Sync Shopify data tab.
- Select the date range for your order history. You can sync data for up to the last 2 years from your installation date.
- Click Sync past data.
Monitor progress in the Sync progress section.
Sync Verification
| info |
Sync status does not confirm data arrival The sync status might update to Sync successful within seconds of starting. This indicates the request was received, not that the data has finished processing. Large datasets can take several hours, and up to 24 hours for very large stores. Always verify directly on user profiles. |
To verify the sync, perform the following steps:
- Wait for at least two hours after starting the sync.
- In the MoEngage UI, navigate to a user profile for a customer who placed an order within the sync window.
- Verify that the
Shopify - Order Placedevent appears on their profile with the correct original order date. - If the sync status shows as successful but no data appears after 24 hours, contact support with your selected date range and approximate order count.
Automatic Event Updates
After the historical sync completes, MoEngage automatically tracks new orders via Shopify webhooks. You do not need to run the sync again for new data.
| warning |
Important The sync is a one-time operation for historical backfill. Do not run the sync a second time for the same date range, as this action creates duplicate events in MoEngage. |
Synced User Attributes
MoEngage creates a Shopify - Order Placed event for each unique order ID within your selected date range. The Created at attribute on each event reflects the date and time the order was originally placed in Shopify.
For more information on the list of event attributes, refer to the Events and User Data Tracking article.