Contacts for the Android SDK

Identify contacts, reset contacts, and get named user IDs.

A Contact is any user in your project. Contacts are identified as either an Anonymous Contact or a Named User. Airship can set targeting data on these identifiers, which are also used to map devices and channels to a specific user. For detailed information about contacts and named users, see Named users.

Managing the Contact’s identifier (Named User ID)

You can call identify multiple times with the same Named User ID. The SDK automatically deduplicates identify calls made with the same Named User ID. If you change the ID from a previous value, the SDK automatically dissociates the Contact from the previous Named User ID.

Identifying the contact

Airship.contact.identify("some named user ID")
Airship.getContact().identify("some named user ID");

If the user logs out of the device, you may want to reset the contact. Resetting clears any anonymous data and dissociates the contact from the Named User ID, if set. Call this method only when the user manually logs out of the app. Otherwise, you cannot target the Channel by its Contact data.

Resetting the contact

Airship.contact.reset()
Airship.getContact().reset();

You can retrieve the Named User ID only if you set it through the SDK.

Getting the Named User ID

Airship.contact.namedUserId
Airship.getContact().getNamedUserId();