Skip to content

Commit bab3196

Browse files
committed
add commerce abandoned cart notification job
1 parent 5b18b13 commit bab3196

File tree

3 files changed

+69
-0
lines changed

3 files changed

+69
-0
lines changed
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
description: Learn how to configure the abandoned cart notification.
3+
---
4+
5+
# Configuring Abandoned Cart Notification
6+
7+
{% hint style="info" %}
8+
Available from Umbraco Commerce 16.1.0
9+
{% endhint %}
10+
11+
## Abandoned Cart Recurring Background Job
12+
13+
The abandoned cart recurring background job automatically sends reminder emails to customers about items left in their shopping carts. You can configure it using the steps below:
14+
- Go to Store Settings in your admin dashboard.
15+
- Select the store you want to configure.
16+
- Scroll down to the Notification Settings section.
17+
- Choose your Abandoned Cart Email Template. If the email template is not set, no notification will be sent but the webhooks can still be fired.
18+
- Set the period of minutes that a cart must be inactive before it is deemed to be abandoned. If the value is 0, the abandoned cart detection is disabled.
19+
- Enter the landing page url for customers to be redirected to when they click on the links in the abandoned cart email.
20+
- Click the Save button to apply your changes.
21+
22+
![store notification settings](images/configuring-abandoned-cart-notification/store-notification-settings.png)
23+
24+
25+
The advanced settings can be configured in the `appsettings.json`
26+
27+
```json
28+
{
29+
"Umbraco" : {
30+
"Commerce": {
31+
// Optional settings
32+
"AbandonedCartNotifierService": {
33+
"FirstRunTime": "",
34+
"Period": "1.00:00:00",
35+
"NotificationBatchSize": 20
36+
}
37+
}
38+
}
39+
}
40+
```
41+
42+
The `appsettings.json` section supports the following keys.
43+
44+
| Key | Description |
45+
| -- | -- |
46+
| `FirstRunTime` | The time to first run the scheduled cleanup task, in crontab format. If empty, runs imediately on app startup. |
47+
| `Period` | How often to run the task, in timespan format. Defaults to every 24 hours. |
48+
| `NotificationBatchSize` | The number of abandoned carts processed each time the job is run. |
49+
50+
## Abandoned Cart Webhook
51+
A new webhook called Cart Abandoned has been added. It is triggered when the Abandoned Cart Recurring Background Job detects any abandoned carts. The POST payload will look like this:
52+
```json
53+
{
54+
"orderIds": [
55+
"8b2cfad6-a0eb-4b87-ad86-019768ad1308",
56+
"95aa34bd-8a01-45a4-9492-019768ac6c61",
57+
"db9a2cc5-621a-40a3-9fab-019768a79d0a"
58+
]
59+
}
60+
```
61+
62+
## Abandoned Cart Conversion Rates Widget
63+
64+
The Abandoned Cart Conversion Rates widget shows how effectively your store recovers lost sales by tracking the percentage of notified abandoned carts that turn into completed purchases.
65+
66+
![Abandoned cart conversion rates widget](images/configuring-abandoned-cart-notification/abandoned-cart-conversion-rates-widget.png)
67+
68+
69+
37.2 KB
Loading
66.9 KB
Loading

0 commit comments

Comments
 (0)