Technical Checklist

Subdomain
eCommerce Order Tracking & Attribution
Product Catalogue
Batch Promo Codes (Reward & Referral)
Programme Landing Page 

🕜 = Estimated 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

☑️ eCommerce Order Tracking and Attribution

To support order tracking and attribution for Advocates driving referrals, your eCommerce platform must be connected to the Duel dashboard.

The server side API integration is the primary method. It provides order updates, higher security, greater flexibility, and improved reliability. It should be used for all standard implementations.

Brands may also use a hybrid approach: implement the script for launch, then migrate to server side integration if timelines are restricted.

For brands operating multiple eCommerce stores across different regions, let the Duel team know your structure so we can guide you on the correct integration approach.

Primary Integration

Order Tracking via API (Server Side) 🕜 = 1 - 3 hours

• Default and recommended method.
• Supports full order updates.
• Provides higher security, improved reliability, and better scalability for multi-store setups.

Backup Integrations

Used only when the API cannot be implemented or as temporary fallbacks.

Order Tracking via Pixel (Script) 🕜 = 1 hour

• Suitable for fast initial deployment.
• Client side only, does not support order updates.
• Can be  used during launch before migrating to the API.

Order Import (Failsafe)

• CSV can be used to create or update orders.
• Suitable for one off recovery or updates. 

☑️ Product Catalogue

A product catalogue is required for Duel to generate UGC Galleries and enable product tagging in the platform. A JSON feed is preferred, although a CSV file can be used if manual updates are acceptable.

Product Catalogue 🕜 = 5 minutes - 2 hours

☑️ Batch Promo Codes (Reward & Referral)

Batches of promo codes are required for automated reward distribution and for issuing referral codes. See dedicated article for the differences between Reward and Referral codes.

Your eCommerce should be able to generate and manage promo code batches with fixed parameters. Once program structure is confirmed, your Duel implementations manager will share the required promo code specification.

Example promo code spec  🕜 = 10 minutes - 1 hour

Required code testing 🕜 = 30 minutes

Referral codes should be configured to work across all eCommerce storefronts where Duel order tracking is active.

For scalable and reliable reward distribution, your eCommerce platform must support Zero Value Orders.

☑️ 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.

See further information & examples of landing pages

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.

Hidden Referral Codes 🕜 = 30 minutes - 2 hours

Webhooks (optional) 

Webhooks allow brands to automatically receive real-time event data from Duel, removing the need to manually poll the API.

Using Webhooks in Duel 🕜 = 30 - 60 minutes

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 🕜 = 10 - 60 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 your Implementation Manager to see if we can support it. 

3rd Party Analytics Tracking 🕜 = 5 minutes

SSO: Single Sign-on (optional) 

SSO can either be setup on the portal (front end) or dashboard (back end) see further reading below.

SSO: Dashboard

SSO: Portal

API

We have an open API for any bespoke connection requests. See documentation at: 

https://developers.duel.tech/open-api/