- The Voyado Customer Engagement app should be installed and connected to your Shopify store
- An API key must have been generated in Customer Engagement to allow secure communication
- The Promotions module must be active in your Customer Engagement environment (ask your Voyado AM)
Re-syncing used promotions
Re-syncing used promotions
If a customer has used a promotion and that specific promotion is assigned again, Customer Engagement will not be able to re-sync it. This happens because both the redeemed and active external codes are required in the Customer Engagement API.
Handling duplicate promotions
Handling duplicate promotions
Shopify cannot distinguish two promotions that share an external code. Using the code redeems both promotions in Shopify, though not necessarily both in Customer Engagement, and the customer cannot use the code a second time because Shopify has already marked it used. Give each promotion its own external codShopify cannot distinguish two promotions that share an external code. Using the code redeems both promotions in Shopify, though not necessarily both in Customer Engagement, and the customer cannot use the code a second time because Shopify has already marked it used. Give each promotion its own external code.
Promotion usage without login
Promotion usage without login
Promotions are fetched from Customer Engagement when the customer visits a page containing the app theme block, or through the Checkout Extension. However, it is possible for a customer to use a promotion without being logged in. If an offer is already synced to Shopify and the offer is redeemed from another source outside Shopify, it could theoretically be reused within Shopify.
Enabling promotions sync
To enable the syncing of promotions between the Shopify app and Customer Engagement:1
Access app settings
- Log into your Shopify admin panel
- Navigate to Apps and select the Voyado Customer Engagement app
2
Configure promotions sync
Within the app settings, locate and enable the Promotion Sync option.
Creating discounts in Shopify
1
Navigate to segments
- In Shopify customers, go to segments, Click, create segment
2
Create a segment
- Input query metafields.voyado.syncedPromotions CONTAINS ‘[[discount code]]’ where Discount Code is the unique code which will link the Shopify discount to the Customer Engagement promotion.
- Click save segment.
3
Navigate to Discounts
- In Shopify Admin, go to Discounts.
4
Create discount
- Click Create Discount
- Choose discount type (Amount of products, Buy X get Y, Amount of order, Free shipping)
- Define the discount details, including value, applicability, and usage limits
5
Set Discount Code
- Assign a unique Discount Code which will link the Shopify discount to the Customer Engagement promotion
6
Assign segment to discount
- Click Eligibility
- Choose the segment created in previously step
7
Save Discount
- After configuring, click Save to create the discount in Shopify
Creating promotions in Customer Engagement
1
Access Promotions
- Log into Customer Engagement and navigate to the Promotions section
2
Create New Promotion
- Click Create Promotion and enter promotion details
- Tick the Can be used online box
3
Assign External Identifier
- Locate the External Promotion Code field
- Enter the exact Discount Code used in Shopify to ensure synchronization
- Enter a Title and Description in the Presentation section. These details will then appear in the checkout extension app block.
4
Save the promotion
Press “Save” and you’re done.
Assigning promotion
You will assign the promotion to customers as follows:1
Activate the promotion
In Customer Engagement, activate the promotion
2
Assign the promotion
Assign it to selected customers, either manually or via an automation
Redeeming promotion
Redeeming a promotion happens as follows:1
Apply Discount Code
Customers can enter the assigned Discount Code during checkout in Shopify.
2
Validation
Shopify validates the code, and if eligible, applies the discount to the order.
3
Order Completion
The customer completes the purchase with the applied promotion.
4
Promotion redemption
Purchase is completed and promotion is marked as “redeemed” in Customer Engagement.
Testing and troubleshooting
Testing promotions:- Create test promotions and conduct trial purchases to verify the integration’s functionality
- Verify the Discount Code in Shopify matches the External Identifier in Customer Engagement
- Ensure the Promotion Sync setting is enabled in the Shopify app
- Confirm Promotions & Loyalty App block is placed on all necessary pages to trigger syncing