If your eCommerce is developed in PrestaShop, you can synchronize it with your Connectif account in just a few minutes and start collecting interaction data from your contacts on the website.
In this article, you will learn how to integrate your Connectif account with your PrestaShop.
Difficulty: Low.
When to use it?: When opening your Connectif account.
STEP 1. Download the module
1. Log in to your Connectif account.
2. Go to Store Settings in the left-hand side menu.
3. In the E-commerce Platforms section, find PrestaShop and click on Edit.
4. In the Configuration section, click on Download zip to download the file "connectif.zip" to your computer.
Do not close this window! You will need it later to extract the identifying data of your account.
STEP 2. Installing the module on your PrestaShop
5. Log in to the back office of your PrestaShop.
6. Go to "Modules > Modules and Services".
7. At the top right, click on Upload a module.
8. In the pop-up window, click on Select file or drag it into the dotted rectangle. The assistant will start the installation automatically.
9. Once the module is installed, click on Configure.
You can also access the configuration later from "Modules > Modules and Services > Connectif" by clicking on Configure.
STEP 3. Module configuration in PrestaShop
3.1. Linking your PrestaShop account with the Connectif module
(This section explains how to link your PrestaShop account with the Connectif module, a necessary step to complete the integration).
10. In the Basic Configuration section, click on Manage linked stores.
11. In the pop-up window, log in to your PrestaShop account.
12. Accept the permissions to link your PrestaShop account with Connectif.
13. Once the accounts are linked, a confirmation message will appear on the module configuration screen.
3.2. Basic configuration
(This section will guide you in entering your account identification data to synchronize it and start collecting real-time interaction data from your website visitors).
14. Go back to your Connectif Store (section "Integrations > PrestaShop") and copy your account’s identifying data (Client ID and Secret Key).
15. Return to the PrestaShop tab you left open (module configuration) and paste the copied data into the fields "Client ID" and "Secret KEY", respectively.
16. Ensure that the "Enabled" field is set to YES.
17. (Optional). If you have a referral code, you should enter it on this screen in the Referral Code field.
18. Click on Save.
3.3. Banners
19. No action is required in this section.
3.4. Public URLs
(This section automatically fills in the subscription/unsubscription URLs for the newsletter, as well as the Service Worker URL for push notifications).
20. No action is required in this section.
You can check these URLs in your Connectif account:
— Subscription/unsubscription URLs for the newsletter, in the integration settings:
— Service worker for push notifications, in Store Settings, “Channels > Push Notifications”.
3.5. Registration form fields
(This section indicates the contact properties collected in PrestaShop that you want to sync with Connectif).
21. In the Contact Fields section, the fields “firstname” (first name), “lastname” (last name) and “birthday” (birthday) are selected by default. If you want Connectif to synchronize any other options in this section or in Address Fields, select "Yes" for the desired fields.
To register the selected data in each contact's profile, it is necessary to create a custom field for each of them, ensuring the ID matches the one listed (e.g., id_gender). This step must be performed for all optional fields that are activated, except for the field "Newsletter", which automatically captures subscriptions. You can find more information here.
3.6. Advanced parameters
(This section configures advanced integration options).
22. For a basic integration, no action is required at this step. If you want to perform a more advanced setup, enable/disable the options you want to sync with Connectif:
General settings
- Enable multi-language: Collect interaction data from contacts based on their language.
- Include root category in the page category: Indicate that the "Root" category appears in product categories.
- Ensure that the top hook is not rendered more than once: Enable/disable discount percentage calculation based on prices.
- Enable debug logs: Enable/disable logs.
-
Sync contact information in Connectif when updating the customer from PrestaShop's back office: Syncs not only the basic and native fields of the module, but also the fields activated in the module under the Registration Form Fields tab, within the Contact Fields section. If the multi-language option is enabled, it will be synchronized with each Connectif store where the contact's email exists.
These changes are not sent to Connectif if a customer import is performed in PrestaShop or if a customer is deleted from PrestaShop.
Events
-
Purchase events: log all purchases.
-
Registration events: log registration activities.
-
Login events: log contact logins.
-
Newsletter subscription events: log newsletter subscriptions.
-
Cart status: log cart status events.
-
Search events: log search events in the eCommerce.
Product settings
- Use long description: collect the long description of products.
- Use product combinations in cart and purchases: determine whether Connectif, when receiving product information from the cart, will collect the default product or the specific combination (size, color, etc.).
- Use SKU as product identifier: use your product SKU in PrestaShop as the product ID in Connectif.
- Calculate discount percentage based on prices: enable/disable automatic discount percentage calculation.
- Include tax in discount: include VAT in discounted products.
- Round prices: round product prices in Connectif.
- Maximum availability in days: set the number of days before the restocking date in which a product will be available for pre-order.
If the remaining days until a product's availability date exceed the maximum availability in days, the item will be considered out of stock, so Connectif will not recommend it in active strategies.
- Select product image size: specify the type of product image to synchronize (it is recommended to select the same one used in the PrestaShop product page).
STEP 4. Configuration for multi-language stores
This step is only necessary if your PrestaShop has multiple languages and/or currencies.
eCommerce stores with multiple languages require the creation of an individual account for each language and currency. For more information, contact accountmanager@connectif.es.
To register language-specific data, in the previous step (17), the option "Enable multi-language" must have been activated.
23. In the Basic Configuration tab, click on .
24. In a new browser window, log in to your Connectif account for the corresponding language and copy the identifying data ("Client ID" and "Secret Key"), as indicated in step 10.
25. Return to PrestaShop and paste the identifying data ("Client ID" and "Secret KEY").
26. Select the language and currency you want to sync with this Connectif account.
27. In the "Enabled" field, click on YES.
28. Click on Save.
Success!
The integration of your Connectif account with your PrestaShop is now complete.
To verify that the integration has been successfully completed and that interaction data is being collected, click here.
TROUBLESHOOTING
Find quick solutions to the most common issues when integrating with PrestaShop.
1. Purchase data, contacts, and/or cart events are not being registered
- In Advanced Parameters, check that the following options are enabled:
-
- "Purchase events", to register purchase data.
- "Registration events", to collect contact data.
- "Cart events", to track cart statuses.
-
If they are disabled, click Yes in the required fields and then Save to enable them.
- Check that the Connectif module is hooked to displayTop in "Design > Positions" within PrestaShop.
- Make sure your template does not modify PrestaShop’s base pages (such as Checkout) and that it executes the displayTop hook as follows:
{hook h='displayTop'}
You can check PrestaShop’s official documentation by clicking here.
- Configure your payment platform so that after completing a transaction, the contact is automatically redirected to the eCommerce Purchase Confirmation page.
If executing the displayTop hook is not possible due to incompatibility with other modules, it is recommended to execute the displayConnectifTags hook on all pages and ensure that the module is correctly hooked to it.
2. Newsletter subscription statuses are not syncing
- Verify that the auto-completed URLs in the PrestaShop integration of your Connectif account match the URLs of the module installed in your PrestaShop under "Configuration > Public URLs”
- Check that the URLs exist by copying and pasting them into your browser's address bar. If a 404 error is returned, it must be corrected from the eCommerce itself.
3. How to recover abandoned carts using the Cart Recovery URL
(This section explains how the Cart Recovery URL works to retrieve the items associated with a specific cart).
Through the PrestaShop integration, a Cart Recovery URL is sent to Connectif, which allows retrieving the items related to that cart and can be used in workflows and content.
To obtain the Cart Recovery URL via a workflow, use the nodes "Get Last Cart" and "On Cart Abandonment", then map them into the content variables for display or sending.
- Learn how this URL works in different CMSs and how to use it in this article.
Keep learning!
To take full advantage of your Connectif account, we recommend continuing with the following articles:
-
Onboarding, to gain proficiency with our interface.
-
Initial Workflows, to implement your first strategies in the account.
-
Integrations with external systems, to integrate with Facebook, forms, and webhooks on your website.
-
API Integrations, to manage events such as purchase records or contact subscriptions.
-
Events that consume Activities, to better understand your account’s usage.