How to Setup PushPrime on Your Website

Download PDF

Configuring PushPrime is very easy and generally takes less then 5 minutes. This tutorial will guide you through the whole process of configuring PushPrime for your website.

After you signup/login, you will be brought to our dashboard.PushPrime Dashboard

In order to use PushPrime on your website, you will have to first add your website in your dashboard. Adding your website is a very simple process, we collect few pieces of info from your and you are done. Click on the Register Website button in the middle of the screen or the New Website button in the top bar. It will bring up our new website dialog box.

New Website

Website Address: The address where your website is located at, please enter the address without http:// or https://. E.g. abc.com

Subdomain: If users access your website without https, they will have to go through a subdomain on PushPrime to register for notifications. You can choose a subdomain that reflects your business.

Https Access: If your website can be accessed through https, please select yes, otherwise select No, if you are unsure about it, you can click on “I don’t know” and it will automatically check that for you.

Clicking next will open general info dialog.

New Website Info

Icon: Icon is optional, but it is highly recommended that you upload an icon which reflects your business or brand. For best result use Square Images with size at least 192px x 192px.

Title: The name or title of your website.

Google Push API Key: By default PushPrime uses our default parameters for sending notification to Google Chrome, but it is recommended that you add your own. You can get yours for free form Google, please check this tutorial for a step by step guide. (This can also be done later by Going to Settings).

Apple Safari Configuration: Notification in Safari require notifications to be signed by a certificate. For that certificate you need an Apple Developer account which costs $99/year. Paid customers on PushPrime are entitled to receive a certificate free of cost from PushPrime. If you have an Apple developer account, you can follow this tutorial for generating your certificate.

Clicking next will bring you to consent dialog configurator.

new website consent

Consent Dialog: Browsers are very stubborn when it comes to push notifications. Generally to prevent web admins from abusing the service. So they don’t allow us to customise the default permission window that opens. We have observed that opt-in rates significantly increase if you explain to user why you need to send them notification. This is when consent dialog comes into play. Before showing the default permission dialog, a modal dialog will appear in the webpage explaining to them why you need to send them notifications. Following image show how it will look (You can completely customise the colors and text from Styles after the initial setup is done)

consent dialog pushprime

Reminder Button: Reminder button is a small icon which appears in the bottom left or bottom right of your web page. Reminder Button is used to track the permission status of users. If they initially decline the permission request, they can use the Reminder Button to grant permissions. (Reminder Button is also customisable from Styles tab)

Clicking next will bring you to your embed code which you need to add into your webpage. You will have to add this into every page you want to enable PushPrime on (before closing </body> tag). If you are running a WordPress, Joomla or magento (our plugin is currently not in magento marketplace, please contact us to get an upload able copy ) website, you can use our dedicated plugins to add the code automatically.

new website embed code

If your website does not support HTTPS, this is all you need to do and you can stop here (click finish button and you are good to go). But if your website supports HTTPS please read further because it is highly recommended that you configure native opt-in for better subscriptions.

Native Opt-in for HTTPS Websites

If you clicked Yes for the HTTPS option in the first dialog. Instead of the dialog shown in above, you will be seeing the following dialog.

new website embed code native

Click Configure Native Opt-in to open the native op-in configuration.

new website native optin configureIn addition to the embed code you added earlier, you will have to add one additional line of code in head element in your html document (if you are using our plugin for wordpress or magento, go to settings and enable native opt in tags option). After you click on the blue “Click Here” link, it will download a zip, these are our helper files that you need to upload in the root of your web server (generally public_html). After that click on verify button so that our server could verify that those files are publicly accessible. Once the verification is done a finish button will appear. You can click on it to finish the website setup.

If you encounter any issue, please feel free to reach out to us and we will be happy to help.

Leave a Reply

Your email address will not be published. Required fields are marked *