Project Basics
  • Getting Started!
    • Building EX Surveys
      • EX Metrics
        • EX Dashboard
          • EX Dashboard Settings
            • Analyze EX Drivers
              • Good to Know: EX
                • Getting Started!
                  • Building CX Surveys
                  • CX Metrics
                    • CX Dashboard
                    • CX Dashboard Settings
                      • Analyze your drivers
                        • Good to know
                          • Getting Started!
                            • Assessment Question types
                              • Score and more
                                • Quiz participation
                                  • Get Results
                                  Home Directory Build Your Activity Intro to Activities

                                  Intro to Activities

                                  An Activity is a set of transactional or event-based records — purchases, service visits, support cases, appointments, or training sessions — stored inside a Directory and linked to the contacts inside it. Instead of a static list of contacts, you get a living profile in which every interaction is captured, dated, and available for both distribution and reporting.

                                  With Activities you can:

                                  • Store transactional and event-based records, such as purchases, service visits, and support cases, against the contacts in a Directory.
                                  • Import records from an Excel or CSV file, or connect an external source such as Salesforce or an SFTP server to keep records updated on a schedule.
                                  • Link every record to the correct contact through a Directory Lookup, so each interaction is attributed to the right person.
                                  • Direct feedback to a second Directory — for example, the employee who handled the interaction — using Feedback Recipient Mapping.
                                  • Use Activity fields as filters, segments, and comparison dimensions in Dashboard reporting.

                                  Navigate to

                                  Where to Find Activities

                                  Activities live inside a Directory, so a Directory must already exist before you can create one. The navigation path is Directories → [your Directory] → Activities.

                                  1. In the top-left corner of your screen, click Directories. The list of Directories in your account opens.
                                  2. Click the Directory in which you want to create or review an Activity. The Directory opens on the All Contacts tab.
                                  3. Click the Activities tab, next to the All Contacts tab. Every Activity created for this Directory is listed here.


                                  Each Activity has its own set of fields, and each record in the Activity is connected to a contact in the parent Directory through a Directory Lookup — a mapping rule that matches a unique identifier field in the Directory, such as Email Address, to a field in the Activity, such as Customer Email.

                                  That link is what allows a single response to carry the full context of an interaction. Once an Activity record is linked to a contact, a response collected against it inherits:

                                  • Who gave the feedback — the contact attributes held in the parent Directory.
                                  • What the feedback is about — the attributes stored on the Activity record itself, such as product, store location, or amount.
                                  • When it happened — the date or date-time field on the Activity record.
                                  • Who it is about — the attributes of a second contact, such as the employee who handled the interaction, when Feedback Recipient Mapping is configured.
                                  For example:A retail company maintains a Customer Directory containing Name, Email Address, and Phone Number. To collect feedback on recent purchases, it creates an Activity named Purchase History holding Customer Email, Product Purchased, Purchase Date, Store Location, and Amount. Because each purchase record is linked to a customer, a post-purchase survey can reference the exact product and store without asking the customer for either.

                                  A Directory must exist before you can create an Activity. If you have not built one yet, create the Directory and import your contacts first. A maximum of 50 Activities can be added per Directory.


                                  Ways to Build an Activity

                                  Records can be imported into an Activity from two sources. Both use the same import wizard and differ only in where the records come from and whether the import repeats.

                                  • From a file — upload an Excel or CSV file containing the records. Use this for a one-time load or for periodic imports you manage yourself. The maximum file size is 25 MB. Enable My file has a header when the first row of the file contains column labels, so that row is excluded from the imported records.
                                  • From External Sources — connect Salesforce or an SFTP server. Use this when records should be imported automatically on a schedule. You define an automation rule with a frequency of Daily, Weekly, Monthly, or a Custom schedule, set start and end dates, and enable email alerts for successful runs, failures, and exceptions.

                                  For the full import walkthrough, see Build Activity Using a File and Build Activity Using External Sources.


                                  Create an Activity

                                  Creating an Activity is a two-part process: name the Activity, then import records into it.

                                  1. Open the Directory in which you want to create the Activity.
                                  2. Click the Activities tab, next to the All Contacts tab.
                                  3. Click + Add Activities. A dialog box opens.
                                  4. Enter a name for the Activity you want to associate with this Directory.
                                  5. To create more than one Activity at a time, click + Add Activity and enter the next name. Repeat for each Activity you need.
                                  6. Click Save. The new Activities appear under the Activities tab.
                                  7. Hover over the Activity into which you want to import records and select Import Records.
                                  8. Select the source for the records — From a file or From External Sources — and click Continue to open the import wizard.
                                  9. At the Define Directory Lookup step, configure Respondent Mapping and, if required, Feedback Recipient Mapping. Click Continue.
                                  10. At the Map Fields step, set the field type for each imported field, then click Continue. The mapped fields are evaluated against their defined field types and the valid records are imported into the Activity.
                                  For example:Following the retail scenario above, name the Activity Purchase History and import the purchase records from an Excel file exported from the point-of-sale system.


                                  Respondent Mapping

                                  Use Respondent Mapping when the survey respondents are contacts in the same Directory that holds the Activity. This mapping is what links each Activity record to its contact, and it is configured for every Activity.

                                  1. At the Define Directory Lookup step of the import wizard, select the Directory Field you want to use for the lookup.
                                  2. Map it to the corresponding Activity Field.
                                  3. Click Continue to move to the Map Fields step.
                                  For example:In the Purchase History Activity, map Email Address from the Customer Directory to Customer Email in the Activity, so that each purchase record is linked to the correct customer.

                                  The parent Directory field selected for Respondent Mapping must exactly match one of the fields in the Activity. Once the mapping is created, it cannot be edited. If changes are required, delete the Activity and create a new one.


                                  Feedback Recipient Mapping

                                  Use Feedback Recipient Mapping when the subject of the feedback belongs to a different Directory — for example, employees, vendors, or service providers. The respondent still comes from the parent Directory; the feedback recipient is pulled from the second Directory.

                                  1. At the Define Directory Lookup step, toggle on Create Feedback Recipient Mapping.
                                  2. Select the Directory from which the feedback recipients will be pulled.
                                  3. Choose the appropriate Directory Field.
                                  4. Confirm that it matches the corresponding Activity Field.
                                  5. Click Continue.
                                  For example:The retail company also wants feedback on the salesperson who assisted the customer. The customer remains the respondent from the Customer Directory, while the salesperson belongs to a separate Salesperson Employee Directory. The Purchase History file includes a Salesperson Email field, which is mapped to the matching field in the Salesperson Directory so that feedback is attributed to the correct salesperson.

                                  The Feedback Recipient Directory must be different from the Respondent Directory. As with Respondent Mapping, the mapping cannot be edited after it is created.


                                  Activity Field Types

                                  At the Map Fields step, every imported field is assigned a field type. The system detects some field types automatically. Fields it does not recognize can be imported as Custom Fields and assigned the appropriate field type manually.

                                  Field typeUsed for
                                  StringText-based information: any combination of letters, numbers, and symbols.
                                  EmailEmail addresses.
                                  NumberInteger values.
                                  DateDates in MM/DD/YYYY, DD/MM/YYYY, or YYYY-MM-DD format.
                                  TimeTimes in hh:mm or hh:mm:ss format.
                                  Date-TimeDate and time in MM/DD/YYYY hh:mm, DD/MM/YYYY hh:mm, YYYY/MM/DD hh:mm, MM/DD/YYYY hh:mm:ss, DD/MM/YYYY hh:mm:ss, or YYYY/MM/DD hh:mm:ss format.
                                  BooleanBoolean values such as 1|0, Yes|No, Y|N, or True|False. Values are normalised to True and False after importing.
                                  PhonePhone numbers.
                                  URLWeb addresses.

                                  To set the country code for a phone field, click the gear icon next to the Field Type column.

                                  For example:A Purchase History file is mapped as Customer Email (Email), Product Purchased (String), Purchase Date (Date), Store Location (String), and Amount (Number).

                                  Using Activity Data in Reporting

                                  Once records are imported, Activity fields become available alongside contact fields across reporting, so you can analyze feedback by the details of the interaction rather than by the respondent alone.

                                  • Filter Dashboard data based on activities within Directories. On a Custom Dashboard, select the Directory from the dropdown, then choose Attributes and Metadata to filter records.
                                  • Assign Activity fields to rows and columns in the Cross Tab Widget to examine relationships between Activity attributes and survey results.
                                  • Segment and compare responses by Activity attributes, such as store location, product line, or service type.

                                  Activity fields appear in reporting only after records have been successfully imported and linked to contacts through the Directory Lookup.


                                  See also

                                  Love it when you
                                  know more?

                                  Subscribe for tips and insights to drive better decisions!

                                  completed tick icon
                                  Thank you!
                                  Your request has been successfully submitted.
                                  ×