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.
| 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 |