|
| 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 | + |
| 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 | + |
| 67 | + |
| 68 | + |
| 69 | + |
0 commit comments