About our extension
Our Searchspring extension is specifically designed to facilitate a seamless data connection between your Shopware store and Searchspring. With this extension, you can effortlessly fetch and sync product data from your Shopware catalog into Searchspring's indexing process.
You can find the extension here:
Before you get started
You must have a Searchspring account before proceeding with this installation guide. Without an account, you will not be able to establish the connection with Searchspring.
If you are a current customer:
- and have already been set up with access to the Searchspring Management Console (SMC), proceed to the next step.
- and you do not have an account to access the SMC, please request that your main team contact adds you as a “User” in the User Website Management section of the SMC. Once you are able to access the SMC, proceed to the next step.
If you are not currently a customer:
- Please visit searchspring.com to learn more about how we can help you deliver the ultimate shopper experience.
Pre-installation setup
Ensure all Searchspring IP addresses are added to your allow list.
Creating a new role
In your Shopware settings, create a new “Role” for Searchspring with the following authorizations:
General
- Catalogues (view)
- Customers (view)
- Orders (view)
Detailed privileges
- document_type_translation (view)
- customer_group_registration_sales_channels (view)
- product_search_keyword (view)
Installation and integration
Installing the extension
1. From your Shopware Administration portal, go to Extensions > Store and search for “Searchspring”.
2. Complete the purchase of the free Searchspring extension.
3. Install from either the Searchspring extension page in the Shopware Shop OR from the list of extensions you have access to under Extensions > My extensions.
Adding the integration
4. In the Shopware Administration portal, click “Settings” in the main menu and select “Integrations” under the “System” tab.
5. Click the “Add integration” button.
6. On the “Create integration” popup, provide a name for this integration and select the role that was created in the “Creating a new role” section of this guide.
7. Save a copy of the “Access key ID” and “Secret access key” for later use and click “Save integration”.
Authentication
8. Go to the “Data Feeds” page in the SMC and ensure the “Shopware” platform is selected.
9. Fill in the following fields under “Feed Settings”:
- Service URL
- Store URL
- Client ID (Access key ID)
- Client Secret (Secret access key)
10. Click “Save” at the bottom of the page.
Configuring the extension
11. From your Shopware Administration portal, go to Extensions > My extensions and locate the Searchspring extension. Click on the “…” button and select “Configure”.
12. Fill in/select the following fields under “Searchspring Configuration”
- Sales Channel: You can keep the default configuration of “All Sales Channels” or select a specific sales channel.
- Searchspring Site ID: You can find your Site ID in the “My Account” section in the SMC.
- Searchspring Integration: Set to enable.
- Shopper Event Tracking: Set to enable.
13. Once the changes are saved, reach out to your Searchspring point of contact.
Additional Information
Searchspring Cookies
In all Searchspring integrations the User Tracking cookies are required for various API endpoints to primarily allow our reporting to function properly. If you are signed up for Personalized Recommendations and/or Personalized Search & Merchandising the Personalization Tracking cookies are required to be set.
| Name | Expiration | Description |
| _isuid | 1 year |
A randomly generated unique identifier (legacy) |
| ssUserId | 1 year | A randomly generated unique identifier (uuid) |
| ssSessionIdNamespace | Session based | A randomly generated unique session identifier (uuid) |
| ssCartProducts | Session based | A list of product SKUs in cart used for personalization |
| ssViewedProducts | 7 years | A list of product SKUs from the last viewed product page used for personalization |
| ssShopperId | Session based | A shopper identifier (username or id) |
Comments
0 comments
Please sign in to leave a comment.