22 July 2013
Additional required other products
Original publication date: 12/14/2012
Modified: 07/22/2013 (Change log)
|Required products||Sample files
By downloading software from the Adobe Web site you agree to the terms of our license agreement. Please read it before downloading.
(File last updated on 08/05/2013)
Urban Airship provides services for sending Push Notifications to a variety of devices including Apple, Blackberry, Android and Windows. This article describes how to leverage Urban Airship’s resources to send DPS alert notifications and trigger Newsstand downloads to iOS devices.
Visit the Urban Airship site to see more information about Urban Airship's offerings and to sign up for their service.
The connector distributed with this article captures device registrations from your DPS Application and then registers each device with Urban Airship. Alert Notifications can be sent with either Urban Airship’s dashboard OR with the form provided with this distribution. Regardless of which dashboard is used, the Alert Notification is sent immediately to all devices.
For Newsstand Notifications, you must use the provided form. Upon initiation of the notification, the distribution will fetch a block of devices from UA’s database and queue them for notification. This is done repeatedly until all the registered devices have been sent for delivery. In order to provide adequate service to these devices, this connector will not broadcast all registered devices immediately. Rather, groups of devices are sent periodically (every minute) until all the device notifications have been sent.
Note: Upon receipt of a Newsstand notification, a DPS application will immediately contact Adobe’s fulfillment services to begin the download of content (assuming that the device is on Wi-Fi). Since these notifications are quite small, they can be broadcast to a significant number of devices nearly instantaneously. In order to provide adequate service to these devices, this connector will not broadcast all registered devices immediately. Rather, groups of devices are sent periodically (every minute) until all the device notifications have been sent.
Whenever a DPS application is activated (comes to the foreground), it attempts to register it’s device token. Doing this frequently ensures that Apple’s Push Notification Service (APNS) keeps the token fresh and active.
The distribution included within this article will capture device registrations from the DPS application and then register the device at Urban Airship. Along with the device registration, a ‘tag’ is associated with the device type. Current tags are “ipad”, “ipad3”, and “iphone”. Using the push console at Urban Airship OR modifying ‘index.php’, the publisher can choose to send targeted push messages (either Alert or Newsstand) to the specified ‘tag’. For instance, you could message only iPhone devices or provide different messages to iPad3 and iPad2 devices.
This distribution supports 2 types of push notification – Alerts (text) and Newsstand (background). These are mutually exclusive, but can be sequenced. Apple’s Push Notification System (APNS) will only deliver the most recent notification payload – cancelling any previous notifications. The distribution will not allow you to send a new notification until the current (Newsstand) completes.
Alert Notifications are broadcast immediately to Apples delivery network.
Newsstand notifications are sent in the following manner:
Upon receipt of a Newsstand notification, a DPS application will immediately contact Adobe’s fulfillment services to begin the download of content (assuming that the device is on Wi-Fi). Since the notification payload is quite small, many can be broadcast to a significant number of devices nearly instantaneously. Indeed, this is a feature of using Urban Airship’s broadcast API. However, this can generate a number of simultaneous requests for folio downloads that exceeds Adobe’s infrastructure’s ability to accommodate. When this happens, devices will timeout and no background download will happen.
Therefore, the device notifications are sent to Urban Airship in blocks (~1500/minute).
Please contact your Adobe DPS Enterprise representative before modifying these values.
While there are no such performance implications with sending solely an Alert notification, these are also sent in the same manner for consistency. If you require immediate, broadcast delivery, you can do so via the Urban Airship push console or by making modifications to the distribution.
Installation is easy…
Testing Newsstand downloads with Urban Airship is super easy.
See the following information on push notifications from Apple:
Updated connector to make the interface with Urban Airship more robust and more scaleable for publications with large numbers of subscribers. Also made the installation process easier.