Installation
Step 1: Code Integration
To integrate Sovendus Push on your site, the following code must be integrated within the area.
<script async src="https://www.sovopt.com/OPTIMIZE_ID"></script>Step 2: Upload Sovendus Service Worker File
The next step is to upload the Sovendus Service Worker File to your server. The best way to do this is as follows:
- Download the Sovendus Service Worker file.
- Unzip the Sovendus Service Worker ZIP file. The ZIP file should contain the following file::
- https://yoursite.com/sovendus-service-worker.js
- Upload the Sovendus Service Worker file on the web server. The file must then be publicly accessible under the domain with which you also want to send push messages. (z.B. https://yoursite.com/sovendus-service-worker.js).
If you do not want to store the file in the root directory, you can also store the file in a subdirectory. Further information can be found here.
If you cannot include the file via PHP, please make sure that the following headers are set:
Service-Worker-Allowed: /
Content-Type: application/javascript
X-Robots-Tag: none
Step 3: Conversion Tracking (optional)
If you want to measure the conversions caused by Sovendus Push, the following tracking must be integrated on the order completion page of your shop. The tracking serves to measure the transactions mediated by Sovendus Push and to display them in the dashboard.
<script async src="https://www.sovopt.com/OPTIMIZE_ID/conversion/?ordervalue=XXX&ordernumber=XXX&vouchercode=XXX&email=XXX&subtext=XXX"></script>| Parameter | Description | Value | Mandatory |
| OPTIMIZE_ID | Unique customer ID | OPTIMIZE_ID | X |
| ordervalue | Total value of the order (z.B. 243.30) | Dynamic | X |
| ordernumber | Ordernumber | Dynamic | X |
| vouchercode | Vouchdercode This parameter is only mandatory in connection with voucher code tracking. | Dynamic | X |
| E-mail address of the customer | Dynamic | ||
| subtext | Self-definable field to transmit additional information about the order | Dynamic |
The values ordervalue, ordervalue and vouchercode must be replaced dynamically with the effective order values. The order value must be separated by a dot and submitted as follows: Example: 50.00
The vouchercode entered during the ordering process must be submitted in the variable “vouchercode”. In case no vouchercode was entered in the ordering process an empty string can be submitted in this variable.
Integration via Google Tag Manager
You can integrate Sovendus via the Google Tag Manager. In the following print screen you can see how our script has to be integrated.
