Documentation
How to Start Building a Base of Push Subscriptions
Technical part
- Go to the “Feeds” tab (https://pushtorm.net/Feeds) and click “Add”.
- Fill in all the required fields and click “Save”.
- An additional section with an sw.js file will be available on the right, click “Download”.
- Add the downloaded sw.js file to the root directory of your website.
- Copy the script below and add it to the end of your page before the closing </body> tag.
Congratulations! You have earned the “Programmer” achievement.
Creative part
- Go to the “Creatives” tab (https://pushtorm.net/Creatives) and click “Create”.
- Fill in all the required fields.
- Upload your image and icon.
- Replace the URLs on your push buttons if necessary.
- Click “Save”.
Congratulations! You’ve earned the “Web Designer” achievement.
Creating a Campaign
- Go to the “Campaigns” tab (https://pushtorm.net/Campaigns).
- Configure detailed targeting.
- Set the schedule and intervals for sending notifications.
- Specify how long after the subscription the sending will start and click “Save”.
- Launch your campaign by clicking “Start”.
Congratulations! You’ve earned a major “Pushtorm Partner” achievement :)
Feeds
- Name — is any name for easy navigation through the created Feeds.
- Postback URL — is the URL is used to send information about conversions to tracking solutions.
- Use global postback URL — means to use the general postback that you specified in settings.
- Description — is your comments.
- Request on page load — is a feature that automatically shows a push subscription request right after page loads.
- Redirect URL when clicking “Allow” — is the address to which the user will be redirected to when subscribing.
- Redirect URL (one or several) when clicking “Block” — (aka Push subscription carousel) is the address to which the user will be forwarded to when clicking “Block”. If you specify several addresses (each one is specified with a new line), then when clicking “Block”, the user will be redirected by all the specified URLs, until the list is over.
- URL redirect with parameters — is a feature that helps transfer specified parameters when redirecting.
- Show reCAPTCHA when clicking “Block” — is an option that will show the users a fake captcha, by clicking which they will be redirected to the specified addresses in the list of Redirect URL (one or several) when clicking “Block”.
Feed analytics: 3 visual formats of analytics display are available: charts, graphs, and tables.
Creatives
- Name — is any name for easy navigation through the created Creatives.
- Title — is the title displayed in a push notification.
- Text — is a short description of your offer to the user.
- URL — is the address which the user will be redirected to.
- Icon — is an image that will be used as an icon in your notification.
- Picture — is an image that will take most part of your notification.
- Time to live (TTL) — is the specified number of days after which the push notification will be removed from the queue server, so the user won’t see it.
- Button 1 — is an additional button on your notification.
- Button 2 — is an additional button on your notification.
- URL redirect on buttons is an option that allows setting a URL redirect to a button that is different from the main URL.
- Use main redirect URL — is a feature that helps redirect users by the main URL specified earlier when they click on the additional buttons.
- Tags — help search creatives quickly.
Domain substitution — is a tool that automatically searches for the domain of all the creatives and replaces it with the new address that you specified.
Campaigns
- Name — is any name for easy navigation through the created campaigns.
- Feeds — are the feeds you choose to launch a campaign.
- Creatives — are the creatives that will be used for sending notifications.
- Subscription age — can be used for targeting by subscription novelty.
- Working Hours (UTC) — is a flexible time setting option for sending notifications. Pay attention to the time zone involved, i.e. UTC.
- Post-subscription time — delay before sending the first notification.
- Send every {x} — is a flexible configuration of the interval of sending notifications to users based on the specific time that passed after subscription.
- Minutes to start sending notifications after — means that after the time set in this option, the users will start getting notifications at the intervals you set.
- IDs of subscriptions not to send notifications to — is a block list of user IDs which won't get notifications.
Targeting options: Browsers, OS, OS versions, Languages, Countries, subscription age.
Tracking
Track conversions — is an option that activates additional conversion metrics.
Settings
General postback URL — means that postback will be used in all feeds where you have enabled the “Use general postback URL” option.General subscription ID block list is a list of subscribers to whom notifications will not be sent.
Change password — is a standard procedure of changing the password.
Parameters
{feedId} — ID of the feed from which the user subscribed.
{campaignId} — ID of the campaign the user came from.
{creativeId} — ID of the creative shown.
{subscriptionId} — ID of the subscriber.
{subscriptionAge} — the number of days that have passed since the user subscribed.
{creativeButton} — the button (number) on the notification that the user clicked.
{notificationKey} — the notification tracking key (ID).
Event postback via Binom
Subscription notifications via Binom Event.
If you collect subscriptions in campaigns not created solely to collect subscriptions, information transfer through a subscription will worsen the perception of conversions in that campaign. In that case, it's better to use a Binom event.
To do that, create a Binom event for push subscriptions. Modify our push request script. During the script initialization, add the Callback function which will pass an event saying that push subscription was successful.
This is how it will look like:
onSuccessCallback: function(s){var o = document.createElement("img");
o.src='https://example.com/click.php?event5=1';},
params: {}
};