Contact Management

You can use the contact management tool to view details about specific contacts and remove channels and contacts from your Airship records.

If on an AXP plan, you can also create named usersA customer-provided identifier used for mapping multiple devices and channels to a specific individual. and add/remove channelsA device or address registered with Airship to receive messages, such as a mobile app, web browser, email address, or SMS number. It stores opt-in status, device-specific information, and metadata used for targeting. Each channel has a unique channel ID. to/from a named user.

For SDK methods for managing named users, see Contacts in our developer documentation.

Contact lookup

You can look up a contact using these identifiers:

• ChannelA device or address registered with Airship to receive messages, such as a mobile app, web browser, email address, or SMS number. It stores opt-in status, device-specific information, and metadata used for targeting. Each channel has a unique channel ID. ID
• Named userA customer-provided identifier used for mapping multiple devices and channels to a specific individual. ID — Case-sensitive
• Device tokenThe identifier that Apple Push Notification service (APNs) assigns to an iOS app instance on a specific device. Airship maps each device token to a channel ID, which you use to address the device. If the device token changes, Airship updates the mapping automatically.
• Email address
• Phone number — Can include a combination of spaces, dashes, and braces around the area code, for example: 18001234567, 1 800 123 4567, and 1 (800) 123-4567

Looking up a contact

To look up a contact:

1. Go to Audience, then Contact Management.
2. Enter an identifier and select Look up. Lookup results list for each identifier and associated named user, if any:
   • Creation date and time
   • Last registration or modified date and time
   • Associated channel types
3. For more information about a channel or named user, select the right arrow icon (). See the next two sections for descriptions of those views.

   

Viewing channel details

1. Look up a contact.
2. For a returned channel, select the right arrow icon (). Data displayed for each channel:
   • Identifier
   • ChannelA device or address registered with Airship to receive messages, such as a mobile app, web browser, email address, or SMS number. It stores opt-in status, device-specific information, and metadata used for targeting. Each channel has a unique channel ID. ID
   • Creation and last registration dates and times
   • Installation status
   • Opt-in status
     • App, Web, and Open channels display Opted-In or Opted-Out. Background Enabled or Background Disabled appears for App channel background push.
     • SMS channels have a check box, which is checked if opted in. You can check/uncheck the box to change the status.
     • Email channels have Commercial and Transactional check boxes, which are checked if opted in. You can check/uncheck the boxes to change the status. If an email channel is suppressed, you will see a button for removing suppression. See Removing email suppression.
   • Tracking status — Email channels have Open tracking and Click tracking check boxes, which are checked if opted-in. You can check/uncheck the boxes to change the status.
   • In a holdout group — This label appears if the channel is currently excluded from messaging as part of an active Holdout ExperimentMeasures the effects of excluding a group of audience members from all messages or messages with specific campaign categories. You can compare the performance of the two audience groups in reports for selected goal events..

     

3. Select the down arrow icon () for information associated with the channel. Data displayed per tabbed section:

   Section	Description
   Channel detail	Channel ID, push address, and aliases, if any. Email channels also display commercial and transactional opt-in/out dates, if any.
   Channel tags	TagsMetadata that you can associate with a channel or named user for audience segmentation. Generally, a tag is a descriptive term indicating a user preference or other categorization, such as wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive.
   Tag groups	Tag groupsAn array of tags that you can associate with both channels and named users. and the tags within the groups
   Attributes	AttributeMetadata used for audience segmentation and personalization. Attributes 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. IDs, types, and values. For JSON attributes, the ID is formatted as <attribute_ID#instance_ID>. See JSON attributes in About attributes.
   Device properties	Device propertyInformation about a channel, such as language and time zone settings, OS and browser versions, and notification opt-in status. Values come from the user’s device when an SDK is present, or are set via the API for channels without one. Each property is automatically made available as an attribute, a tag, or both for audience segmentation. tag groups and the tags within the groups
   Subscription lists	Subscription ListAn audience list of users who are opted in to messaging about a specific topic. Users can manage their opt-in status per list using a Preference Center. IDs
   Holdout group history	The Holdout ExperimentMeasures the effects of excluding a group of audience members from all messages or messages with specific campaign categories. You can compare the performance of the two audience groups in reports for selected goal events. name and start and end times when the user was excluded from messaging

Viewing named user details

To view information about a named user:

1. Look up a contact.

2. For a returned named user, select the right arrow icon (). Data displayed per tabbed section:

   Section	Description
   Channels	Each channel is listed separately. The appearance and functionality is identical to the detail view for a channel.
   User Tag Groups	Tag groupsAn array of tags that you can associate with both channels and named users. and the tags within a group.
   Attributes	AttributeMetadata used for audience segmentation and personalization. Attributes 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. IDs, types, and values. For JSON attributes, the ID is formatted as <attribute_ID#instance_ID>. See JSON attributes in About attributes.
   Message History	A list of messages sent to the user within the last 30 days.

   

Creating a named user

If a channel is not yet associated with a named user, you can manually create one:

1. Look up a contact.
2. For a returned channel, select the right arrow icon ().
3. Select Create Named User.
4. Enter the user name.
5. Select Submit.

The channel and any channels associated with it will be associated with the named user.

Associating channels with a named user

To add a channel:

1. Look up a contact.
2. For a returned named user, select the right arrow icon ().
3. Select Add/edit channels.
4. Enter a contact identifier and select Look up.
5. Select Add channel for an individual channel.
   • If the channel you want to add is already associated with a named user, both the individual channel and its currently associated named user will be listed in the results.
   • If you searched for a named user, or if a named user was returned when searching for a different identifier, select View channels to see its associated channels. Select Add channel to disassociate the channel from its current named user and associate it with the named user you are editing.

To disassociate a channel from a named user:

1. Look up a contact.
2. For a returned named user, select the right arrow icon ().
3. Select Add/edit channels.
4. Select Remove for a channel.

Deleting a channel

To remove a channel from your Airship records:

1. Look up a contact.
2. For a returned channel, select the right arrow icon (). Make sure to select a channel, not a named user. The option to delete a channel is not available when viewing details for a channel within a named user record.
3. Select Delete this channel.

Deleting a contact

To remove a contact and its associated channels from your Airship records:

1. Look up a contact.
2. Select the right arrow icon () for a channel or named user.
3. Select Delete this contact.

Removing email suppression

To remove the suppression state for an email channel:

1. Look up a contact.
2. For a returned email channel, select the right arrow icon ().
3. Select the information icon () next to the Opt-in Status check box to view the complaint reason.
4. Select Remove suppression. The button is only present if the channel is suppressed.

The Real-Time Data StreamingA service that delivers user-level events in real time to your backend or third-party systems using the Data Streaming API. Email registration event for this action includes the username of the user who removed suppression.

After removing suppression, you must also opt the channel back in to messaging before they can receive email from you again.