What are location attributes?

Location attributes are key-value pairs, such as City: Boston, that describe characteristics of sites and zones. Location attributes get mapped to location Universal Behavior event attributes in Watson™ Campaign Automation (WCA) where they are used by marketers to build mobile app message queries and programs that target mobile users at locations with similar characters, such as sites in the same city.

Location attributes are configured in Device Location Awareness (DLA) when the location administrator defines locations.

For example, a marketer can build a program that targets mobile device users in a specific city by specifying the locationCity event attribute as criteria for the Location - Entered a Geofence Universal Behavior event. To target mobile device users at sites in Boston, the marketer adds the locationCity is equal to Boston Universal Behavior event to the program. The location attribute and value that correspond to locationCity are defined in DLA when the location administrator sets up sites and specifies Boston as a site's city.

DLA provides a set of default location attributes that are based on site and zone definitions in the DLA UI and the IBM® Mobile App Messaging SDK. The following table shows the default location attributes and the corresponding location Universal Behavior event attributes.

To expand or narrow the focus of a query or program, marketers can specify various combinations of location attributes.

Location administrators can create custom location attributes for characteristics that are not provided by the default attributes.

Table 1. Default location attributes and corresponding location Universal Behavior event attributes
Default Location Attribute in sites and zones Location Universal Behavior Event Attribute in queries and programs
Site name or Zone name siteId
City locationCity
State/Prefecture/Province locationState
Postal code postalCode
Country locationCountry
Region locationRegion
Radius (on the SDK) locationRadius
  locationAttributeIds
(custom attributes that you create).
appKey (on the SDK) appKey
channelId (on the SDK) channelId