Managing Application notifications
You can create notifications to be informed about the following events occurring within the Applications of your choice. Depending on the notification type, you can create one or more notifications of each type.
Notification type | Event that triggers a notification |
---|---|
Campaign-related changes Real-time |
|
Strikethrough pricing updates Real-time |
info Changes in collections trigger notifications only when the collections are used in strikethrough campaigns. info Editing a campaign evaluation tree will trigger notifications only if the strikethrough campaign is a part of the campaign evaluation tree. info If the strikethrough feature is enabled for a campaign, editing a custom attribute triggers a notification only when the attribute is used in the Rule Builder or in cart item filters. |
Coupon-related changes Real-time |
|
- After a qualifying event occurs, a notification can take up to 5 minutes to be sent.
- To learn about the loyalty-specific notification types, see Managing loyalty notifications.
- Campaign-related changes:
- Two requests are sent for the same notification: One for campaign evaluation tree changes, which occur at the Application level, and another for all other campaign-related events.
- You cannot select which notifications to receive. Notifications are sent for all events and for all campaigns within an Application.
Creating a campaign notification
Create campaign notifications to receive updates about campaign-related changes.
To create a campaign notification:
- Select the Application for which you want to set up campaign notifications.
- On the left-side menu, click Notifications.
- Click Create Notification > Campaign-related changes.
- In Notification name, type a name for the notification.
- In URL, type the URL where you want to receive notifications.tip
To add another destination URL, create another notification.
- In Header, type a full HTTP header. For example:
Content-Type: application/json
. - (Optional) Click Add header for each additional header value required by the receiving party, and enter the corresponding headers.
- Click Create Notification.
- Review the schemas of the notifications you will receive and parse them as required.
Creating a strikethrough pricing notification
Create strikethrough pricing notifications to receive updates about strikethrough pricing. When you create a strikethrough pricing notification, it is automatically activated.
You can create only one notification of this type.
To create a strikethrough notification:
- Select the Application for which you want to set up strikethrough pricing notifications.
- On the left-side menu, click Notifications.
- Click Create Notification > Strikethrough pricing updates.
- In Notification name, type a name for the notification.
- In URL, type the destination URL.
- In Header, type a full HTTP header. For example:
Content-Type: application/json
. - (Optional) Click Add header for each additional header value required by the destination URL, and enter the corresponding headers.
- Click Create Notification.
- Review the schemas of the notifications you will receive and parse them as required.
Creating a coupon notification
Create coupon notifications to receive updates about coupon-related changes. When you create a coupon notification, it is automatically activated.
You can create only one notification of this type.
To create a coupon notification:
- Select the Application where you want to set up a coupon notification.
- On the left-side menu, click Notifications.
- Click Create Notification > Coupon-related changes.
- In Notification name, type a name for the notification.
- In the Notification sources section,
specify which sources should trigger a notification:
- Campaign Manager: Notify only when coupons are created, updated, or deleted through the Campaign Manager.
- Management API: Notify only when one of the following endpoints is called:
- Rule Engine: Notify only when coupon changes occur
as the result of one of the following coupon-related API effects:
- couponCreated effect
- updateAttribute effect
- In the Request section, specify the details of the webhook request:
- Verb indicates the HTTP request method:
POST
. - In URL, type the URL where you want to receive the notification.
- In Header, type a custom header that describes the request.
- (Optional) Click Add header for each additional header value required by the receiving party, and enter the corresponding headers.
- Verb indicates the HTTP request method:
- Review the schemas of the notifications you will receive.
- Click Create Notification.
Deactivating a notification
To stop receiving updates from a notification, you can deactivate it. You can reactivate the notification at a later time.
Campaign notifications are active by default and cannot be deactivated. To stop receiving updates from a campaign notification, consider deleting it.
To deactivate a notification:
- On the left-side menu of the Application, click Notifications.
- To the right of the notification, toggle Active.
- In the confirmation window, click Deactivate Notification.
To reactivate a notification, follow the above steps, and in the confirmation window, click Activate Notification.
Editing a notification
You can edit the details of a notification at any time.
To edit a notification:
- Select the Application where you want to edit the notification.
- On the left-side menu, click Notifications.
- Click the edit symbol for the notification.
- Edit the required details, and click Save.
Deleting a notification
You can delete a notification to stop being notified about updates through a given route. To stop receiving updates but retain the notification, consider deactivating the notification instead.
To delete a notification:
- Select the Application where you want to delete a notification.
- On the left-side menu, click Notifications.
- Click next to the notification.
- In the confirmation pop-up that appears, click Delete Notification.