Shopify data features

This article provides an overview of Braze Shopify features, including what Shopify data is tracked and example payloads, historical backfill, and product syncs.

Tracked Shopify events

The Shopify integration uses eCommerce recommended events to capture key shopping behaviors. For implementation examples and marketing strategies using these events, refer to eCommerce use cases.

• example payload
• shopify events

Supported Shopify custom attributes

• example payload
• shopify custom attributes

Supported Shopify standard attributes

• Email
• First Name
• Last Name
• Phone
• City
• Country

SDK data collection

For more information on what data is collected by the Braze SDKs, see SDK data collection.

Historical backfill

Historical Shopify data is imported from before you connect Braze. During setup, you choose how far back to import order events and customer profiles. Each timeframe is counted back from the date you complete your integration.

Through the Shopify standard integration setup or Shopify custom integration setup, you can turn on historical backfill to include past customers and orders in segments, campaigns, and Canvases. When you turn it on, select:

• An orders date range: Past 90 days, Past year, or Past 2 years (defaults to Past 90 days)
• A customer profiles date range: Past year, Past 2 years, or All time (defaults to All time)

Braze shows an estimated record count and processing time for each option before you finish setup. After the backfill completes, your selected windows appear as concrete dates on the Shopify partner page. These selections can’t be changed after setup completes.

When Braze imports your Shopify customers, it assigns the external_id type that you chose in your configuration settings.

If you plan to integrate with a custom external ID (for either the standard integration or the custom integration), you will be required to add your custom external ID as a Shopify customer metafield to all existing Shopify customer profiles and then perform the historical backfill.

How Braze selects historical data

Braze uses these Shopify date fields when the initial load runs:

Data	Available windows	Shopify date field
Order events (order placed, order refunded, and order cancelled)	Past 90 days, Past year, or Past 2 years	Order created date
User profiles	Past year, Past 2 years, or All time	Customer updated date

If you migrate historical orders into Shopify and keep their original created dates, Braze imports only orders whose created dates fall within the order window you selected.

Setting up Shopify historical backfill

1. Select Turn on historical backfill in the Track Shopify data step.
2. Choose a date range for orders and a date range for customer profiles. Review the estimated counts and processing time for your selections.
3. After you complete your integration setup, Braze begins the initial data sync. You can monitor progress on the Shopify Data tab of your integration settings.

Backfill sync rate and timing

Historical backfill is performed by Braze’s Shopify integration—not the Braze SDK—and starts automatically when you complete integration setup.

After you enable historical backfill, Braze imports order events and customer profiles from Shopify in batches. Order events and customer profiles sync on separate timelines, so one may finish before the other. Large backfills are split into parallel date ranges so they can run at the same time.

Sync time depends on how much historical data is in your store and which windows you selected. Stores with high order volume or large customer bases may take longer to complete backfill. You can’t change the backfill speed or request a faster sync.

Synced data

For the initial data sync, Braze imports the order events and user profiles described in How Braze selects historical data. When Braze imports your Shopify customers, it assigns the external_id type that you chose in your configuration settings.

The following table summarizes the data included in that initial load.

Braze recommended events	Shopify custom events	Braze standard attributes	Braze subscription statuses
Order placed Order cancelled Order refunded	shopify_tags shopify_total_spent shopify_orders_count shopify_last_order_id shopify_zipcode shopify_province shopify_locale	Email First Name Last Name Phone City Country Total Revenue Total Refunds Total Orders	Email marketing subscriptions associated with this Shopify store SMS marketing subscriptions associated with this Shopify store