In order for a notification to be sent, a complete campaign, including all three elements below, must be created:
1. Location (where to send a notification) 2. Event / Timing (when to send a notification) 3. Notification / Message (what content to send in the notification)
The images and instructions below outline the steps (nuances) necessary to create your first campaign.
Step 1: Location (where to send a notification)
Create / edit Location key:
Create a name for the location. This name can be used as a dynamic field in the message content later.
Choose the application that will use this location. Note: Locations can also be assigned at the developer level to be available across multiple applications.
If an event has already been created, choose the associated event. If not, skip this step.
Enter the address of the location. This address can be used as a dynamic field in the message content later.
Leave the latitude and longitude blank. The system will automatically fill in this field.
Step 2: Set Event / Timing (when to send a notification)
Create / edit Event key:
Choose the application that will use this event. Note: Events can also be assigned at the developer level to be available across multiple applications.
Create a name for the event. This name can be used as a dynamic field in the message content later.
Set the event (campaign) start and end dates and times. Events can occur once or recur weekly or monthly. The example above shows an event that occurs weekdays from 8 am to 8 pm during the month of January.
Assign one or more locations that are associated with the event. Associations are necessary so that the system knows both when and where to trigger the message.
If a promotion has already been created, choose the associated event. If not, skip this step.
Step 3: Create Notification / Message (what content to send in the notification)
Create / Edit Notification key:
This button must be checked for a notification to be sent. Leave unchecked until you have re-checked your campaign.
Choose the application that will use this notification. Note: You must choose one of your application keys - this is different from the location and event.
Create a name for the promotion.
Set the radius (around a location) that should trigger this promotion. The radius functions as a geo-fence. When the user enters the geo-fenced area around a location, the notification will be sent. To ensure accuracy, the user must be entirely inside the geo-fenced area. A user, in this instance, is represented by the accuracy of their location. In general a users' accuracy will be 650 meters. A minimum radius around a location should be 1 mile in most cases. In cities, this radius can be reduced.
Set the priority for this promotion. This rule is used if there is more than one notification has been triggered for the user.
If you wish to limit the promotion, set a maximum number that can be sent, otherwise, make number 10,000,000.
Enter the subject of the notification. This should be approximately 22 - 30 characters.
Enter the body of the notification.
The body can be as long as you want but, the longer the message, the harder it is to read. You can include <br />, <b>, <i>, <big>, <small>, <p>, <font color="COLOR">, <h1>, <h2> for formatting. Note: Images are not supported in the box.
Dynamic fields can be included in the notification name and subject body. The available fields are: $promo_name, $location_name, $location_description,$location_address (without Address 2), $location_address_full (with Address 2), $event_name, $event_start, $event_finish
For location-triggered messages, you should include either of the following in your message body: <a href="http://maps.google.com/maps?q=$location_address&z=17">CLICK HERE TO VIEW ON MAP</a> <a href="http://m.bing.com/search/search.aspx?A=mapdetails&L=$location_address">CLICK HERE TO VIEW ON MAP</a>
Select the action type. Selecting "Launch App" will open the application when the user clicks the 'Click to Open Application' button on the notification. Selecting "Open URL" will open the web URL that you provide when the user clicks on the 'Click More Info'. Selecting "Advanced" allows you to customize both the name and the action of the click - you can launch the app, open a URL, dial the phone, etc.
Select the events to associated with this notification. If no event had been created, this association can be made later.
Advanced Notification Set:
The "Advanced" tab allows you to override the Launch App or Open URL types. You use the Advanced tab to customize link names, create custom intents and to turn elements of the notification on or off.
A. Select "Advanced".
B. Enter the URL. This is the same URL entered under the "Open URL" tab.
C. Use this field to override the link label shown in the notification.
D. The SDK provides the option to show the Notifications screen upon click in the notification tray, or, if this is set to off, the click will trigger the action type.
E. When enabled, this option presents a "thumbs up / down" for your users to be able to vote. This data is captured and presented in the reports tab.
F. If you are customizing the intent, enter here.
G. Enter the Action Category here.
H. Enter any necessary Action Data
Additional Notes:
A notification campaign must include at least one location, one event and one notification content.
Review each of the three components, ensure that you have associated the locations, events and notifications. Also be certain that you have added the name of the application as the "category".
