
Frequently asked questions – Technical integration
Discover the most-read articles
Affilae offers several technical integration methods depending on your website: Shopify, PrestaShop and WooCommerce plugins, Google Tag Manager, manual integration or Server-to-Server.
Each program has its own objectives and wants to track different events (old or new customer sales, sales by product category, leads). This page sets out what each method allows, and answers the most frequent questions.
Comparing the integration methods
| METHOD | HOW IT IS INSTALLED | WHAT YOU CAN TELL APART | LEADS | PROMO CODE | TOP PRODUCTS |
|---|---|---|---|---|---|
| Shopify | Affilae click script and pixel to paste into Shopify, no development. | All sales. New and returning customers with two keys. | No | Yes | Yes |
| PrestaShop (module) | Via a module, no development. | Old and new customers, product categories, and both combined. | No | Yes | Yes |
| WooCommerce (module) | Via a module, no development. | Old and new customers, product categories, and both combined. | No | Yes | Yes |
| WooCommerce (manual) | Scripts to paste into your theme, when a conflict blocks the module. | Sales only, with no distinction between customer type or product category. | No | Yes | Yes |
| Google Tag Manager | Affilae tags in your GTM container, fed by your dataLayer. | Any event you can trigger in GTM, with one rule and one key per event. | Yes | Yes, if your dataLayer provides it | Yes, if your dataLayer provides them |
| Manual integration (C2S) | Tracking tag and conversion tag to add to your website code. | Any event your website can detect, with one rule and one key per event. | Yes | Yes | Yes |
| Server-to-Server (S2S) | Server-side development: store the clickID, then send the conversion. | Any event your server can detect, with one rule and one key per event. | Yes | Yes | Yes |
Top products: the method sends the IDs of the ordered products. They only show up in top products if your program has a product feed whose IDs match the ones sent.
For a mobile app, follow the S2S – AppsFlyer, S2S – Adjust and S2S – Branch guides.
Each method in detail
Shopify
On Shopify, you paste the click script into the theme.liquid file of your theme, then the Affilae pixel into Settings > Customer events. Affilae provides the files and no development is needed.
- All sales are tracked. With the shopifyPixelConversionOldNew.js file, new and returning customers are told apart, with one key for each.
- You cannot track leads via the Shopify integration.
The promo code and top products tracking options are available via this integration. See the Shopify integration documentation.
Prestashop
Prestashop scripts are integrated via a module. This integration does not require any technical skills. Here are the possibilities available.
- Distinction between old and new customers.
- Distinction by product category. In this case, the module is based on your Prestashop category settings.
You can combine these different events (customer type and categories). You cannot track leads via the Prestashop module integration. The promo code and top products tracking options are available. See the Prestashop integration documentation.
WooCommerce, via the module
Here are the possibilities of the integration via the WooCommerce module.
- Distinction between old and new customers.
- Distinction by product category. In this case, the module is based on your WooCommerce category settings.
You can combine these different events (customer type and categories). You cannot track leads via the WooCommerce module integration. The promo code and top products tracking options are available. See the WooCommerce module documentation.
WooCommerce, manual integration
Manual integration of scripts in WooCommerce comes into play when a conflict in your WooCommerce prevents scripts from being triggered. For example, this could come from page builder software such as Elementor, Divi or WP Bakery. The scripts are specific to WooCommerce but do not require any technical skills to install.
- Integration applies to sales only, with no distinction between customer type or product category.
- You cannot track leads via manual WooCommerce integration.
The promo code and top products tracking options are available in this integration method. See the manual WooCommerce documentation.
Google Tag Manager
Integration via Google Tag Manager corresponds to a custom integration. You can track any event as long as you can configure it in your GTM.
Please note that integration via Google Tag Manager is technical and that your GTM must be perfectly configured. For example, if you want to distinguish between old and new customer sales, you will need to create two separate scripts, one for each event. You will then need to set the parameters for triggering these scripts according to these specific conditions.
See our documentation for integrating scripts via GTM.
Manual integration and Server-to-Server
The manual integration (C2S) and Server-to-Server (S2S) have no event limit: any event your website or your server can detect can send the conversion of a rule, with its key. Leads, promo codes and product IDs are supported. S2S requires server-side development, but it does not depend on the user’s browser.
Best practices
- One event to tell apart equals one commission rule, so one conversion script to install. Count your categories before you start.
- If no plugin covers your need, use Google Tag Manager, the manual integration or Server-to-Server, which do not have these limits.
- Always test with a real order before opening your program.
Related articles
- My conversions are not showing up: troubleshooting
- All available integration methods
- Affilae tracking fundamentals
- Testing click and conversion tracking
- Tracking: product categorization
- Resolving click discrepancies
Frequently asked questions
In Affilae, an event, in this case the sale of a product in category X or Y, corresponds to a commission rule. If you want to distinguish sales by product category, you will need to create as many commission rules as there are categories to track. These are all conversion scripts that you will need to implement. Implementation then depends on the integration method you choose.
As with products, you will need to create two commission rules, one for old customers and one for new customers. Then, depending on your integration method, you will need to integrate and configure these two tracking scripts.
No. None of these integrations can track leads. For a lead objective, use Google Tag Manager, the manual integration or Server-to-Server, which let you track any event your website can detect.
Use Google Tag Manager, the manual integration or Server-to-Server: these three methods have no event limit.
First check that it is really necessary. If you only want to differentiate how your publishers are paid, stay with a single program and create different commission groups, or specific rules activated for one or more groups of publishers.
If two programs are really needed, note that the Affilae tracking tag handles only one program per page. Contact support to define the setup of your links and tags.
Not for the Affilae tag: it sets its cookies on your website’s domain (first-party cookies). Server-to-Server does not depend on browser cookies.
