Web Push Notifications (JS SDK)

Checking Web Push supportability

Method Objective

The method allows checking if Web Push is available in the browser.

Web Push Notifications don't work in incognito mode. The method will give a false result when the browser is in that mode.

Syntax and parameters

personaclick("subscription", "web_push_supported", callback);

Name	Type	Requirement	Description
callback	function	required	It's a callback function that takes a boolean value of the check result as a parameter.

API response

Type	Description
boolean	The result of checking Web Push support

Example of use

personaclick("subscription", "web_push_supported", function(supported) {
    if (supported) {
        // if Web Push is supported
    } else {
        // if Web Push isn't supported
    }
});

Checking permission status

Method Objective

The method checks if the user has permitted to show Web Push notifications.

Syntax and parameters

personaclick("subscription", "web_push_subscribed", callback);

Name	Type	Requirement	Description
callback	function	required	It's a callback function that takes a boolean value of the check result as a parameter.

API response

Type	Description
boolean	The result of the permission check

Example of use

personaclick("subscription", "web_push_subscribed", function(subscibed) {
    if (subscibed) {
        // if the user has permitted Web Push notifications
    } else {
        // if the user hasn't yet permitted Web Push notifications or has rejected the request
    }
});

Getting user permission

Method Objective

The method allows subscribing the user to Web Push notifications using only the system permissions window in the browser.

We recommend using the Programmatic Pop-Ups tool for more flexibility in configuring the user's subscription to Web Push notifications.

Syntax and parameters

personaclick("subscription", "web_push_subscribe", callback);

Name	Type	Requirement	Description
callback	function	required	It's a callback function that takes a boolean value of the user's subscription result.

API response

Type	Description
boolean	The result of subscription

Example of use

personaclick("subscription", "web_push_subscribe", function(subscibed) {
    if (subscibed) {
        // if the user has subscribed to Web Push notifications
    } else {
        // if the user rejects the Web Push notification subscription
    }
});

Subscribe to the "Back in Stock" trigger

Method Objective

The method subscribes the user to a web-push notification that the product is available.

You don't need to check for Web Push support, permission availability, or request it from the user using the methods available here. This method will do everything you need by itself.

Syntax and parameters

personaclick("subscribe_trigger", "product_available", params);

Name	Type	Requirement	Description
params	Object	required	Object with request parameters.

Request parameters

Name

Type

Requirement

Description

item

number/string

required

The product ID to notify of the product availability the user will be subscribed.

properties

Object

optionally

Additional product properties. The following are available:

fashion_size (number/string) - clothing size. The value of the parameter in the internal format of the store.

Example of use

personaclick("subscribe_trigger", "product_available", {
    item: "100500",
    properties: {
        fashion_size: "XL"
    }
});

Subscribe to the "Price Drop" trigger

Method Objective

The method subscribes the user to a web-push notification of a product price decrease.

You don't need to check for Web Push support, permission availability, or request it from the user using the methods available here. This method will do everything you need by itself.

Syntax and parameters

personaclick("subscribe_trigger", "product_price_decrease", params);

Name	Type	Requirement	Description
params	Object	required	Object with request parameters.

Request parameters

Name

Type

Requirement

Description

item

number/string

required

The product ID to notify of the product price drop the user will be subscribed.

price

number

required

The current product price.

properties

Object

optionally

Additional product properties. The following are available:

fashion_size (number/string) - clothing size. The value of the parameter in the internal format of the store.

Example of use

personaclick("subscribe_trigger", "product_price_decrease", {
    item: "100500", 
    price: 146.55,
    properties: {
        fashion_size: "XL"
    }
});