Shopify

AIRSHIP MAINTAINED INTEGRATION

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

Shopify is an e-commerce platform for online stores and retail point of sale (POS) systems.

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 Journeys and automations in your messaging campaigns.

 Note

The events configured for this integration are implemented as custom events 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.

Getting Started

For this integration to work, you should already have an Airship account. If you don’t have an Airship account, see step one below. Otherwise skip to step two to get started.

  1. Create an Airship account and log in.
  2. Create a messaging project.
  3. Configure Airship web push notifications for your messaging project so that you can download Airship SDK zip archive. You may download the SDK to any location on your computer.

You need the Airship SDK that you have downloaded when setting up the Automated Web Notification app in Shopify. Contact Airship support to have the Shopify integration enabled for you. Then, after you receive the merchant install link, complete your setup in the Shopify store:

  1. Log in to your Shopify store account and open the merchant install link. Then, click Install App on the Airship setup page.
  2. Under Get started with Airship Web Notifications, click Learn More for a checklist of what you need to set up in your Airship dashboard before you can continue configuring the app in your Shopify store.
  3. Click Configure Web Notifications in the Web Notifications section on the configuration page of Automated Web Notification of your Shopify store.
  4. Click Upload Zipped Airship SDK Bundle and select the downloaded Airship SDK. The App Key is updated to the value from the SDK.
  5. To fill in the Integration Token field, follow the steps of the Create a Token procedure on the Manage Bearer Tokens page in Airship documention. You can also open this page by clicking the Create an integration token button below the Integration Token field.
  6. Click Save to apply your settings.
 Important

The merchant install link expires after 7 days. Make sure to install the Automated Web Notification app within this period.

Configure 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 the Add opt-in button.
  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 is not displayed 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.