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, 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. Open an Airship Support ticket, requesting your merchant install link. This link is required to configure the integration. The merchant install link expires after 7 days.
      • Provide your merchant myshopify.com domain (e.g., pint-mart.myshopify.com) in your request.
      • Support will reply with your merchant install link.
    2. Download your Web SDK bundle. This zip file is required for the integration.
      1. Go to Settings » Web.
      2. Click Update then Download SDK Bundle.

Configuring the Shopify Integration

In Airship:

  1. Go to Settings » Project Configuration and click Manage for Partner Integrations.
  2. Select Shopify.
  3. Click 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:

  1. On the configuration page of the Automated Web Notification app, scroll to the Opt-In Display section and click Add opt-in.
  2. 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.
  3. Click 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.