Last modified September 3, 2018 by Shelly Wolfe

About geoplaces

Swrve geo-triggered campaigns use geoplaces to trigger customized, location-specific campaigns with full control over when you send notifications.
Swrve geo-triggered campaigns are currently only available as part of our Early Access program. If you would like to have these features enabled for your app, contact your Customer Success Manager at success@swrve.com.

What is a geoplace?

Geoplaces are a single geofence or collection of geofences that are used to trigger a notification to app users. A geofence is a virtual perimeter for a real-world area. Swrve geoplaces are currently mapped 1:1 with a geofence, but might include multiple geofences in the future.

geoplace and notification

To view and manage your geoplaces, on the Manage menu, select Geoplaces.


Geoplace properties

Use the Geoplace Settings screen to add up to 12 custom properties to your geoplace setup that you can later use to include the property values in your notification content. For example, you might want to include custom properties such as a location name or deeplink.

To add custom properties for your geoplaces:

Step 1: On the Geoplaces screen, select Settings.

Step 2: Under the Custom Properties section, in the Property box, enter the property name and then select Add. The property name must consist of lower case letters, dashes and underscores only (no spaces) and cannot be longer than 32 characters.

After you add a property, it appears in the list below with the option to remove properties if no longer needed.

geoplace properties

Step 3: After you have added all your custom properties, select Save.

You are returned to the Geoplaces screen and when you create a new geoplace, the properties are available under the Custom Properties section.


Creating a geoplace

The first step to creating a geo-triggered campaign is to create your geoplaces. Use circular perimeters to cover a broad area or use a polygonal shape to more precisely define the boundary of your target area.

To create a geoplace:

Step 1: On the Geoplaces screen, select + Create Geoplace:

Manage_Geoplaces screen

Step 2: Give your geoplace a name—it’s good practice to use a standard naming convention with square brackets to separate keywords to make it easier for you to find your geoplaces later. For example:

  • Restaurant Name [city] [community] [location]
  • Airport Name [IATA code] [city] [country]

Step 3:  A Google map displays. If you give the browser permission to do so, the map defaults to your current location. Use the Search function to find the area you want to create your geoplace in. You can view the area in Map or Satellite view and further refine the view by selecting Terrain under the Map view or Labels under the Satellite view.

Step 4: Select the type of shape you want to use to create your geoplace—circle or polygon.

  • Circle – This uses a set of geographic coordinates as the center of the circle and a radius, in meters, to define a circular geofence around it. On the map, select the epicenter of the geoplace you want to target and a blue circle displays.
    circular geofence
    To change the size (in meters), enter a new value in the Radius box or select and move one of the points on the circumference to enlarge or reduce the area.
    geofence latitude longitude and radius
    To move the circular geofence, select and move the center point to another location or manually enter new coordinates in the Latitude and Longitude boxes.
  • Polygon – To create a polygonal geofence, select the Polygon type, and then select the target area on the map. A blue triangle with a number of points displays. Move each point or vertex to create the shape of your desired geofence.
    polygon geofence

Step 5: If your geoplaces include custom properties, they are displayed under the Custom Properties section. Enter values for each property as required.

Step 6: When you have set up a geoplace and added your custom properties, select Save.

Your geoplace is created and included in the listing on the Geoplaces screen. To edit a geoplace, select the geoplace you want to edit from the list, make your changes and select Save.


Managing geoplaces

Use the search or edit functions on the Geoplaces screen to manage your geoplaces. For example:

  • Set up to 12 custom properties on the Geoplace Settings screen.
  • Create a new geoplace by selecting + Create Geoplace.
  • View your geoplaces in list or map view by selecting the View as List or View on Map.
  • Search for a specific geoplace or set of geoplaces using the search box and Sort By options available.
  • Edit an existing geoplace by selecting the geoplace name and then moving the vertices of the polygon or circumference points of the circle to resize or reshape the area, as appropriate.
  • Delete a geoplace by selecting Delete  in the geoplace row.

Next steps