Nudgify

Nudgify is a social proof and urgency app that displays real-time notifications (called “nudges”) on your website to increase conversions. It works by showing messages such as:

“12 people viewed this product in the last 24 hours”
“Anna from London just bought this item”
“Low stock — only 2 left!”

Nudgify integrates with ShopWired through a multi-step process, described in this help guide to automatically display nudges using your store’s order, product, and visitor data without custom coding.

Follow the instructions in the sections below to configure your Nudgify account:

Create your Nudgify account here
Create Smart webhooks as described below corresponding to the types of nudges that you want to create
Configure your Nudgify account settings

ShopWired can only provide support to you on the instructions provided in this help guide, for assistance with your Nudgify account contact Nudgify support directly.

Installing Nudgify on your ShopWired website

Once you've created your Nudgify account, follow the instructions in this Nudgify help guide to install Nudgify on your ShopWired theme.

Nudgify will provide you with some HTML code to add to your website similar to the example shown below:

<script>
    (function(w){
        var k="nudgify",n=w[k]||(w[k]={});
        n.uuid="7df05200-0ded-9273-b936-c33dj3c3787c";
        var d=document,s=d.createElement("script");
        s.src="https://pixel.nudgify.com/pixel.js";
        s.async=1;
        s.charset="utf-8";
        d.getElementsByTagName("head")[0].appendChild(s)
    })(window)
</script>

Add this code to your theme's master.twig file (so that it is displayed on every page of your website) by navigating to Website > Themes and selecting the code editor option for the theme that you'd like to install it on.

Add the code just before the closing </body> tag.

Nudgify purchase nudges

To show Purchase Nudges on your website, as shown in the example below, you will need to create a new Smart within your Nudgify account.

Navigate to the Integrations page within Nudgify
Locate the Smart Webhooks section
Select the +Create Smart Webhook option
Select the Purchases option
Name the Smart Webhook with a custom name, e.g. ShopWired Orders
A Webhook URL will be displayed which you should copy to your computer's clipboard
- e.g. https://collect.nudgify.com/webhook/smart-webhook/9d76fd5b-cd2a-4f4b-b490-8457fa3887c9
- Do not select the Check for data option, you will do that in the next step
Navigate to your ShopWired account and to Your account (top right) > API & webhooks
Navigate to the Webhooks section and select Create webhook
Select the Webhook topic as order.finalized and enter the webhook URL into the Enter the notification URL for the webhook setting

Next, you'll need to simulate a purchase on your ShopWired account so that you can configure the webhook within Nudgify.

You should complete these steps in order, steps (2) and (3) should be completed in short succession

Prepare to create an order in your ShopWired account, configuring all the test data for the order but do not create the order
Navigate back to Nudgify and select the Check for data option
Quickly navigate back to the prepared order within ShopWired and select Create order
- If you are prompted to configure a payment for the order select to Proceed without payment
Once Nudgify receives the webhook, its contents will be displayed and you can proceed to the next step.

Next, you will need to map the data from the webhook to Nudgify's fields:

Nudgify data mapping field	ShopWired webhook data
Date	`event.data.object.created`
Email	`event.data.object.billingAddress.emailAddress`
Order ID	`event.data.object.id`
First Name	Skip this field
Last Name	Skip this field
Full Name	`event.data.object.billingAddress.name`
City	`event.data.object.billingAddress.city`
State	Skip this field
Country	`event.data.object.billingAddress.country`
IP Address	Skip this field
Product details
Product ID	`event.data.object.products.0.sku` or `event.data.object.product.0.id`
Product Variation ID	Skip this field
Product Name	`event.data.object.products.0.title`
Product Page Link	`event.data.object.products.0.url`
Product Image URL	`event.data.object.products.0.imageUrl`

Consult the Nudigfy help guide on smart webhooks for more information.

Sample webhook data (many parts have been removed for simplicity) is displayed below:

{
  "event": {
    "data": {
      "object": {
        "id": {{ order.id }}
        },
        "created": "{{ order.date }}",
        "products": [
          {
            "id": "{{ product.id }}",
            "sku": "{{ product.sku }}",
            "url": "{{ product.url }}",
            "title": "{{ product.title }}",
            "imageUrl": "{{ product.imageUrl}}",
          },
        ],
        "billingAddress": {
          "city": "{{ billing.city }}",
          "name": "{{ billing.name }}",
          "country": "{{ billing.country }}",
          "emailAddress": "{{ billing.email }}",
        },
      }
    },
    "topic": "order.finalized",
  }
}

When creating a Recent Activity - Purchases or Recent Activity - All Purchases nudge within Nudgify, select the smart webhook you have created as the Data source.

To create a smart webhook for the Sign-ups event on Nudgify, replicate the process for Nudgify Purchases, described above, and create the webhook within your ShopWired account using the type customer.created. Map the data according to the table below:

Nudgify data mapping field	ShopWired webhook data
Email	`event.data.object.email`
Date	`event.createdAt`
First Name	`event.data.object.firstName`
Last Name	`event.data.object.lastName`
Full Name	Skip this field
City	`event.data.object.city`
State	`event.data.object.province`
Country	Skip this field
IP Address	Skip this field

Sample webhook data (many parts have been removed for simplicity) is displayed below:

{
  "event": {
    "data": {
      "object": {
        "city": "{{ customer.city }}",
        "email": "{{ customer.email }}",
        "lastName": "{{ customer.lastName }}",
        "province": "{{ customer.province }}",
        "firstName": "{{ customer.firstName }}",
      }
    },
    "topic": "customer.created",
    "createdAt": "{{ creationDate }}",
  }
}

When creating a Recent Activity - Sign-up or Recent Activity - All Sign-ups nudge within Nudgify, select the smart webhook you have created as the Data source.

Nudge settings

For optimal performance, ShopWired recommends that you configure your Nudge settings:

In the Social Proof section:

Select the Image setting as either Product or Map or Product
Select the Name setting as either First name and initial or First name
Select the Location details setting as City and country

Consult Nudgify's help guide for more help configuring nudge settings.

FOMO - Low Stock

The FOMO - Low Stock nudge displays a nudge on product pages which have less stock than the value you configure for the nudge.

When configuring the nudge within Nudgify:

Select the source as Javascript and select to enable Javascript
Navigate to Website > Themes and select code editor for the theme you have installed the Nudgify script on
Open the master.twig file and locate where you have installed the Nudgify script

Add the following code just after the opening <script> tag for the Nudgify script (before the (function(w){ section):

{% if product.id > 0 %}
    {% set total_stock = product.stock %}
    {% if product.variations|length > 0 %}
        {% set total_stock = 0 %}
        {% for variation in product.variations %}
          {% set total_stock = total_stock + variation.quantity %}
        {% endfor %}
    {% endif %}
    window.nudgify = {
      data: {
        "product": {
          "image": "{{ product.photo_url('small') }}",
          "stock": "{{ total_stock }}",
          "id": "{{ product.sku }}"
        }
      }
    };
{% endif %}

Friction - Free Delivery

The Friction - Free Delivery nudge displays a nudge on pages when the visitor has sufficient items in their basket to qualify for free delivery.