Shopify

AIRSHIP MAINTAINED INTEGRATION

This integration is maintained by Airship. Please contact Airship for support.

Our Shopify integration enables your Shopify store for web notifications and automatically captures cart-, checkout-, and order-related events, e.g., order fulfilled, checkout created. Use these events to trigger Airship Sequences and automations in your messaging campaigns.

 Note

The events configured for this integration are implemented as Custom EventsEvents that indicate that a user performed a predefined action, such as adding an item to a shopping cart, viewing a screen, or clicking an Unsubscribe button. Custom events can trigger automation, including Sequences, Scenes, and Surveys. You can code them into your app or website, or send them to Airship from an external source using the custom event API. Custom events contain properties that you can use to personalize messages. in Airship.

Custom events include additional data from Shopify–properties that can be used to personalize messages in Airship. These include things like items in a customer’s cart, the total purchase value, customer first name, or the URL for an abandoned cart.

Shopify Integration Requirements

  • Accounts
    1. Shopify
    2. Airship — Must include messaging
  • Airship project
    1. Your merchant install link. Open an Airship Support ticket, to request it. Provide your merchant myshopify.com domain in your request. For example, pint-mart.myshopify.com. The link expires after 7 days.
    2. Your Web SDK bundle. To download it:
      1. Go to Settings.
      2. Under Channels, select Web.
      3. Select Update, then Download SDK Bundle.

Configuring the Shopify Integration

In Airship:

  1. Go to Settings.
  2. Under Project Configuration, select Manage for Partner Integrations.
  3. Select Shopify.
  4. Select Configure for the inbound integration and follow the onscreen instructions to:

Configuring Notifications

With the Airship SDK bundle uploaded and configured, you can now customize the user experience for customers opting in for notifications. You have multiple attributes at your disposal.

In Shopify:

  1. On the configuration page of the Automated Web Notification app, go to the Opt-In Display section and select Add opt-in.

    In the expanded Opt-In Display section, you can now edit various attributes of the notification: the style of the notification (whether it should appear as a prompt or a bell), the text of the heading and text, color, and position on the screen where it should appear.

  2. Select Save to apply your changes.
 Note

Users trigger the prompt when they view a blog post or a product page. The prompt displays on checkout or cart pages. The prompt disappears after 60 seconds unless the user interacts with it.

If the user does not choose to opt in to notifications, the prompt will be triggered again in 2 weeks. You can adjust the timing of the re-prompt in your Shopify admin for the Automated Web Notifications app.

Supported Custom Events

Most custom events are generated via webhooks, which are sent by Shopify. In some cases, such as shopify_cart_changed, an event originates from the browser. The following custom events are supported:

Event NameAction
shopify_cart_changedA user took any action in the browser that modified the contents of or created a cart.
shopify_checkout_createdA user started the checkout process for a cart.
shopify_checkout_updatedA user took any action that modified the status of a checkout. Triggered as a user completes each section of checkout.
shopify_order_createdA user has completed a checkout and submitted an order.
shopify_order_fulfilledA shop owner has marked an order as fulfilled.
shopify_order_fulfilled_updateA shipping provider has provided a status update for an order.