Custom Attributes

The following details the fields and file format required to create and updated Custom Attributes in Pulsate using SFTP.

Custom Attributes

When creating a CSV file that contains Custom Attributes, the file must include the following fields:

Field NameRequiredDescriptionType
aliasYesThe unique identifier for the custom attribute.string
nYesThe name of the custom attribute.string
vYesThe value of the custom attribute.string
tYesThe data type of the custom attribute's value.'boolean', ‘date_ago', 'integer', 'numeric', 'string'
sourceNoThe source of the custom attribute.string
product_idNoThe product ID associated with the attribute.string
categoryNoThe category the custom attribute is associated with.string

CSV File Example

Below is an example of how your CSV file might look for custom attributes:

alias,n,v,t,source,product_id,category
"user123","count_checking_accounts","3","numeric","","",""
"user124","enrolled_estatements","true","boolean","","",""
"user125","account_type","personal","boolean","","",""
"user125","loan_auto_thanksgiving_special_status","application_started","string","los_provider_name","loan_auto_thanksgiving","loan_auto"
"user126","loan_auto_thanksgiving_special_status","application_complete","string","los_provider_name","loan_auto_thanksgiving","loan_auto"

Notes:

  • Ensure that your CSV file is comma-separated and that it includes headers in the first row.
  • Double-check that all required fields (alias, n, v, t) are present in the file.
  • Use quotes to enclose string values if they contain commas or other special characters.
  • The t field must only contain one of the specified types, matching the data format of the v (value) field.
  • Timestamps should be provided in Unix time format (seconds since the Unix Epoch).

By following the above file format specifications, your data will be correctly ingested by the Pulsate platform, enabling you to leverage our Segmentation and Personalization features effectively. If you require further clarification or assistance with preparing your CSV files, please reach out to [email protected] or contact your Customer Success Manager.


What’s Next