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 sidebar menu.
3. In the E-commerce Platforms section, find PrestaShop and click Edit.
4. In the Configuration section, click Download zip to download the “connectif.zip” file to your computer.
Do not close this window! You will need it later to extract your account identification data.
STEP 2. Install the module in your PrestaShop
5. Log in to your PrestaShop back office.
6. Go to “Modules > Modules and Services.”
7. At the top right, click Upload a module.
8. In the pop-up window, click Select file or drag the file into the dotted rectangle. The wizard will start the installation automatically.
9. When the module is installed, click Configure.
You can also access the configuration later from “Modules > Modules and Services > Connectif” by clicking Configure.
STEP 3. Configure the module in PrestaShop
3.1. Basic configuration
(In this section, you will enter your account identification data to synchronize it and start collecting real-time interaction data from contacts on the website).
10. Return to your Connectif Store (section “Integrations > PrestaShop”) and copy your account identification data (Client ID 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. Make sure the “Enabled” field is set to YES.
13. Click Save.
3.2. Banners
14. No action is needed in this section.
3.3. Public URLs
(In this section, the URLs for newsletter subscriptions/unsubscriptions and the Service Worker for push notifications are automatically filled in).
15. No action is needed in this section.
You can check these URLs in your Connectif account:
— Newsletter subscriptions/unsubscriptions, in the integration settings:
— Push notification Service Worker, in Store Settings, “Channels > Push Notifications”.
3.4. Registration form fields
(In this section, you indicate the contact properties collected in PrestaShop that you want to synchronize with Connectif).
16. In the Contact fields section, “firstname” (first name), “lastname” (last name), and “birthday” (birthdate) are selected by default. If you want Connectif to synchronize any other options in this section or in Address fields, mark “Yes” on the desired fields.
To register the selected data in each contact’s profile, it is necessary to create a custom field for each one, where the ID matches the one shown in the list (for example, id_gender). This step must be done for all optional fields enabled, except for the “Newsletter” field, which automatically captures subscriptions. You can find more information about this here.
3.5. Advanced settings
(In this section, advanced integration options are configured).
17. For a basic integration, no action is needed 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 differentiated by languages.
Include root category in page category: include the “Root” category in the categories of the cn_page_category tag.
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 PrestaShop back office: synchronize with the Connectif contact, in addition to the basic and native module fields, the fields enabled in the module under the Registration form fields tab 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.
These changes are not sent to Connectif if customers are imported in PrestaShop or if a customer is deleted from PrestaShop.
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 eCommerce search events.
Product settings
Use long description: collect the long description of products.
Use product combinations in cart and purchases: determine whether Connectif will collect the default product or the specific combination (size, color, etc.) when receiving product information from the cart.
Use SKU as product identifier: use the SKU of your PrestaShop products as product IDs in Connectif.
Include the root category without needing to select it in the product configuration: send the root category to Connectif as part of the product categories.
Include category only if active: send the product category to Connectif only if it is active in PrestaShop.
Calculate discount percentage based on prices: enable/disable automatic calculation of discount percentages.
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 restock date during which a product will be available for pre-order.
If the days remaining until a product’s entry 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 on the PrestaShop product page).
3.6. Sending purchases
(In this section, you configure sending purchases to Connectif from the PrestaShop module).
18. Through the Send Purchases section, you can send to Connectif the purchases made in your store by specifying a date range and the order statuses to import.
To learn how to send purchases from PrestaShop to Connectif, check this article.
STEP 4. Configuration for stores with multiple languages
You only need to perform this step if your PrestaShop has multiple languages and/or currencies.
Multi-language eCommerces require opening an individual account for each language and currency. For more information, contact accountmanager@connectif.es.
To record data differentiated by language, the “Enable multi-language” option must have been activated in the previous step (17).
19. In the Basic configuration tab, click .
20. In a new browser window, access your Connectif account for the corresponding language and copy the identification data (“Client ID” and “Secret Key”), as indicated in step 10.
21. Return to PrestaShop and paste the identification data (“Client ID” and “Secret KEY”).
22. Select the language and currency you want to synchronize with that Connectif account.
23. In the “Enabled” field, click YES.
24. Click Save.
Success!
Your Connectif account integration with your PrestaShop is now ready.
To verify that the integration has been completed correctly and that interaction data is being collected, click here.
TROUBLESHOOTING
Find quick solutions to the most common issues when integrating with PrestaShop.
1. What information does Connectif collect through this integration
a. Contact information collected
In PrestaShop integrations, through the cn_client_info tag, certain information about Contacts is transferred by default:
- _name
- _surname
- _birthdate
- _newsletter_subscription_status
Additionally, in the Connectif module settings in PrestaShop, there is a section that allows enabling other contact fields. These fields will be added to the cn_client_info tag with the same identifier shown in that section. For Connectif to save the value, a custom field with the same ID must exist in the Connectif Store (see step 3.5).
b. Product information collected
In PrestaShop integrations, through the cn_product_visited tag and the daily catalog synchronization, certain information about Products is collected by default:
- quantity
- price url
- product_id
- name
- description
- image_url
- unit_price
- availability
- brand
- published_at
- category
- related_external_product_id
- tag
c. Purchase information collected
In PrestaShop integrations, through the cn_purchase tag, certain information about Purchases is collected by default:
- purchase_id
- purchase_date
- payment_method
- cart_id
- total_quantity
- total_price
2. Purchase, contact, and/or cart event data is not being recorded
-
In Advanced settings, verify that the following options are enabled:
“Purchase events” to record purchase data.
“Registration events” to collect contact data.
“Cart events” to capture cart states.
If disabled, click Yes on the fields you require and Save to enable them.
- Check that the Connectif module is hooked to displayTop in “Design > Positions” in PrestaShop.
-
Make sure your theme does not modify base PrestaShop pages (such as the Checkout) and executes the displayTop hook as follows:
{hook h='displayTop'}
You can check the official PrestaShop information by clicking here.
Configure your payment platform so that after a transaction, the contact is automatically redirected to the eCommerce’s Purchase Confirmation page.
If you cannot execute the displayTop hook due to incompatibilities with other modules, it is recommended to execute the displayConnectifTags hook on all pages and ensure the module is correctly hooked to it.
3. Subscription status to the newsletter is not synchronized
Verify that the URLs automatically filled in your Connectif account’s PrestaShop integration match the URLs in the installed PrestaShop module under “Configuration > Public URLs”
Check that the URLs exist by copying and pasting them into your browser’s address bar. If a 404 error appears, it must be corrected from the eCommerce itself.
4. How to recover abandoned carts with the Cart Recovery URL
(This section explains how the Cart Recovery URL works to obtain the items associated with a specific cart).
Through the PrestaShop integration, a Cart Recovery URL is sent to Connectif, which is a link to retrieve the items related to that cart and can be used in workflows and content.
To obtain the cart recovery URL through a workflow, it must be done using the "Get last cart" and "On cart abandonment" nodes, then mapped in the variables of the content to be shown or sent.
- 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 like purchase registrations or contact sign-ups.
Events that consume Activities, to better understand your account’s consumption.