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
☑️ 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
E-commerce Integration
☑️ Order Tracking & Attribution
There are two automated methods to integrate e-commerce order information with Duel. We recommend all brands use both options for maximum accuracy of data.
Your e-commerce platform should have the capability to process Zero Value Orders in order to enable automated rewarding.
Method 1 - Order Tracking Analytics (Script) 🕜 = 10 minutes - 2 hours
Method 2 - Order Tracking & Attribution (Server Side) 🕜 = 1 - 2 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 e-commerce 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 e-commerce platform should be able to support zero value orders.
Example promo code spec 🕜 = 10 minutes - 1 hour
Required code testing 🕜 = 15 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.
☑️ Embedding Referral Codes in Links
🛍️ Included in our Shopify App
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.
This is generally setup in one of two ways:
URL path: www.brandecommerce.com/discount/[promocode]
Parameter: www.brandecommerce.com?promo=[promocode]
☑️ UGC Product Galleries (optional)
Galleries are powered by Duel and allow brands to easily display and control UGC content on their e-commerce website.
UGC Product Galleries 🕜 = 10 minutes - 2 hours
☑️ SSO: Single Sign-on (optional)
This feature enables users to login and signup to the Duel portal through their brand account eCommerce credentials.
SSO: Single Sign-on 🕜 = 6 hours
CRM Integration
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
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.
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.