Choosing your integration method
How you add DiscoOffers to your site depends on how your store is built. This guide walks through the options so you can pick the one that fits — most publishers know which applies to them within a minute.
Find your setup
- Shopify store on Checkout Extensibility (most stores) → install the Disco widget, see Publishing DiscoOffers on your Shopify store
- Shopify store not yet on Checkout Extensibility → add the Disco script, see Publishing DiscoOffers with the Disco Script
- Web store or web-based app (custom site) → Web SDK, see the Web SDK guide
- Native iOS or Android app → iOS / Android SDK
- React Native app → React Native SDK (access by request)
- You build a Shopify app for other merchants → Shopify SDK for DiscoBeat channel partners (access by request)
- You want full control of the experience → Ad Recommendations API
The options
| Method | Best for |
|---|---|
| Shopify Extension | Shopify merchants on Checkout Extensibility (most Shopify stores now). Adapts to your theme; lowest setup effort. |
| Web SDK | Web or mobile-web stores. Low setup effort, quick to start. |
| iOS / Android SDK | Native apps wanting a low-lift, drop-in solution. |
| React Native SDK | React Native apps wanting a Disco-rendered placement. |
| Shopify SDK (partner apps) | DiscoBeat partners embedding Disco in their own Shopify extensions. |
| Ad Recommendations API | Maximum control over the experience, or when Disco's script can't run on your surface. |
What a good integration passes
Follow the identity and required-field rules for your chosen integration. The Web SDK expects an email or hashed email plus the required order fields; the Ad Recommendations API also supports phone or external_guid identifiers. Sending permitted order and shopper context improves offer relevance. See the Web SDK field reference or the Ad Recommendations API for your integration.
Developer documentation
- DiscoOffers Web SDK guide — the script install for web stores
- Google Tag Manager setup — deploy the Web SDK through GTM
- Field Reference — every field you can pass, required and optional
Related articles
Web or app?
- Web (Shopify or a custom site) → Shopify Checkout Extensibility or the Disco script.
- Mobile app (native iOS / Android) → the App SDK in Developers.