See a summary of the technical requirements needed for integrating with Duel.
🌍 For brands with various stores for different regions & languages, please make the Duel team aware of the exact setup of those various stores.
🕜 = Average Integration Time
☑️ Build Programme Landing Page
A webpage that's hosted on your eCommerce platform that provides an explanation of the programme including CTAs to the Duel hosted portal. This webpage will serve as a landing page where visitors can find information about the application requirements, potential perks and rewards, and links to the signup and login pages.
☑️ Subdomain
The portal is hosted by Duel and sits under a subdomain (i.e. portal.example.com). This requires you to add a new CNAME record (instructions provided by Duel) in your DNS settings once decided by the brand.
🕜 = 5 minutes
☑️ eCommerce Order Tracking & Attribution
When integrating your eCommerce with our platform, you have two options: using the order script or integrating server side.
While the order script offers a simpler and faster setup, we strongly recommend using our server side for a more secure, flexible, and reliable solution.
Your eCommerce platform should have the capability to process Zero Value Orders in order to effectively enable automated rewarding.
🛍️ The Shopify App handles both methods automatically, so manual integration is not required. 🕜 Setup time: approximately 10 minutes
Method 1 - Order Tracking via Pixel (Script) 🕜 = 20 minutes - 2 hours
Method 2 - Order Tracking via API (Server Side) 🕜 = 1 - 3 hours
We also offer a manual Order Import, this is not recommended as a replacement for the above automatic integrations but can be used in specific circumstances as a failsafe.
Method 3 - Order Import (Failsafe)
☑️ Product Catalogue
A product catalogue is required for Duel to generate UGC Galleries and facilitate product tagging in the platform. This is ideally a JSON feed but we could also use a .CSV file (this would then need to be updated manually)
🛍️ Included in our Shopify App
Product Catalogue 🕜 = 5 minutes - 2 hours
☑️ Batch Promo Codes
Batches of promo codes are used for safe automated reward distribution as well as referral discounts.
Your eCommerce platform should have the capability to generate and oversee batches of promo codes with specific parameters or rules. Once these promo codes have been confirmed, your Duel implementations manager will provide you with the necessary code specifications.
It is important to note that for optimal reward distribution & scalability, your eCommerce platform should be able to support zero value orders.
Referral codes should be setup to work across all eCommerce platforms globally that have Duel order tracking implemented.
Example promo code spec 🕜 = 10 minutes - 1 hour
Required code testing 🕜 = 30 minutes
🚨 Any changes made to promo codes after creation will impact the programme's functionality. It’s your responsibility to let Duel know any planned changes so they can be properly implemented.
CRM Integration (optional)
We provide integration options for a wide range of CRM software. If you need a step-by-step guide on how to set up the integration or want more information, please refer to our dedicated article below.
CRM Integration 🕜 = 5 - 20 minutes
3rd Party Analytics Tracking (optional)
This feature gives a clearer view of advocates who navigate through from the Duel powered portal through to your eCommerce site. You can track GA or Facebook - for any custom pixel please speak with you Implementation Manager to see if we can support it.
See further reading here.
🕜 = 5 minutes
Embedding Referral Codes in Links (optional)
To enhance the referral experience and prevent code leaks, we recommend embedding referral codes directly into affiliate links. This ensures that the code is automatically applied at checkout, resulting in a smoother user experience.
UGC Product Galleries (optional)
Galleries are powered by Duel and allow brands to easily display and control UGC content on their eCommerce website.
UGC Product Galleries 🕜 = 10 minutes - 2 hours
SSO: Single Sign-on (optional)
SSO can either be setup on the portal (front end) or dashboard (back end) see further reading below.
API
We have an open API for any bespoke connection requests. See documentation at:
https://developers.duel.tech/open-api/
All API requests require basic authentication. You can create API user credentials in the Duel Dashboard under Settings > API Users.