This article describes how to segment your messages by region. Region segmentation is not available in all packages. If you would like to know more about how to enable it for your app, please contact your Customer Success Manager.
Before you configure Regions:
Ensure that your employees have downloaded the app and have allowed access to Location permissions. If they have said "No," ask them to edit this setting (described in detail below). Make sure that your users have opened the app at least once before. One way of going about this would be to send a non-region push notification to prompt users to open the app.
The first step to being able to segment your messages by region is to configure a region. This is done in the Regions section within Messages (Mobile App Studio > Send a Message > Regions). To get there, click "Send a message" in the main navigation of the Mobile App Studio, then click "Regions" in the left hand navigation.
Today there is one type of region that can be added - Geofence.
Creating a region works like creating content within the Mobile App Studio. Simply drag the region type you want to add to the list. Once you've done this, you'll see four fields.
Region Name - This is a label you can define so that you can distinguish between your regions.
Latitude and Longitude - These are the parameters that determine where the center of your geofence will be. Read more about Latitude and Longitude. For help finding the Latitude and Longitude of the area you are configuring read the section below.
Radius - The radius determines how large the geo fence will be. It is measured in miles and has a lower limit of .1 miles and an upper limit of 1,000 miles.
How Region monitoring works:
You'll likely notice the above message when you first create regions. It is critical to understand how region monitoring works on your users' devices in order to get the most value out of the feature.
When you add a region in the Mobile App Studio a few important things must happen before you'll be able to reach people who are inside (or out) of that region.
The app needs to be aware of the region. This happens automatically, but ONLY after the user opens the app. When you create a region, your user's device is not aware of that region until the app has been opened. Once it is opened, it starts "monitoring" for that region. We don't track or record the location of the user at all times, but only when they enter or exit a "region".
The reason this is important is because there is a natural delay between when you create a region and when there is a meaningful percentage of your audience that has reported their status regarding the region (whether they are inside or outside of the region). Without that status, we cannot target them with a message.
Regions are designed to be used with fairly static physical locations. If you intend to target a region very soon after creating it, you will likely not reach the audience you intend. However, if your app is launched with regions active and setup, then everyone who downloads and opens your app will be eligible for targeting for all regions.
If you have any questions about this, please reach out to email@example.com or your Customer Success Manager.
Finding Latitude and Longitude:
There are a number of free tools on the web that can help with finding latitude and longitude and visualizing the radius around that point.
Latitude and Longitude
The best we've found for getting Latitude and Longitude is Google Maps. You can simply search for the location you want to use or drag the map to where you want it and the Latitude and Longitude will always be in the URL at the top of your browser (see the bolded section below)- https://www.google.com/maps/place/Bluebridgefirstname.lastname@example.org,-86.013601,17z
There are a number of tools to help you visualize what the radius around your point will include. The best we've found is at this link - http://obeattie.github.io/gmaps-radius/
This is not a Bluebridge supported tool but it is a quick way for you to visually understand the radius around the point you select and play with different radius sizes.
Adding a Region as a Message Segment
Once you've configured a region, you can now start targeting your messages by region.
Create a Message
The first step is to create a new message. If you've never created a message before, read this guide that explains the basics of message creation and sending
Add a region using the draggable
Region segmentation is added in the "Who" section of message creation. If you have Message Category Segmentation enabled for your app, you'll be very familiar with the experience. Region Segmentation is a draggable that appears in the who section when creating a message. To add a region to a message, simply drag the region to the center of the page and drop it.
After you've added the region draggable, there are two options available. The first is the region selection. Click the drop down and pick the region you want to target this message to. The second is a dropdown to decide if you want to target users inside of the region or outside of the region.
If you are launching this feature at an event, be sure that you have sent the non-region notification at least an hour beforehand. This gives a phone enough time to refresh its location in the background since it has to go through several technology providers. Compose and send your region-tagged push. All of your employees within that region should receive it if all prior steps were done correctly.
If an employee says "I didn't get the push," you should...
1. Ask them to open Apple Maps or Google Maps. Do you see a blue dot on the map where you are? If not, the person hasn't enabled Location on their phone. To change this on iOS go to Settings > Privacy > Location. Find the name of your app, move the toggle to "Allow Always."
2. Ask if the phone has been on Airplane mode or in an area with spotty connectivity. If possible, improve connectivity.
3. Check if the region was correctly defined in the MAS. Was the user really in the target group when it was sent?
Things to remember:
- Region segmentation is not available in all packages. If you would like to know more about how to enable it for your app, please contact your Customer Success Manager.
- Creating a region works like creating content within the Mobile App Studio. Simply drag the region type you want to add to the list and edit the region name, latitude and longitude, and radius.
- Need help sending messages? Check out our articles on how to send a message and message actions.
- At the end of the day, remember that the Geo feature is a "best effort" technology dependent on a chain of other vendors: Amazon to Apple/Google OS to AT&T/Verizon.