If the webshop is built with a custom-made platform or one of the platforms Lipscore does not have an app for, you can still implement Lipscore on the website via API and by manually adding widgets to your store frontend.

This is what you need 

• Lipscore API documentation 
• Access to the source code of your website
• A valid physical store account with Lipscore.com
• Widgets library
• The API keys (codes that identify your site in the Lipscore network) which can be found in the Settings – General – API settings after logging in on https://members.lipscore.com/login 
• Information from the customer / Lipscore Onboarding manager on which widgets should be implemented on the website, and possibly the preferred placements
• This explanatory video by our CEO & CTO on how to do the API integration

The steps necessary to complete the implementation  

1. Create a backend connection for order data transfer between Lipscore’s and the customer’s database via API.

Important notes: 

• It is crucial that Invitation[source_id] and Invitation[source_name] are transferred to Lipscore via the integration. If you are collecting and displaying service reviews on your physical stores, make sure these datapoints are also included in the widgets on physical store pages so that relevant reviews are displayed on a specific store page. You may also use invitation[parent_source_id] but it will be optional – for instance have parent IDs for regions (Østlandet, Vestlandet, etc.) and then using them in the total-score widget instead of inserting each source_id separately. 
• Apart from required data: please make sure to send GTIN numbers to Lipscore if the customer wants to display Lipscore ratings and reviews in Google Shopping ads. Also, please send product category data to Lipscore in addition so that customer can enjoy some of our additional functionalities (e.g., product attributes / true-to-size functionality, blocking invitations for selected product categories, and others). Long story short, the more data is sent to Lipscore, the better analytics and functionality we can offer to the webshop.
• Product identifiers: please make sure that product IDs used in the integration in the backend (products[][internal_id]) and in the widgets (data-ls-product-id) are identical. Our recommendation is that you use parent product IDs. If you are implementing Lipscore in both online and physical stores, the IDs in both integrations also have to match. Otherwise, reviews collected from physical stores will not show in the widgets on the website.
• The preferred order status that will trigger the transfer of order data from customer’s database to Lipscore’s should be when order is shipped / delivered to the shopper (if ordered in physical store but sent to customer) or when order is paid / collected for (when purchase is made in-store), or alike.

2. Add Initializer script in the Head tag of every page of your webshop

To enable Lipscore widgets on your website, it’s essential to embed our JavaScript/HTML initializer script inside the head tag of every page. This script remains constant across all pages and should not be modified.

However, there are two key elements in the script that require your attention:

• Language Code: In the script’s URL, you’ll find a language code segment (e.g., “/en/”). You must choose the appropriate code from the available options: en, no, se, dk, fi, fr, de, br, cz, it, es, pl.
• API Key: This is unique to your Lipscore account and can be located under Settings > General > API Keys.

Important Addition for Multiple Accounts: If you are managing multiple accounts, such as one for physical stores (Point of Sale, POS) and another for webstores, you need to apply a specific approach:

• Main Webstore Pages: Embed the standard initializer script with the webstore’s API key in the head tag of all main webstore pages.
• Landing Pages for Additional Stores: For any landing pages dedicated to your additional stores (e.g., mywebstore.com/landingpages/pos), use an initializer script that incorporates the API key of the corresponding store (in this example, the POS store).

This method ensures that customers are redirected to the correct webpage, and their reviews are accurately associated with the appropriate store account.

You can find the Initializer script’s code in the Widgets library.

3. Open the Widgets library and add all relevant rating/review widgets 

It is the website owner / manager / Onboarding manager at Lipscore who specifies which widgets are supposed to be implemented. Important note:

• Widgets for physical store page and stores overview pages can be found under Physical store widgets.
• If product reviews are to be collected from physical store shoppers, implementing the Rating widget on product pages is crucial for Schema.org markup (rich snippets displaying in Google organic search) and for sending information about product ratings and reviews to the Google Shopping XML feed. 

4. Test the integration following these instructions. 

5. Send a confirmation email to the customer and Onboarding manager that the integration is completed. 

If you have any problem whatsoever getting our software to work on your site don’t hesitate to contact us at [email protected] or reach out to the Onboarding Manager assigned to your webshop.  

We will be happy to help!