Guide to Integrating with Prestashop

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.

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 contact interaction data differentiating by languages.
• Include root category in page category: include the “Root” category in the categories of the cn_page_category tag.
• Check that the hook top 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 the PrestaShop back office: synchronize in the Connectif contact, in addition to the basic and native fields of the module, the fields that appear activated in the module in the “Registration form fields” tab of the “Contact fields” section. If the multi-language option is enabled, it will synchronize in each Connectif store where the contact’s email exists.

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 the products.
• Use product combinations in cart and purchases: determine whether, 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 PrestaShop products as the product ID in Connectif.

• Include root category without needing to select it in the product settings: send the root category to Connectif within the product categories.

• Include category only if active: send the product’s category to Connectif only if it is active in PrestaShop.
• Calculate discount percentage based on prices: enable/disable the calculation that sets them automatically.
• 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 before its restock date in which a product will be available for pre-purchase.

3.7. Sending Purchases

(In this section, you configure the sending of purchases to Connectif from the PrestaShop module).

23. Through the Sending Purchases section, you can send purchases made in your store to Connectif, specifying a date range and the statuses to import.

STEP 4. Configuration in stores with multiple languages

24. In the Basic Configuration tab, click on  .

25. In a new browser window, access your Connectif account for the corresponding language and copy the identifying data (“Client Identifier” and “Secret Key”), just as indicated in point 10.

26. Return to PrestaShop and paste the identifying data (“Client ID” and “Secret KEY”).

27. Select the language and currency you want to synchronize with that Connectif account.

28. In the “Enabled” field, click on YES.

29. Click on   Save.

INCIDENT RESOLUTION

Find quick solutions to the most common incidents when performing an integration with PrestaShop.

1. What information does Connectif collect through this integration?

a. Information collected from Contacts

In the integrations with PrestaShop, through the tag cn_client_info, certain information about Contacts is transferred by default:

• email

• _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 as in that section. For Connectif to store the value, there must be a custom field in the Connectif Store with the same ID (see step 3.5).

b. Information collected from Products

In the integrations with PrestaShop, through the tag cn_product_visited and the daily catalog synchronization, certain information about the 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. Information collected from Purchases

In the integrations with PrestaShop, through the tag cn_purchase, certain information about the Purchases is collected by default:

• purchase_id

• purchase_date

• payment_method

• cart_id

• total_quantity

• total_price

2. No data from purchases, contacts, and/or cart events are recorded

• In Advanced Parameters, check 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 they are disabled, click Yes in the fields you need and click Save to enable them.

• Check that the Connectif module is hooked to the displayTop hook in “Design > Positions” in PrestaShop.

• Make sure that your template does not modify PrestaShop base pages (such as, for example, Checkout) and executes the displayTop hook as follows:

  {hook h='displayTop'}

• Set up your payment platform so that, after a transaction, the contact is automatically redirected to the eCommerce Purchase Confirmation page.

4. How to recover abandoned carts using the Cart Recovery URL

(This section explains how the Cart Recovery URL works to retrieve items associated with a specific cart).

Through the integration with PrestaShop, a Cart Recovery URL is sent to Connectif, meaning a link to recover the items related to that cart, which can be used in workflows and content.

To obtain the cart recovery URL through a workflow, it must be done via the node "Get last cart" and "On abandon cart", then mapped to the variables of the content to display or send.

• Learn how this URL works in different CMS platforms and how to use it in this article. 

Keep learning!

To make the most of your Connectif account, we recommend continuing with the following articles:

• Onboarding, to become proficient with our interface.

• Tracking purchases with Shopify snippet, to learn how to add the purchase tag.

• Integrations with external systems, to integrate with Facebook, forms, and webhooks from your site.

• API integrations, to manage events such as purchase registrations or contact sign-ups.