ProveSource JS API

In this guide, we'll provide javascript code examples for different use cases, for example:

• Show notifications only after a user scrolls some part of your page
• Stop showing notifications after a checkout popup shows up
  or until cookie or GDPR consent is given
• Show stream notifications only related to a specific product
• Dynamically replace the notification text using templates / placeholders

Then you need the ProveSource javascript API.

Display

provesrc.display()

Trigger a specific notification display (we recommend changing the notification's Display settings in the dashboard to something arbitrary like "nowhere.com"):

provesrc.display('notification name');

Trigger a notification display for a specific product:

provesrc.display('notification name', 'productId');

This will only work with platform notifications (shopify, woocommerce, wix, etc) or with webhooks notifications where you send a guid parameter (string/number) that represents the product ID, or whatever.

Trigger a notification with dynamic variables (parameters are just an example, you can use any key names):

provesrc.display('notification name', flightNumber, { 
  destination: 'New York',
  from: 'Tel Aviv'
});

The notification message would need to have template string similar to this:

Booked a flight from {{from}} to {{destination}}

You can also use the image reserved key to change the notification image dynamically:

provesrc.display('notification name', null, { image: 'https://...' });

Stop/Resume

To make ProveSource stop showing notifications:

provesrc.stop()

This will make ProveSource clear the notification queue and stop showing notifications

If you later want to restart the ProveSource notification queue use:

provesrc.resume()

Example - Product Specific Purchases

1. Create a Counter notification that tracks Conversions with webhooks.
2. In the Message step of the notification write something like "bought {{product}}", product is a template and will be replaced in realtime.
3. Send webhooks to the notification's webhook address with guid parameter which is actually the productId, this can be a numeric ID, SKU or anything else (as long as you have the identifier in the website).
4. Add a piece of code to your product pages that looks like this:

provesrc.display('notification name', 'productId', { 
  product: 'product name',
});