Segmentation
You can define your audience based on tags, named users, tag groups, and attributes.
Addressing Devices
To help target specific devices or users for a notification, we have Tags, Named Users, Tag Groups, and Attributes.
Tags
Tags are an easy way to group channels. Many tags can be applied to one or more devices. Then, a message sent to a tag will be sent out to all devices that are associated with that tag.
// Set tags
UA.then(sdk => {
sdk.getChannel().then(channel => {
// Add a tag
channel.tags.add(tag, group) // Returns true if successful
// Remove a tag
channel.tags.remove([tag1, tag2, ...], group) // Returns True if successful
// Set tags
channel.tags.set(tags, group) // Returns true if successful
// Resets all tags for the given tag group.
// `group` is optional in all tag functions and defaults to `device` if not specified
})
})Named Users
Named Users allow you to associate multiple devices to a single user or profile that may be associated with more than one device, e.g., an end-user’s Chrome browser on their laptop and their iPhone. A device can have only one Named User, and a single Named User should not be associated with more than 50 devices. Named Users provide the ability to directly set tags on them (see Tag Groups).
Associating the channel with a Named User ID, will implicitly disassociate the channel from the previously associated Named User ID, if it existed.
By default, Named Users can only be associated server-side. A 403 Forbidden response is returned if Named User association is attempted when client-side association is disabled. In order to associate a Named User through the project, you must change the project’s Named User security setting to allow Named Users to be set from devices. Client-Side Named User Association.
UA.then(sdk => {
sdk.getChannel().then(channel => {
// Return the current Named User
channel.namedUser.id // Returns null or string
// Set the Named User to a String
channel.namedUser.set(name) // associates this channel with a named user
// Remove the currently associated Named User
channel.namedUser.remove() // Disassociates the channel from the named user
// Returns true if successful
})
})Tag Groups
A tag group is an array of tags that you can associate with both channels and named users. In addition to the Airship default tag groups, you can create custom tag groups in the dashboard. See the Tag Groups documentation for more details, including security information.
UA.then(sdk => {
sdk.getChannel().then(channel => {
// Add channel tag to a group
channel.tags.add('tag-name', 'group-name')
// Remove channel tag from a group
channel.tags.remove('tag-name', 'group-name')
// Set channel tags on a group
channel.tags.set(['silver-member', 'gold-member'], 'loyalty')
// Resets all channel tags for the given tag group.
// Check for a specific tag on a channel
channel.namedUser.tags.has('bronze-member', 'loyalty')
})
})UA.then(sdk => {
sdk.getChannel().then(channel => {
// Add named user tag to a group
channel.namedUser.tags.add('tag-name', 'group-name')
// Remove named user tag from a group
channel.namedUser.tags.remove('tag-name', 'group-name')
// Set named user tags on a group
channel.namedUser.tags.set(['silver-member', 'gold-member'], 'loyalty')
// Resets all named user tags for the given tag group.
// List named user tags
channel.namedUser.tags.list
// Check for a specific tag on a named user
channel.namedUser.tags.has('bronze-member', 'loyalty')
})
})Attributes
Attributes are metadata used for audience segmentation and personalization. They extend the concept of Tags by adding comparison operators and values to determine whether or not to target a user, helping you better evaluate your audience.UA.then(sdk => {
sdk.getChannel().then(channel => {
channel.attributes.set({firstName: "John", lastName: "Doe"})
.then(result => console.log("Firstname and lastname set!"))
.catch(err => console.error("An error occured while setting attributes: %s", err))
})
})Categories