Nudge API

In addition to the nudge editor in our platform, nudges also comes with a powerful API that let's you create, control and make use of various events. The nudge API can also be used in addition to nudges created with the platform, to easier maintain the text fields used.

There's various types of nudges to make use of, based on your needs. Each type comes with its own properties and functionality, but all share a set of the same values. Values needs to be wrapped in a sections array, to split up object throughout the nudge as well. See each nudge type below for example recipes.

Nudges created with the editor each have a identifying slug string, which is used when calling the nudge from the API.

A form nudge is a great way to handle subscriptions on your website without being too intrusive, for example a newsletter signup, or to download an e-book. It comes with a call to action in form of an input and a button. When the form is submitted it can call a webhook, and trigger a specific dialogue of your choice.

Example recipe

With the product nudge you can showcase a hand picked selection of products, and is great for promoting either current offers or best sellers. Similar to the form nudge it also comes with a call to action, but in the form of a button. Each product is represented with a image, title, description, price and call to action. In the example below, we use multiple sections to divide up our nudge content.

Example recipe

Multiple choice nudge is a great way to collect feedback on various aspect of your website. It supports an array of buttons, which each has an attached dialogue it will trigger when pressed. In the example below, we use multiple sections to divide up our nudge content.

Example recipe

When using the API to trigger a nudge, it's possible to pass both a nudgeLayout object, and a slug string. When this is done, both nudges will be combined into one. This can be useful if you have nudge created using the API, but need to easily maintain texts from the platform.

The custom nudge is a more powerful nudge type, which let's you completely customize the contents of the nudge. It accepts either a string or a function, which can contain some HTML code.

Custom nudges supports its own trigger function, depending on whether or not you want our template to wrapp your nudge or build your own.

If you want the nudge to be completely custom, it's fine to send in the HTML as a string. See example below.

HTML can be passed as a function to make use of text content from the platform. This is useful if you have a custom nudge solution, but need to easily maintain its texts. Simply create a custom nudge from the editor, and call the text blocks slug to display it.

Triggering a custom nudge is slightly different than the other nudge types, as it uses HTML content. You can choose between using our nudge template, or create your own from scratch. The template includes our nudge element with built-in styling and responsiveness.

Using our nudge template, the content sent as it can be triggering like this:

On the other hand, a completely custom solution use the following function:

For a comprehensive list of functions and callbacks can be found here