Shopify

Shopify is a leading global commerce company providing trusted tools to start, grow, market, and manage a retail business of any size. Shopify makes commerce better for everyone with a platform and services that are engineered for reliability while delivering a better shopping experience for consumers everywhere.

Our Shopify integration allows brands to connect their Shopify store seamlessly with Braze to pass select Shopify webhooks into Braze. Leverage Braze’s cross-channel strategies and Canvas to retarget your users with abandoned checkout messaging to nudge customers to complete their purchase or retarget users based on their previous purchases.

Before you begin

  1. All Braze customers looking to utilize the Shopify integration must sign Braze’s Shopify order form. Please reach out to your Account Executive for more details.
  2. This integration will create alias user profiles if we are unable to match Shopify data using the email or phone number (see here for more details on Shopify user reconciliation). Please consult with your development teams around the downstream impacts and need to merge these user profiles as part of your user lifecycle before you enable the integration.

Requirements

Requirement Origin Access Description
Shopify Store Shopify https://www.shopify.com You must have an active Shopify store.

Please note that at this time, you are only able to connect one Shopify store per app group.
Event Property Segmentation Enabled Braze Please reach out to your Customer Success Manager or contact Braze support To ensure you can segment your Shopify events properties, please work with your Customer Success Manager or Braze support to confirm that you have event property segmentation enabled for your dashboard.
Nested Custom Event Property Support in Segment Extensions Braze Enabled with the Shopify Integration You will be given access to this feature to filter Shopify nested custom event properties for up to 365 days within Segment Extensions.
Nested Custom Event Property Support for Message Triggering Braze Enabled with the Shopify Integration You will be given access to this feature to trigger campaigns and Canvases using the nested properties within Shopify customer events.
Nested Custom Attribute Support Braze Enabled with the Shopify Integration You will be given access to this feature to receive Shopify marketing opt-in custom attributes.

Integration details

With Braze’s turnkey Shopify integration, you can:

  • Seamlessly connect your Shopify store within Braze
  • Allow Braze to ingest and process the following Shopify webhook events:
    • Order Create
    • Checkout Update
  • Sync Shopify user profiles into Braze

Step 1: Locate Shopify within the dashboard

From the Braze dashboard, go to the Technology Partners section and then search Shopify. On the Shopify partner page, select Begin Setup to start the integration process.

Shopify

Step 2: Shopify setup

Next, you are prompted by Braze’s setup wizard. Within this flow, you must enter your Shopify Store Name, review the Shopify Webhook Events (ingestion begins once the integration is connected), and visit the Shopify marketplace to download Braze’s unlisted Shopify app. Once you select Install Unlisted App, you will be redirected to the Braze dashboard.

Shopify setup within Braze


Shopify

Install Braze’s Shopify application


Shopify

Step 3: Verify completion

That’s it! The status of your integration appears in the Data Import section of the Shopify partner page. Once the Braze app has been successfully installed and the webhook creation is complete, you will be notified via email. In addition, the Connection Pending status will be updated to Connected and will display the timestamp of when the connection was established.

Shopify Arrow Shopify Arrow Shopify

Shopify event processing

Once the app installation is complete, Braze automatically creates your webhook integration with Shopify. See the table below for more details on how the supported Shopify webhook events map to Braze custom events and custom attributes.

Supported Shopify events

Event Name Braze Event Type Triggered When…
shopify_abandoned_checkout Custom Event Shopify checkout updates webhook’s trigger when a customer adds/removes items from their cart AND proceeds further into the checkout process including adding their personal information.

Braze will listen to the inbound Shopify checkout update webhooks and trigger the shopify_abandoned_checkout custom event when that checkout is considered abandoned after 1 hour of checkout/cart activity.
shopify_create_order Custom Event Order create events trigger:

Automatically after a customer has completed a purchase from your Shopify store.
OR
Manually through the orders section of your Shopify account.
Purchase Braze Purchase Event Shopify’s order create event also immediately triggers a Braze purchase event.

Note: the Braze product_id field will include the Shopify product id.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "name": "shopify_abandoned_checkout",
  "time": "2020-09-10T18:53:37-04:00",
  "properties": {
    "applied_discount": {
      "amount": "30.00",
      "title": "XYZPromotion",
      "description": "Promotionalitemforblackfriday."
    },
    "discount_code": "30_DOLLARS_OFF",
    "total_price": "398.00",
    "line_items": [
      {
        "product_id": 632910392,
        "quantity": 1,
        "sku": "IPOD2008PINK",
        "title": "IPodNano-8GB",
        "vendor": "Apple",
        "properties": "nil",
        "price": "199.00"
      }
    ],
    "abandoned_checkout_url": "https://checkout.local/690933842/checkouts/123123123/recover?key=example-secret-token",
    "checkout_id": "123123123"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
  "name": "shopify_created_order",
  "time": "2020-09-10T18:53:45-04:00",
  "properties": {
    "total_discounts": "5.00",
    "total_price": "403.00",
    "discount_codes": [],
    "line_items": [
      {
        "product_id": 632910392,
        "quantity": 1,
        "sku": "IPOD2008PINK",
        "title": "IPodNano-8GB",
        "vendor": "nil",
        "name": "IPodNano-8GB",
        "properties": [],
        "price": "199.00"
      },
      {
        "product_id": 632910392,
        "quantity": 1,
        "sku": "IPOD2008PINK",
        "title": "IPodNano-8GB",
        "vendor": "nil",
        "name": "IPodNano-8GB",
        "properties": [],
        "price": "199.00"
      }
    ],
    "order_id": 820982911946154500,
    "confirmed": false,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
    "order_number": 1234,
    "cancelled_at": "2020-09-10T18:53:45-04:00",
    "shipping": [
      {
        "title": "Standard",
        "price": "10.00"
      },
      {
        "title": "Expedited",
        "price": "25.00"
      }
    ],
    "tags": "heavy"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "product_id": 632910392,
  "currency": "USD",
  "price": "199.00",
  "time": "2020-09-10T18:53:45-04:00",
  "quantity": 1,
  "source": "shopify",
  "properties": {
    "name": "IPodNano-8GB",
    "sku": "IPOD2008PINK",
    "title": "IPodNano-8GB",
    "variant_title": "nil",
    "vendor": "nil",
    "properties": []
  }
}

Supported Shopify custom attributes

Attribute Name Description
shopify_accepts_marketing The shopify_accepts_marketing custom attribute corresponds to the SMS marketing opt-in status that is captured on the checkout page.
shopify_sms_consent The shopify_sms_consent custom attribute corresponds to the SMS marketing opt-in status that is captured on the checkout page.
shopify_tags The shopify_tags custom attribute corresponds to the Customer Tags set by Shopify admins.
1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user_id",
      "shopify_accepts_marketing": true
    }
  ]
}
1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user_id",
      "shopify_tags": "VIP_customer"
    }
  ]
}

Supported Shopify standard attributes

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

Shopify user syncing

Braze will map the supported Shopify data to user profiles using the customer’s email address or phone number.

Identified User Profiles

  • If the email address or phone number is associated with an identified user profile, Braze syncs the Shopify data to that user.
  • If the email address or phone number is associated with multiple identified user profiles, Braze syncs the Shopify data to the one with the most recent activity.

Anonymous Users

  • If the email address or phone number is associated with an existing anonymous user profile or alias-only profile, we sync the Shopify data to that user.
    • For existing alias-only profiles, we’ll add the Shopify alias object for that user (see below).
  • If the email address or phone number is not associated with a user profile in Braze, Braze generates an alias-only user with a Shopify alias object.
    • If these alias-only users eventually become identified, Braze customers must assign an external ID to the alias-only profile by calling the Users Identify endpoint.

Using Shopify data in Braze

Once you’ve completed your integration, take a look at our next Shopify article here to learn how to use Shopify data in Braze for personalization and segmentation in your campaigns and Canvases.

Troubleshooting

Why is my Shopify app install still pending?

Your install may still be pending for one of the following reasons:

  • When Braze is setting up your Shopify webhooks
  • When Braze is communicating with Shopify

If your app installation is pending for 1 hour, Braze will fail the installation and you will be prompted to Retry Setup.

Shopify

Why did my Shopify app install fail?

Your install may have failed for one of the following reasons:

  • Braze could not reach Shopify
  • Braze failed to process the request
  • Your Shopify access token is invalid
  • The Braze Shopify app was deleted from your Shopify admin page

If this happens, you will be able to select Retry Setup and start the installation process again.

Shopify

How do I uninstall the Braze application from my Shopify store?

You will need to go to your Shopify admin page located under Apps. You will then see an option to delete the Braze application

Shopify

GDPR

With respect to Personal Data submitted to Braze Services by or on behalf of its customers, Braze is the Data Processor, and our customers are the Data Controllers. Accordingly, Braze processes such Personal Data solely at the instruction of our customers and, when applicable, notify our customers of Data Subject requests. Our customers, as the Data Controllers, respond directly to Data Subject requests. As part of the Braze platform’s Shopify integration, Braze automatically receives Shopify’s GDPR webhooks. However, Braze customers are ultimately responsible for responding to Data Subject requests from their Shopify customers through the use of Braze SDKs or REST APIs in accordance with our GDPR compliance policies.

WAS THIS PAGE HELPFUL?
New Stuff!