Integrating Wishlist Plus and/ or Swym Back in Stock Alerts with Iterable allows you to send personalized retargeting and engagement marketing campaigns to your customers via email. This guide walks you through the steps to successfully set up and use this integration.
Prerequisites
Before you begin, ensure the following:
You are on the Enterprise plan on Wishlist Plus or Swym Back in Stock Alerts app.
You have an active Iterable account
Successfully connecting your Wishlist Plus or Swym Back in Stock Alerts app to Iterable involves three key steps. It’s important to complete all of them to ensure that your shoppers actually receive the notifications you intend to send.
Connect your Swym app to Iterable
Establish the connection so that your Wishlist Plus or Back in Stock Alerts app can securely communicate with Iterable.
Subscribe to events you want to send
Choose which Swym events (e.g., price drop, back in stock, wishlist reminder) should be sent to Iterable. Without selecting events, no triggers will reach Iterable.
Build Journeys in Iterable
Set up Journeys that use these events to send personalized emails to your shoppers. This is what ensures that the right communication goes out when an event occurs
⚠️ Note: We often see merchants stop at just connecting the apps, without subscribing to events or building journeys. Make sure you complete all three steps for the integration to work as intended.
Step 1: Connect your Swym app to Iterable
1. Navigate to the Wishlist Plus app in your Shopify admin and click on the “Integrations” tab.
2. Find the Iterable tile and click “Connect.”
3. Once connected, you will be redirected to the Iterable page where you need to enter the Iterable API key.
Where to find the Iterable API key?
Inside your Iterable account, under the Integration section in the menu bar, go to the ‘API Keys’ page.
Create a new API key (server side).
“Type” of the API key should be “Server Side”
Additionally, you can refer to this Iterable help doc to learn how to create an API key.
4. Test the connection
You can verify that the connection is working by sending test triggers to Iterable.
Go to the Test integration section on the Iterable integration page in your Wishlist Plus app.
Select the test event(s) you’d like to send to Iterable.
Enter a valid email address and phone number.
Click Send Test Triggers.
Once sent, log in to your Iterable account and navigate to Messaging > Journeys. Create a new Journey, and you should see the test events listed under Custom Events.
If the custom events appear, it confirms that your Swym app is successfully communicating with your Iterable account.
Step 2: Subscribe to events you want to send
From your Wishlist Plus app, head over to the Marketing tab and scroll to the “Automations” section. Here, you will notice various events that you can subscribe to. Enable the desired events.
Below are the list of events we support:
Swym Wishlist Plus App Events:
Event Name | When this event is triggered |
Wishlist Reminder | Reminder about items in a shopper’s wishlist |
Saved for Later Reminder | Reminder about a shopper’s Saved for Later items |
Price Drop alert | Product on a wishlist goes on sale |
Low Stock alert | Product on a wishlist is running low on stock |
Back in Stock alert | Product on a wishlist is restocked |
Swym Back in Stock Alerts App Events
Event Name | When this event is triggered |
Back in Stock Acknowledgement | Shopper subscribes to be notified when a product is back in stock |
Restock Alert | Product a shopper requested a back-in-stock alert for is restocked |
Restock Reminder | Follow-up alert (usually ~24 hrs after the first restock alert, configurable) |
Step 3: Build Journeys in Iterable
You will have to build a separate Journey for each of the events you subscribed to in order to automate sending out personalised emails to your shoppers.
1. Go to the Journeys section (under Messaging) in your Iterable account. Click on the New journey button.
2. The first step in the journey indicates how the journey is triggered (point 5 from the image is optional).
3. Next attach a campaign (email or SMS) by simply drag and drop either email or SMS block from the side menu. Next fill in the details and choose a template for the campaign (it could be a template or existing campaign content).
4. Connect these two tiles in appropriate order and then save or publish this journey (publishing this journey will automatically make it active).
The journey created here is a simple one, it can be customized to your preferences to have more sophisticated logic.
5. After adding the desired action, save the journey. It will be displayed in the Journeys section and it should be turned on for the flow to be active. The campaign associated with it should also be visible.
Customizing Templates on Template Editor
Iterable allows you to use Handlebars which lets you personalize emails by pulling in customer-specific or event-specific data in email templates. The variables wrapped in between the double braces (ex: {{productName}}) will be populated from the events that Swym sends.
You can check how templates are configured from the Iterable docs.
Variables available in the Wishlist Reminder event:
Custom event name: Swym-addedtowishlist
Variable | Details |
productCount | Number of products in the current wishlist reminder event |
products[] | List of products. Each element in the products list has the following fields. |
imageURL | URL of product’s image |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productBrand | Brand name of the product (if any) |
productQuantity | Number of products wishlisted |
productName | Name of the product added to wishlist |
productCategory | Category of the product |
productURL | URL directing to the PDP |
Variables available in the Saved for Later Reminder event
Custom event name: Swym-addedtosfl
Variable | Details |
productCount | Number of products in the current reminder event |
products[] | List of products. Each element in the products list has the following fields |
imageURL | URL of product’s image |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productBrand | Brand name of the product (if any) |
productQuantity | Number of products wishlisted |
productName | Name of the product added to wishlist |
productCategory | Category of the product |
productURL | URL directing to the PDP |
Variables available in the Low Stock Alert
Custom event name: Swym-lowstock
Variable | Details |
imageURL | URL of product’s image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
Variables available in the Price Drop Alert
Custom event name: Swym-pricedrop
Variable | Details |
imageURL | URL of product’s image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productOriginalPrice | Product’s initial price before drop (compare at price) |
productCurrentPrice | Product’s current price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
Variables available in the Back in Stock Alert
Custom event name: Swym-backinstock
Variable | Details |
imageURL | URL of product’s image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
Variables available in the Restock Second Alert / Reminder
Custom event name: Swym-backinstockReminder
Variable | Details |
imageURL | URL of product’s image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
Variables available in the Reminder Acknowledgement
Custom event name: Swym-remindMe
Variable | Details |
imageURL | URL of product’s image |
productName | Name of the product subscribed to |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product’s price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
Troubleshooting:
To verify if the events from Swym apps are reaching Iterable, visit Insights > Logs > Events to trace the logs. The Raw Data column shows what data is sent from the Swym app for the corresponding event.
To verify if the emails are getting properly rendered and being sent, visit Insights > Logs > Sent Messages