Previous Version of Contacts

Contacts stores information on subscribers for use in your MobilePush activities. MobilePush gathers information about Contacts via opt-in confirmation and other information submitted via mobile applications. You can’t manually add Contacts or subscriptions to MobilePush.

You can use Contacts to manage the following standard information fields about your subscribers:

• First Name
• Last Name
• City
• State
• ZIP Code
• Time Zone
• UTC Offset (the number of hours from which the user's time zone deviates from UTC)
• Observe DST (whether the user's time zone observers Daylight Savings Time or not)
• Platform
• System Token
• Device ID
• Status
  • Indicates that Contact information can be used as part of a send
    • Active
    • Disabled

A Contact displays an Active status after opting in to receive notifications via MobilePush. That status changes to Disabled when you manually unsubscribe a Contact or when that Contact opts out from further push notifications. Once a Contact status changes to Disabled, the Contact must opt back in to receiving push notifications via the app.

You can also add attributes for your Contacts to include custom information you require to send messages.

Each category of information includes its own entries for preferred name, address, and other information about the subscriber. This information can be used within that category but doesn’t necessarily apply to the subscriber when using other categories. For example, a subscriber might want to have their mobile number associated with certain subscriptions and not others. The Contacts feature allows the subscriber to specify how and where they choose to receive certain information.

To assign multiple addresses to a single Contact (such as an email address, a mobile number, and a Twitter handle), you must have the subscriber key feature enabled for your account. Contact your account executive for more information on enabling subscriber key for your account.

You can also include tags on each app subscription for a specific Contact. Those tags derive from information submitted via the app, and you can use those tags to filter Contacts into lists that receive more targeted communications.

Use the Contacts field to perform the following actions:

• Manage existing Contacts
• Manage the Lists built on your Contacts
• Display the number of opt-ins and percentage of growth over a given time span

You can also create an audience of Contacts via Audience Builder and conduct sends to those audiences. Refer to the Audience Builder documentation for more information on creating audiences to receive your sends.

Follow these instructions to create and manage Contacts within the MobilePush app.

How to Create Contact Attributes

Follow these steps to create Attributes for the Contacts in your account.

1. In Contacts, click the Attributes tab.
2. Click Create Attribute.
3. Enter the name of your attribute in the Label field.
4. If you selected Custom, click the Format dropdown menu and select the format of your new attribute:
   • Text
     • Enter any default value you wish to display in the Default Value field.
     • Choose whether you wish to set a maximum number of characters for this attribute.
       • Click No maximum to allow any value.
       • Click Set a maximumand enter a number in the field to limit this attribute to a specific number of characters.
   • Date
     • Choose the date to which you want the attribute to default in the Default value field.
     • Click the Default to current date checkbox to always default to the date when that attribute is created for that Contact.
   • Numeric
     • Enter any default value you wish to display in the Default Value field.
     • Choose whether you wish to set a minimum allowable value for this attribute.
       • Click No maximum to allow any value.
       • Click Set a minimum and enter a number in the field to prevent any values below the specified minimum.
     • Choose whether you wish to set a maximum allowable value for this attribute.
       • Click No maximum to allow any value.
       • Click Set a maximum and enter a number in the field to prevent any values above the specified minimum.
5. Click Required if you wish to make this attribute mandatory for all Contacts.
6. Click Read-Only if you don’t want this attribute to be modified.
7. If you wish to ensure that the attribute has a minimum number of characters, click Set a minimum and enter a number in the field. Otherwise, click No minimum.
8. If you wish to ensure that the attribute has a maximum number of characters, click Set a maximum and enter a number in the field. Otherwise, click No maximum.
9. Click Create.

Follow these steps to delete an attribute you created:

1. In Contacts, click the Attributes tab.
2. Click the attribute you want to delete.
3. Click the trash can icon in the upper-right corner.

4. Click Delete.

Ensure that the attribute you want to delete doesn’t contain any information you want to use in further communications. You can’t delete any system-defined attributes.

How to Import Contacts

To import a file, you must include values for the following attributes for each Contact:

• Platform - The operating system used by the mobile device:
  • iPhone OS
  • Android
• System Token - The platform-specific identifier (assigned by the platform owner, such as Apple or Google) requested by the device itself
• Device ID - The ID string generated by the Journey Builder for Apps SDK and used to identify the mobile device

When you import Contacts from your previous push provider, ensure that you include the System Token value (assigned by the platform owner, such as Apple or Google) stored by that push provider in your import.

If you import new Contacts before MobilePush generates the new Device ID, include a unique identifier value for each device involved in the import until that value can be generated.

Depending on the attributes included in your account, your import may also require other attributes. You can review the required attributes for your account by following these steps:

1. On the Overview screen, click Manage Contacts.
2. In the Mobile window, click the Attributes tab.
3. Make sure that your import file includes columns for all attributes with a Yes value in the Required column.

Import files must include values for all required attributes or the import will fail.

If your account uses a subscriber key, also known as a contact key, you must include and map that field as part of your import process.

When you import a mobile number for a Contact, ensure that you include all applicable country and region codes for that number (such as 1 and the area code for a US number or 44 and the area code for a UK number).

Follow these steps to import Contacts into your account:

1. In the Contacts field, click the arrow next to Add Contacts.
2. Select Import File.
3. Select the CSV file you want to upload.
4. Certify that all new Contacts on the CSV file opted in to receive your messages by clicking I agree.
5. Click Upload.
6. Click Next.
7. Select the list to which you want to import the new Contacts in the Target List window.
8. Click Next.
9. Select the app to which to associate the Contacts in the App dropdown menu.
10. Click Next.
11. Map the attributes in your CSV file to the attributes in your account. You can map the attributes in one of three ways:
    • Map by Header Row
    • Map by Ordinal
    • Map Manually
12. Click Next.
13. Review the information for accuracy.
14. Enter your email address in the Email Address field to receive notification when the import process completes. If you don’t enter an email address, you don’t receive notification.
15. Click Import.

Limit your import CSV file to 20 MB or less.

How to Manage and Edit Contacts

Follow these steps to change the information for current contacts.

1. Click the mobile number of the Contact you wish to edit.
2. Click the field you wish to edit.
3. Type in the new value.
4. Click Done.

Follow these steps to create an address for that Contact:

1. Click the mobile number of the Contact you wish to edit.
2. Click Add Address and select the type of address you wish to add.
3. Fill in the fields for that address.
4. Click Done.

Click Active or Disable on an Address to change the status of the Address for that Contact. You can’t send to a Contact using a disabled Address.

Follow these steps to add a new subscription to a Contact.

1. Click the mobile number of the Contact you wish to edit.
2. Click the Subscriptions tab.
3. Click Add Subscriptions.
4. Select the short or long code you wish to use for the subscription in the Code dropdown menu.
5. Click the keyword you wish to use for the subscription in the Keyword dropdown menu.
6. Click Save.
7. The subscription saves with a Subscribed status. To change the status for that subscription, click the Status dropdown menu and choose either Subscribed or Unsubscribed.

How to Create a New Contacts List

Follow these steps to create a new Contact list.

1. In Contacts, click the Lists tab.
2. Click Create List.
3. Enter the name of the list in the Name field.
4. Click Done.
5. Enter a description of the list in the List Description field.
6. Click Done.
7. Enter the email address that receives all notifications regarding this list in the Notification Email field.
8. Click Done.
9. MobilePush includes a filter that includes all active subscribers by default. If you want to, you can remove this filter. Follow these steps to add filters.
   1. Click Add Filter. You can choose to filter on Address attributes.
   2. Choose the attribute to include in the left half of your filter in the first dropdown menu.
   3. Choose the operand used in the filter in the second dropdown menu:
      • is equal to
      • is not equal to
      • is greater than
      • is greater than or equal to
      • is less than
      • is less than or equal to
      • exists in
      • exists in whole word
      • does not exist in
      • begins with
      • ends with
      • contains
      • does not contain
   4. Choose the information to use in the right half of your filter in the text field.
   5. Click the plus sign and repeat steps 2 through 4 to add filters.
10. Click Save.
11. For filtered lists, click Publish.

You can include the value today as a dynamic value for filtered lists. For example, you can use the filter date equals today + 1 to specify when birthday emails are sent to Contacts. The dynamic value equals the day on which the filtered list applies to the send.

Filtered lists must be published to bring in any new contacts or revised information for existing contacts.

How to Create a New List from Existing Lists

Follow these steps to create a List from the Contacts in your account that meet the List criteria.

1. In Contacts, click the Lists tab.
2. Click Create List.
3. Enter the name of the List in the List field.
4. Enter a description of the List in the List Description field.
5. Click Add in the Include window to add rules to bring Contacts into the List. You can use Boolean conditions to define the rules.
6. Click Add in the Exclude window to add rules that exclude Contacts from the List. You can use Boolean conditions to define the rules.
7. After you’ve included all the rules you wish to use for that List, click Save.
8. Click Publish to make the List available for use. Once you click Publish, you can monitor the status of your List using the Status field:
   • Available - the List is ready for use.
   • Queued - MobilePush processes the List in the order in which it was submitted.
   • In Progress - MobilePush is processing the List.
   • Publish Failed - MobilePush couldn’t publish the List. Try again.

How to Manage Lists of Your Contacts

Follow these steps to manage the Lists in your account.

1. In Contacts, click the Lists tab.
2. Click the List you wish to manage.
3. Make changes to the conditions in the List to increase or reduce the number of included Contacts.
4. After you’ve included all the rules you wish to use for that List, clickSave.
5. Click Publish to make the List available for use. Once you click Publish, you can monitor the status of your List using the Status field:
   • Available - you can use the List as part of your sends.
   • Queued - MobilePush processes the List in the order in which it was submitted.
   • In Progress - MobilePush is processing the List.
   • Publish Failed- MobilePush couldn’t publish the List. Try again.