Configuring subscribes and unsubscribes
Note
This topic is for administrators and developers with administration access rights in Shopware.
This topic describes how to configure the newsletter subscription and unsubscription feature, if you are using Shopware as an e-commerce platform with Optimizely Campaign. The Shopware integration uses standard formulas that contain Shopware for newsletter registration. You cannot add fields.
Note
See Advanced configuration how to work with multiple sub-shops and language versions.
To configure subscribes and unsubscribes, do the following:
- Configure the opt-in mailing (registration confirmations) in Optimizely Campaign, then use a field function to reference the confirmation link to your shop.
- Insert the opt-in ID and the authorization code (for recipient consent) in Shopware.
- Enable the use of the double opt-in method in Shopware.
yT9R-configuring-subscribes-and-unsubscribes.mdxStep 1. Configuring the opt-in mailing
- Open the Optimizely Campaign menu and select Campaigns >Opt-in processes.
- Select the opt-in process for the connection to your shop and click Edit….
- On the Email node, click Properties .
- Click Edit Content….
- Click the name of the paragraph that contains the registration confirmation link.
- In the Text area, click Source.
- Replace the existing link with the following code lines or field functions:
{Double-Opt-In-Link}?hash={customer-id}&shop-id={shop-id}&shop={shop}You can find the link that you need to replace between the <a> tags in quotation marks. Example In the source code, the following link is contained in <a> tags:
<a href="http://srv2.de/subscribe.html">Confirm subscription</a>Replace the link marked in red in quotation marks as follows:
<a href="{Double-Opt-In-Link}?hash={customer-id}&shop-id={shop-id}&shop={shop}">Confirm subscription</a>
Note
The Shopware integration accepts the referral (the call), and identifies the customer by the hash parameter and the store or subshop, using the shop-id and shop parameters, respectively.
- Click Apply > Close > Save and close.
yT9R-configuring-subscribes-and-unsubscribes.mdxStep 2. Inserting the opt-in ID and the authorization code
For this step, you need to insert two values in your Shopware system:
- The opt-in ID used to record recipient consent. To see the opt-in ID, open the Optimizely Campaign menu and select Administration > API overview > Opt-in processes.
- The authorization code for the recipient list that Optimizely customer support has generated to connect your shop. To locate this in Optimizely Campaign, select Administration > API overview > Recipient lists tab. Select the corresponding recipient list and click Manage authorization codes. If no authorization code is presently available for this recipient list, click Create authorization code.
Note
Do not confuse the recipient list for your newsletter recipients with the transaction recipient list for your transactional mails. Customer support sets up two different types of recipient lists for the sending of newsletters and the sending of transactional mails (for example order confirmations, invoices).
- Log in to the back-end of Shopware using administrator rights.
- Go to Configuration > Plugin Manager.
- On the left side of the menu bar, click Installed.
- In the list, find the Shopware integration for Episerver Campaign in the Plugin Manager, and click Open .
- In the Configuration area, in the optivo bmOptInID box, enter the opt-in ID.
- In the Configuration area, in the optivo Authorization Code box, enter the authorization code of your recipient list.
- Click Save.
yT9R-configuring-subscribes-and-unsubscribes.mdxStep 3. Enabling the double opt-in method
- In Shopware, go to Configuration > Basic settings.
- Go to Additional settings > Privacy.
- In the Double opt in for newsletter subscriptions drop-down list, select Yes.
- Click Save.