Automatically send messages based on Gimbal location data.

Gimbal sends their location data to Airship via our Gimbal Adapters. An Airship Gimbal Adapter is a drop-in class for iOS, Android, and Amazon that integrates Gimbal Places events with Airship. The Gimbal data can then be used with the Location and Location Attributes triggers with AutomationA set of conditions that your audience must meet before they receive a message. and JourneysA series of messages that is initiated by a trigger. Airship sends messages in the series based on your timing settings, and you can also set conditions that determine its continuation. Journeys can be connected to other journeys and to in-app experiences to create continuous user experiences. .

Gimbal integration requirements


  1. SDK version 6.0 or later: Download the latest stable SDK from appropriate Platform page.
  2. Account Entitlement: Account-level permissions apply, based on your pricing package. Contact Airship Sales with any questions related to pricing and entitlements for location and automation services.


  1. Gimbal Account: Register on
  2. Gimbal SDK-enabled app: See Gimbal’s iOS and Android Developer Guides.
    • Minimum iOS requirement: v2.8.1 as of Feb 25, 2015.
    • Minimum Android requirement: v2.8.1 as of Feb 25, 2015.

Contact your Gimbal Account Manager with any questions.

Adding Gimbal Adapters

Follow the installation instructions:

Configuring Gimbal integration

Gimbal is the system of record for their location data, and all updates to places data are managed by Gimbal. In these steps you will enter your Gimbal Server API Key into your Airship settings, then import your locations.

  1. Go to

  2. Copy the Server API Key for the Organization you want to use with Airship.

  3. In Airship, go to Settings » Project Configuration and click Manage for Partner Integrations.

  4. Paste your Gimbal Server API Key in the provided field, then click Save.

  5. Click Sync Now. This imports your Gimbal Places as Airship locations so they can be used as location triggers.


    After the initial import is complete, your locations will automatically sync every 7 days. The date, time, and time zone of the latest import is listed in the Gimbal section in Settings » Project Configuration » Partner Integrations. You can also manually sync your locations at any time by clicking Sync Now.

Now you can use Gimbal data with the Location and Location Attributes triggers.

Using the triggers

You configure a trigger in the Setup step in the Automation composer.

There are two places you can configure a trigger for a journey:

  1. In the Trigger step in the Journey composer.
  2. From the Journey MapA visualization of journeys and in-app experiences that can be connected to create a continuous user experience. You can also create and edit from the map. . First click a trigger card, then click Configure to open the list of triggers. Click Save after completing trigger configuration, and the trigger configuration drawer will close.

Location trigger

The Location trigger initiates an automation or journey based on an audience member’s device location. You can select a maximum of 20 locations per automation or journey.

Configuration steps:

  1. Select the Location trigger.

  2. Click Select a Location.

  3. Enter a search term. Results, if any, display on the map and are listed on the Results tab. There are two types of locations available for selection: geofences and beacons.

    Click a result for a detailed view of a location. If selecting a geofence, the map will zoom to the selected location. Click and drag, and use the **+/-** zoom controls to change the displayed area.
  4. On the Results tab, check the box next to the locations you want to use as the trigger.

  5. Review the Selections tab, then click Save and continue.

  6. (Optional) Click Select a Location to add more locations.

  7. Choose whether to trigger your automation or journey when the user enters or exits a location.

Location Attributes trigger

The Location Attributes trigger initiates an automation or journey based on key/value pair metadata associated with a particular location. You can add a maximum of 50 location attributes per automation or journey.

Configuration steps:

  1. Select the Location Attributes trigger.

  2. Enter a key/value pair for the location you want to use as the message trigger.

  3. (Optional) Click   to add an alternative location attribute.

  4. (Optional) Click Add Another to add more location attributes.

  5. Select ALL/ANY to determine how to evaluate multiple location attributes and alternatives within each location attribute.

    • ALL = all criteria must be met (boolean AND)
    • ANY = any criteria must be met (boolean OR)

    By default, the automation or journey is triggered if the audience meets ALL the location attributes. For example, if you selected ALL, with attributes half_off and has_cafe, you’d only reach users who enter or exit locations that meet both conditions. If you select ANY, you’d reach all users who enter a location running a half-off campaign as well as all users who enter a location that has a cafe.

  6. Choose whether to trigger your automation or journey when the user enters or exits a location.

Managing Gimbal integration

If you have already configured Gimbal, you have two options in Settings » Project Configuration » Partner Integrations » Gimbal:

  • Sync location data: Click Sync Now.
  • Delete your current Gimbal Server API key: Click Remove, then confirm.

Gimbal key terms

A location is a logical place defined by a set of beacons and/or geofences. Locations are the logical entities that are signalled by devices and may be used to trigger automations and journeys.
Attributes are key/value pair metadata associated with a particular location, e.g., chain:BobsBurgers, has_blender:yes. Attributes must be defined and assigned to a particular location in the Gimbal system and synced with an Airship account.
A beacon represents a physical device used for proximity detection. Beacons may represent hardware implementing the iBeacon standard for use with iOS, or proprietary beacons (such as Gimbal beacons) for use with Android. Beacons may or may not have geolocation data associated with them.
A geofence represents a fixed location representable by one or more points in the WGS coordinate system. Geofences can consist of a single point and a radius expressed in meters, defining a circular region, or a series of points defining a polygon.
The Gimbal system refers to your app’s locations as Places. A Place is either a single geofence, one or more beacons, or one or more beacons and a geofence.