-
Notifications
You must be signed in to change notification settings - Fork 803
Add commerce abandoned cart notification job #7200
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 4 commits
Commits
Show all changes
11 commits
Select commit
Hold shift + click to select a range
bab3196
add commerce abandoned cart notification job
umbracotrd 7994f3c
update abandoned carts job configuration; serve vale
umbracotrd e0772c4
update optional settings and mandatory settings
umbracotrd c65a46d
add new article to the summary.md
umbracotrd 3a7423b
Update 16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-n…
umbracotrd c00bbdd
Update 16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-n…
umbracotrd c93063e
Update 16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-n…
umbracotrd b7530d9
Update configuring-abandoned-cart-notification.md - update appsetting…
umbracotrd 3d728cb
Update configuring-abandoned-cart-notification.md - update the appset…
umbracotrd 2662b72
Update 16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-n…
eshanrnh ee5e5cd
Update 16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-n…
eshanrnh File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
67 changes: 67 additions & 0 deletions
67
16/umbraco-commerce/how-to-guides/configuring-abandoned-cart-notification.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,67 @@ | ||
--- | ||
description: Learn how to configure the abandoned cart notification. | ||
--- | ||
|
||
# Configuring Abandoned Cart Notification | ||
|
||
{% hint style="info" %} | ||
Available from Umbraco Commerce 16.1.0 | ||
{% endhint %} | ||
|
||
## Abandoned Cart Recurring Background Job | ||
|
||
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: | ||
- Go to Store Settings in your admin dashboard. | ||
- Select the store you want to configure. | ||
- Scroll down to the Cart Settings section. | ||
- 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. | ||
- 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. | ||
- Enter the landing page URL for customers to be redirected to when they click on the links in the abandoned cart email. | ||
- Click the Save button to apply your changes. | ||
|
||
 | ||
|
||
|
||
The advanced settings can be configured in the `appsettings.json` | ||
umbracotrd marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
```json | ||
{ | ||
"Umbraco" : { | ||
"Commerce": { | ||
"AbandonedCartNotifierService": { | ||
"Enable": false, // Set to true if you want to enable the background job | ||
"FirstRunTime": "", // Optional settings | ||
"Period": "1.00:00:00", // Optional settings | ||
"NotificationBatchSize": 20, // Optional settings | ||
} | ||
} | ||
} | ||
} | ||
``` | ||
|
||
The `appsettings.json` section supports the following keys. | ||
eshanrnh marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
| Key | Description | | ||
| -- | -- | | ||
| `Enable` | Enable this feature. | ||
| `FirstRunTime` | The time to first run the scheduled cleanup task, in crontab format. If empty, runs imediately on app startup. | | ||
umbracotrd marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| `Period` | How often to run the task, in timespan format. Defaults to every 24 hours. | | ||
| `NotificationBatchSize` | The number of abandoned carts processed each time the job is run. | | ||
|
||
## Abandoned Cart Webhook | ||
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: | ||
```json | ||
{ | ||
"orderIds": [ | ||
"8b2cfad6-a0eb-4b87-ad86-019768ad1308", | ||
"95aa34bd-8a01-45a4-9492-019768ac6c61", | ||
"db9a2cc5-621a-40a3-9fab-019768a79d0a" | ||
] | ||
} | ||
``` | ||
|
||
## Abandoned Cart Conversion Rates Widget | ||
|
||
The widget shows how many notified abandoned carts are recovered through completed purchases, reflecting your store’s abandoned cart conversion rate. | ||
|
||
 |
Binary file added
BIN
+37.2 KB
...figuring-abandoned-cart-notification/abandoned-cart-conversion-rates-widget.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+75.4 KB
.../images/configuring-abandoned-cart-notification/store-notification-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.