Adding attributes to your project

You must add predefined and custom attributes to your project before you can set them on your audience for targeting. You can add up to 250 attributes per project.

After adding attributes, allow at least 10 minutes before setting their values. This delay ensures proper processing of the attributes within Airship.

No setup is required for default and NPS survey attributes. You can go straight to Targeting your audience using attributes. Similarly, attributes from Zero-copy data integration are available for targeting once Airship completes your project configuration.

Add Text, Number, and Date attributes

Follow these steps to add text, number, or date attributes to your project:

1. Go to Audience, then Attributes, then Attribute List.

2. Select Create attribute.

3. Search for the attribute you want to add. If it matches a predefined attribute, select from the results. Results do not include predefined attributes that have been archived or already added.

4. Complete the fields:

   Field	Description	Steps
   Attribute ID	The key that Airship uses to reference the attribute in the SDKs and API. Letters, numbers, and underscores only, 64 characters maximum. The ua_ prefix is reserved by Airship, so you cannot include it in the ID. Cannot be edited for predefined attributes.	Enter text.
   Name	A human-friendly name to help you organize and identify your attributes in the dashboard. Accepts all characters, 64 characters maximum.	Enter text.
   Type	Determines the format of the attribute value: Text, Number, or Date. Cannot be edited for predefined attributes.	Select a type.

   Important

   • Names and IDs must be unique.
   • Attribute IDs are case sensitive. If your attributes exist in an external system, make sure they are always the same case in both systems.
   • We recommend using lowercase characters with underscores for attribute IDs. For example, my_text_attribute.
   • You cannot edit a custom attribute’s ID or type after saving.

5. Select Add.

Add JSON attributes

When adding a JSON attribute, you must define the object’s data structure in a schema. An object is a collection of properties defined as key-value pairs. The values can be strings, numbers, dates, booleans, objects, or arrays. An array is an ordered collection of values. A JSON object allows for nested objects and arrays, so it can contain an array of properties, and those properties can themselves be objects containing more properties and arrays of properties.

You can manually enter a schema or automatically generate a schema by uploading a sample .json file. For upload:

• The value data determines the value types and will be removed.
• Array value type is determined based on the first element in an array, so when using an array with more than one type, the array is converted to a single type based on the first element. For example, the array ["hi", true, 3] will create an array of strings.
• Empty arrays, objects without keys, and keys with empty arrays or objects will be ignored.

You can assign any property a more readable name, like “Flight number” or “Reservation code”, as an alias. When creating a segmentA reusable audience group you create by selecting unique or shared user data. targeting a JSON attribute, you can select the alias from a menu instead of having to locate the property within the JSON schema. Aliases are supported in the dashboard only.

1. Go to Audience, then Attributes, then Attribute List.

2. Select Create attribute.

3. Complete the fields:

   Field	Description	Steps
   Attribute ID	A portion of the key that Airship uses to reference the attribute in the SDKs and API. Letters, numbers, and underscores only, 64 characters maximum. The ua_ prefix is reserved by Airship, so you cannot include it in the ID.	Enter text.
   Name	A portion of the key that Airship uses to reference the attribute in the SDKs and API. The name is also used to help you organize and identify your attributes in the dashboard. Letters, numbers, and underscores only, 64 characters maximum.	Enter text.
   Type	Determines the format of the attribute value.	Select JSON.

   Important

   • Names and IDs must be unique.
   • Attribute IDs are case sensitive. If your attributes exist in an external system, make sure they are always the same case in both systems.
   • We recommend using lowercase characters with underscores for attribute IDs. For example, my_text_attribute.
   • You cannot edit a custom attribute’s ID or type after saving.

   Tip

   You can select Add now to save the attribute, then edit and set up the schema later.

4. (To automatically generate a schema) Select Upload, then upload your sample .json file.

5. (To manually create a schema) Select Create schema.

6. Edit the schema:

   Option	Steps
   Add a property	Select the add icon (), enter a name, select a value type, then select the check mark. You must also select a value type for each array.
   Remove a property or object	Hover over the item, then select the remove icon ().

7. (Optional) Create aliases:

   1. Under Aliases, select the add icon ().
   2. Enter a name for the alias.
   3. Select a property in the schema. Its path will appear next to the alias.
   4. (Optional for arrays in the path) Select First or Last to specify the first or last item in the array. Defaults to Any.
   5. Select the check mark to save.
   6. Repeat for additional aliases.

8. Select Save JSON Schema.

9. Select Add.

Manage attributes

To view a list of your attributes, go to Audience, then Attributes. Search for specific attributes by name or ID. Filter by Default or Custom. The Custom filter includes predefined attributes.

Attributes from Zero-copy data integration are labeled External. You cannot edit or archive them in the dashboard. To make updates, contact your Airship account manager or Support .

Select the edit icon () to change an active attribute’s name, or a JSON attribute’s schema and aliases. You cannot edit archived attributes. Unarchive them first.

Select the archive icon () to archive or unarchive an attribute. Archiving stops data collection and reduces your attribute count. Prior data is available again after unarchiving. Archived predefined attributes do not appear when you create an attribute. Contact Airship Support  to delete custom attributes.

View upload history

Go to Audience, then Attributes, then Upload History to view the history and status of attributes set using a CSV file and named user association uploads.

For status “Processed with errors,” select the download icon () to download a CSV file of the identifiers that failed processing and their error reasons.