If your ecommerce platform is based on PrestaShop, you can sync it with your Connectif account in just a few minutes and start gathering data about your contacts’ interactions on the site.
In this article, you’ll learn how to integrate your Connectif account with PrestaShop.
Difficulty: Low.
When to use it: When you open your Connectif account.
STEP 1. Downloading the module
1. Log in to your Connectif account.
2. Go to Store Setings on the left-hand menu.
3. In the E-commerce platforms section, look for PrestaShop and click Edit.
4. In the Configuration section, click Download zip to download the file “connectif.zip” to your computer.
STEP 2. Installing the module in your PrestaShop
5. Log in to your PrestaShop’s back office.
6. Go to “Modules > Modules and services”.
7. In the top right section, click Upload a module.
8. In the pop-up, click Select file or drag it into the dotted rectangle. The assistant will start the installation automatically.
9. Once the module has been installed, click Configure.
STEP 3. Configuring the PrestaShop module
3.1. Basic configuration
(This section will show the identifying data of your account in order to sync it and start gathering data about your contacts’ interaction on the site in real time).
10. Go back to the Connectif tab you left open (“Integrations > PrestaShop” section) and copy the identifying data for your account (“Client identifier” and “Secret key”).
11. Go back to the PrestaShop tab you left open (module configuration) and paste the copied data into “Client ID” and “Secret KEY”, respectively.
12. Check that YES is selected in the “Enabled” field.
13. Click Save.
3.2. Banners
14. There’s no need to do anything in this section.
3.3. Public URLs
(In this section the URLs to subscribe to/unsubscribe from the newsletter are filled automatically, as well as that for the Service Worker for push notifications).
15. There’s no need to do anything in this section.
You can check these URLs in your Connectif account:
— Newsletter subscriptions/unsubscriptions, in the integration page.
— Push notifications service worker, in the Store Settings, “Channels > Web Push Notifications”.
3.4 Registration form fields
(This section shows the contact’s details gathered in PrestaShop that you want to sync with Connectif).
16. In the Contact fields section, the fields “firstname”, “lastname” and “birthday” appear by default. If you want Connectif to sync any of the other options in this section or the Address fields section, select “Yes” in the desired fields.
3.5. Advanced Parameters
(In this section, advanced integration options are configured).
17. For a basic integration, no action is required in this step. If you want to perform a more advanced configuration, enable/disable the options you want to synchronize with Connectif:
General Settings
- Enable multi-language: collect interaction data from contacts differentiating by language.
- Include root category in the page category: specify that the "Root" category should appear in product categories.
- Check that the top hook is not rendered more than once: enable/disable discount percentage calculation based on prices.
- Enable debug logs: enable/disable logs.
-
Synchronize contact information in Connectif when updating the customer from the Prestashop backoffice: synchronize in the Connectif contact, in addition to the basic and native fields of the module, the fields activated in the module in the Fields tab of the registration form in the Contact Fields section. If the multi-language option is enabled, synchronization will occur in each Connectif store where the contact's email exists.
Events
-
Purchase events: record all purchases.
-
Registration events: record registration activities.
-
Login events: record contact logins.
-
Newsletter subscription events: record newsletter subscriptions.
-
Cart status: record cart status events.
-
Search events: record search events in the eCommerce.
Product Settings
- Use long description: collect the long description of products.
- Use product combinations in cart and purchases: determine if, when Connectif receives product information from the cart, it will collect the default product or the specific combination (size, color, etc.).
- Use SKU as product identifier: use the SKU of your products in PrestaShop as product IDs in Connectif.
- Calculate discount percentage based on prices: enable/disable automatic calculation.
- Include tax in discount: include VAT in discounted products.
- Round prices: round product prices in Connectif.
- Maximum availability in days: set the period in days, prior to its replenishment date, during which a product will be available for pre-order.
- 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 sheet).
STEP 4. Configuration in stores with various languages
18. On the Basic configuration tab, click .
19. In a new browser window, access the Connectif account of the corresponding language and copy the identifying data (“Client ID” and “Secret key”), as indicated in point 10.
20. Go back to PrestaShop and paste the identifying data (“Client ID” and “Secret key”).
21. Select the language and currency you want to sync with your Connectif account.
22. In the “Enabled” field, click YES.
23. Click Save.
TROUBLESHOOTING
Find agile solutions to the most frequently-occurring incidents when creating a PrestaShop integration.
1. Order, contact and/or event data is not being registered.
-
In Advanced parameters, check that the following options are active:
-
- “Order events”, to register order data.
- “Registration events”, to copy contact data.
- “Cart events”, to capture cart status.
-
If they’re deactivated, click Yes in the fields you need and Save to enable them.
-
Check that the Connectif module is anchored to the displayTop hook in “Design > Positions” in PrestaShop.
-
Make sure that your templated does not modify PrestaShop base pages (such as Checkout, for example) and execute the displayTop hook like this:
{hook h='displayTop'}
- Configure your payment platform so that after each transaction, the contact is redirected automatically to the Payment confirmation page in the ecommerce platform.
2. Newsletter subscription statuses are not syncing.
-
Check that the autocompleted URLs in the integration Page of Prestashop, in your Connectif account correspond with the URLs of the module installed in your PrestaShop in “Configuration > public URLs”
- Check that the URLs exist by copying and pasting them into the address bar of your browser. If a 404 error message appears, you’ll need to correct this in the ecommerce platform itself.
3. How to Recover Abandoned Carts with the Cart Recovery URL
(This section explains how the Cart Recovery URL works to retrieve the items associated with a specific cart).
Through integration with Prestashop, Connectif receives a Cart Recovery URL, a link used to retrieve the items related to that cart and which can be used in workflows and content.
To obtain the cart recovery URL through a workflow, use the nodes "Get Last Cart" and "On Cart Abandonment," then map it in the content variables to be displayed or sent.
- Learn how this URL functions in different CMSs and how to use it in this article.
Keep learning!
To make the most of your Connectif account, we recommend reading these articles next:
-
Onboarding, to learn all about our interface.
-
Initial workflows, to implement your first strategies in your account.
-
Integrations with external systems, to integrate your Facebook, website forms and webhook.
-
API integrations, to administrate events such as order registration or contact sign-ups.
-
Events that use your Activity allowance, to understand your account consumption better.