Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Checking Web Push supportability

Method Objective

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

Warning

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

Code Block
languagejs
themeFadeToGrey
personaclick("subscription", "web_push_supported", callback);


NameTypeRequirementDescription
callbackFunctionrequiredThe callback function that takes the API response. The API response type is a boolean.

API response

TypeDescription
booleanThe result of checking Web Push support

Example of use

Code Block
languagejs
themeFadeToGrey
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

Code Block
languagejs
themeFadeToGrey
personaclick("subscription", "web_push_subscribed", callback);

NameTypeRequirementDescription
callbackFunctionrequiredThe callback function that takes the API response. The API response type is a boolean.

API response

TypeDescription
booleanThe result of the permission check

Example of use

Code Block
languagejs
themeFadeToGrey
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.

Tip

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

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("subscription", "web_push_subscribe", callback);

NameTypeRequirementDescription
callbackFunctionrequiredThe callback function that takes the API response. The API response type is a boolean.

API response

TypeDescription
booleanThe result of subscription

Example of use

Code Block
languagejs
themeFadeToGrey
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.

Tip

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

Code Block
languagejs
themeFadeToGrey
personaclick("subscribe_trigger", "product_available", params);

NameTypeRequirementDescription
paramsObjectrequiredObject with request parameters.

Request parameters

NameTypeRequirementDescription
itemnumber/stringrequiredThe product ID to notify of the product availability the user will be subscribed.
propertiesObjectoptionally

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

Code Block
languagejs
themeFadeToGrey
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.

Tip

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

Code Block
languagejs
themeFadeToGrey
personaclick("subscribe_trigger", "product_price_decrease", params);

NameTypeRequirementDescription
paramsObjectrequiredObject with request parameters.

Request parameters

NameTypeRequirementDescription
itemnumber/stringrequiredThe product ID to notify of the product price drop the user will be subscribed.
pricenumberrequiredThe current product price.
propertiesObjectoptionally

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

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


Table of Contents
maxLevel2
classpersonaclick-fixed-position