Airship Web Notifications

This module connects your Drupal site to Airship’s web notification delivery service so that you can selectively deliver on-demand notifications to your site visitors as you publish your content.

Marketing and digital experience teams at thousands of the world’s most admired companies rely on Airship’s Customer Engagement Platform to create deeper connections with customers by delivering incredibly relevant, orchestrated messages on any channel.

Founded in 2009 as a pioneer in push notifications, Airship now gives brands the user-level data, engagement channels, AI orchestration and services they need to deliver push notifications, emails, SMS, in-app messages, mobile wallet cards and more to exactly the right person in exactly the right moment — building trust, boosting engagement, driving action and growing value.

Features

• Support for Chrome, Firefox, and Opera browsers on desktop and Android mobile web. Support for Safari on desktop.
• Customizable opt-in prompt allowing you to choose how and when to prompt users to opt-in to notifications.
• A "Send web notification" checkbox on the content page
• Option to customize the notification title, icon, notification text, and action URL for each notification
• The ability to automatically send a web notification when publishing or updating any piece of content
• Option to enable notifications for each content type and set default notification text, such as post title
• Support for Drupal 7 & 8

Requirements

To use this plugin, you’ll need to set up an account with Airship. You can sign up for a free starter plan with unlimited web notifications and up to 1,000 addressable users.

For more information on Airship’s Web Notification solution, please visit the following links:

• Web Notifications Explained
• Technical documentation
• Pricing Plans
• Message Reporting
• Opted-In User Reporting

How to use

1. Install module and visit the configuration page at admin/config/services/urban-airship-web-push-notifications.
2. In the Credentials tab, set the App Key and the App Master Secret form items. Credentials can be found in your Airship dashboard.
3. In the SDK Bundle tab, upload the SDK zip file from your Airship account. For more information about the contents of the SDK bundle, please see the Airship documentation.
4. In the Opt-in Prompt tab, configure the behavior and appearance of your opt-in prompt. For additional details on creating or using a custom opt-in, please see the Airship documentation.
5. Enable notifications on the desired content types by visiting that content types edit page. Select the Airship Web Notifications tab and check the Enable notifications checkbox. You may also set the default notification text to be used by all nodes of that content type.
6. Once web notifications are enabled for a specific content type, add a new node or edit an existing node.
7. Select the Airship Web Notifications tab. From here, you can set the notification title, icon, text and action URL for the notification you wish to send. If the title, icon, or action URL fields are left blank, the defaults from your configuration file will be used for these fields. Check the Send web notification on save box to instantly send a web push notification upon saving your node.

Important

Mixed HTTPS sites will need to ensure that both of these paths are available on the secure site:

• /push-worker.js
• /web-push-secure-bridge.html

Make sure to clear Drupal cache after you switch Prompt for Notifications mode in order to see the changes.

In addition, these sites will need to have a registration page that is served over HTTPS for users to opt in to notifications. For more information, see the Airship documentation on secure integration.

See README.md file in the module for more details.