Shopify Historical Backfill
The Shopify Historical Backfill feature allows brands to sync over customers and purchase data in an automated and seamless way, so you can immediately start engaging with one of your most valuable segments – purchasers.
As part of this backfill, Braze will import all customers, orders, and purchase events from the last 90 days prior to your Shopify integration connection. Note that this feature is ideal for newer customers that don’t have any active messages running, given the implications explained in the next section. This feature will also count toward your data point usage.
This feature will import historical data and events that could result in unintended consequences such as users receiving irrelevant and untimely messages for any affected campaigns or Canvases. Campaigns and Canvases using the following trigger events could be impacted if they are using any of the Shopify data this feature is syncing over:
- Change Custom Attribute Value
- Perform Conversion Event
- Perform Exception Event for Campaign
- Update Subscription Status
- Update Subscription Group Status
- Add an Email Address
- Make Purchase*
- Perform Custom Event*
We recommend you audit your current active campaigns and Canvases for messages that may trigger the above events using data from our Shopify Historical Backfill.
- For “Make Purchase” and “Perform Custom Event”, you can update the start time duration to any date and time after your Shopify store was connected in Braze. Any past events before this new start time will not trigger any messages.
- For all other events above, you can temporarily stop them before activating the backfill to guarantee no messages get sent.
Setting up Shopify Historical Backfill
Step 1: Start the Shopify backfill process
On the Shopify partner page, select Start Data Backfill. For existing Shopify customers, you will need to reauthorize access for Braze to collect all past order events before you can start data backfill.
Step 2: Toggle on the backfill of Shopify data
Next, the setup wizard will pop up, and you can optionally enable the backfill of historical Shopify data. As part of this backfill, Braze will sync only the following Shopify data for the last 90 days prior to your Shopify integration by default:
- Order Created Event
- Braze Purchase Event
- Customer Data
To see what specific customer data is being backfilled, you can visit the Supported Shopify customer data section.
This feature will only sync email and SMS subscription states for new users created during the backfill. This will not sync subscription states for existing users in Braze to avoid overriding your users’ current statuses.
If you have feedback on the current behavior, submit it through the product portal, listed in the Dashboard under Resources as Product Roadmap (If you are using our updated navigation, select Community > Product Roadmap).
Once you hit Next, the backfill will activate and start syncing over past data. Note that Historical Backfill can only be completed once, so you will not be able to run this import again once the data has finished syncing.
Step 3: Backfill in progress
You will receive a dashboard notification, and your status will display as “In Progress” to indicate the backfill has started. Note that the time it takes for the backfill to finish will depend on how many customers and orders Braze will need to sync over from Shopify. During this time, you can leave this page and wait for a dashboard notification or email to notify you of when the backfill is complete.
Step 4: Backfill completed
You will receive a dashboard notification and an email once the Shopify backfill has been completed. The Shopify partner page will also update the status under Historical Backfill to “Complete”.
Supported Shopify customer data
Shopify custom attributes
||This custom attribute corresponds to the total orders this customer has completed in Shopify. This is only available for users that were backfilled as part of this process.|
||This custom attribute corresponds to the total amount spent by this customer in Shopify. This is only available for users that were backfilled as part of this process.|
||This attribute corresponds to the customer tags set by Shopify admins.|
Shopify standard attributes
- First Name
- Last Name