Skip to main content
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Distribution Reporting (CX)

What's on This Page:

Was this helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Attention: If you are a Brand Administrator and are interested in reporting on distributions in CX Dashboards, you can contact your Customer Success Representative to learn more about what features are available to you.
Attention: The XM Directory Respondent Funnel can accomplish the same analysis as distribution reporting with an easier setup. We are currently not enabling distribution reporting for any new customers at this time. Reach out to your Account Executive or Customer Success Representative to learn more.

About Distribution Reporting

Distribution reporting enables users to report on response and completion rates over one or more surveys using any CX Dashboards widget. Additionally, the feature allows data from distributions to be filtered by embedded data stored in the contact list.

Qtip: If you have also purchased access to the Salesforce Extension, you can report on your Salesforce distributions with distribution reporting. This includes Salesforce emails triggered in the Tools and in the Actions tab.
Qtip: Distribution data is only accessible for email distributions that are sent after you’ve set up distribution reporting.
Attention: Distribution reporting will not pull in distributions that were sent via automations.

Setting Up Distribution Reporting

The distribution fieldset must be mapped before a dashboard can utilize distribution reporting.

Navigate to the dashboard settings.

Button that says Settings and has a gear icon

In the Dashboard Data page, click on Add Source, hover over Distributions, and select the survey that contains the distribution on which you want to report.

image showing how to add a distribution data source

If the distribution source is the first source added to the dashboard, it will automatically add 12 fields to the data mapping. If there is already a survey mapped alongside the new distribution source, you will need to manually add the following fields.

Manually Adding Distribution Data

  1. Add at least five new fields by clicking Add Field in the bottom left corner. Required fields with their corresponding field types include:
    image showing the necessary fields for distribution reporting

    • Send Date (Date): The date that the distribution sent.
    • Survey Started (Number Set): The number of surveys responses that were started by clicking the survey link.
    • Survey Started Date (Date): The date a survey response started.
    • Survey Completed (Number Set): The number of completed survey responses that have been recorded. This does not include recorded incomplete responses.
    • Survey Completed Date (Date): The date that a survey response was recorded.
  2. Locate the grey boxes that say Not Mapped under the distribution source. Click on a box associated with one of the newly added fields.
    image showing how to map values for distribution reporting fields
  3. Select the corresponding distribution field from the Fields If not all fields appear, click Show All at the bottom of the menu.
    Image showing the list of available distribution reporting fields
Qtip: In addition to the five required fields, distribution reporting has 11 additional fields on which you can report: Survey ID, Distribution ID, Distribution Channel, Recipient ID, Address, First Name, Last Name, Bounced, Bounce Type, Opened, and Open Date.

Adding Embedded Data

Qtip: When mapping fields using embedded data, remember that special characters such as period (.) and hashtag (#) are unsupported. See Best Practices and Troubleshooting Embedded Data for more tips on setting embedded data values.

You can also add embedded data that is stored in the contact list associated with your distributions.

  1. Click on Add Field.
    image showing the add field button and showing how to map embedded data
  2. Click on Not Mapped.
  3. Click on Add Embedded Data.
  4. In the popup that appears, type in the name of the embedded data field exactly as it appears in your contact list.
    image showing the add embedded data pop up
  5. Click Save.

Distribution Reporting Fields

By default, there are 18 fields you can map. Each field’s meaning is listed with what field type you should map it as.

  • Address: Text Value. Email addresses of the contacts who received the email.
  • Bounce Type: When an email bounces, there are two types of bounce.
    Qtip: Hard and Soft bounces are meant to serve as estimates to get you started troubleshooting. They are reliant on signals sent by the recipient server, and are therefore only as precise as the message sent to Qualtrics.
    • Hard: The email or its domain doesn’t exist.
    • Soft: The mailbox is full, the message is too large, or the server you sent the distribution to is down.
    • Empty: Emails that did not bounce.
  • Bounced: Number Set. How many emails bounced.
  • Distribution ID: Text Value. The internal ID of the distribution you just mapped.
  • Distribution Channel: Text Set. How the distribution was sent. For example, email or SMS.
  • Distribution Type: Text Set. Includes invite, interactive, and SF Trigger (Salesforce trigger).
  • External Data Reference: This element allows you to see the External Data Reference field from the contact list. This can be useful if the contact list has been deleted.
  • First Name: Text Value. First names of the contacts who received the email.
  • Last Name: Text Value. Last names of the contacts who received the email.
  • Opened: Number Set. Whether an email was opened (1) or not (0).
    Qtip: Qualtrics uses a pixel embedded in the email to gauge when an email is opened. When the pixel is loaded, the email is marked as opened. The number of opened emails is approximate as it relies on the recipient’s email server automatically loading the pixel.
  • Open Date: Date. When the email was opened.
  • Recipient ID: Text Value. The internal IDs of the contacts who received the email.
  • Send Date: Date. The date that the distribution sent.
  • Survey Completed: Number Set. The number of survey responses that have been recorded. This does not include recorded incomplete responses or manually closed responses in progress.
  • Survey ID: Text Value. The internal ID of the survey the distribution was sent out for.
  • Survey Started: Number Set. The number of surveys responses that were started by clicking the survey link.
  • Survey Started Date: Date. The date a survey response started.
Attention: Response rate and completion rate are not included as default fields. In order to add add these to your dashboard, follow the instructions in the next section!

Distribution Channel

Distribution Channel used to be called Distribution Type. If you are still seeing the wrong name with the wrong information on your dashboard and would like to change it, modify the field name in the data mapper.

image showing how to rename distribution channel

Bounce Type & Distribution Type

If you do not have Bounce Type or Distribution Type in your dashboard, you will need to add a field. You may need to click Show All before they appear as an option. Set these fields to Text Set.

image showing how to map bounce type and distribution type

Response Rate & Completion Rate

Before you can report on response rate and completion rate in your dashboard, you will need to add two custom metrics.

  1. In the dashboard settings, click on the Custom Metrics page.
    Image of the custom metrics section of dashboard settings, Adding name and equation as described
  2. Click Add Custom Metric.
  3. Call it “Response Rate.”
  4. Add the following equation: (Count) / (Count).
  5. Click the numerator.
    Image of Filtering the numerator
  6. Go to the Filters section.
  7. Click Add Filter.
  8. Select Survey Started.
    Image of Completing filter as described
  9. Edit the filter to only include responses with a value of “Survey Started.”
  10. Similarly, create a second custom metric and call it “Completion Rate.”
  11. Add the following equation: (Count) / (Count).
  12. Click the numerator.
  13. Go to the Filters section.
  14. Click Add Filter.
  15. Select Survey Completed.
  16. Edit the filter so it only includes responses where “Survey Completed.”
  17. Filter the denominator so it includes only responses where “Survey Started.
  18. Click Save.
Attention: If you are reporting on distributions and surveys in the same dashboard, you will need to add a filter for “Data Set Source” at the widget or page level to distinguish between distributions from different surveys.

Reporting on Distributions

Qtip: Don’t want to set up distribution reporting all by yourself? Check out our distribution page templates!

Now that you have your fields mapped, you can add them to widgets like any other field!

A dashboard reporting on distributions

Qtip: For the fields Survey Started, Survey Completed, Opened, and Bounced, values will be either 0 or 1, where 0 is false and 1 is true. You can recode these fields as Text Sets and set the recode values to plain text to make your dashboard easier to understand.

Recode editor where the 0 and 1 are being defined as sensible labels like survey not completed and survey completed

Distribution Methods Available for Distribution Reporting

When analyzing your distribution reporting data, you may notice slight differences between the data displayed in your dashboard and other similar features in Qualtrics, such as the distribution statistics available for survey email invitations. These differences occur because of how distribution events are recorded in the various parts of the Qualtrics platform. For distribution reporting in CX Dashboards, responses will only appear when the response has both an associated Distribution ID and Recipient ID. This means the response has an identifiable contact it can be linked to as well as a unique distribution event in Qualtrics. Below is a table of each distribution method in Qualtrics and if their responses are available in distribution reporting.

Distribution Method Available in Distribution Reporting?
Email Invitation/Reminder with Individual Link No
Email Invitation/Reminder with Anonymous Link No
Email Invitation/Reminder with Multiple Completes Link No
Personal Links No
Marketo Distributions No
SMS Invitations Yes
2-Way SMS Surveys Sent to a Contact List Yes
SMS Access Codes No
Anonymous Survey Link No
QR Codes No
Social Media Distributions No

Reporting Response Rates and Completion Rates as Percentages

When creating the response rate and completion rate custom metrics, these fields are generally reported as an exact number. However, you can report these values as percentages with just a few simple steps.

  1. Create a number chart widget.
  2. Click Add Metric.
    Editing a Number Chart
  3.  Select Count.
    Editing the count in the widget editing pane to the right
  4. Change the Metric to “Response Rate” or “Completion Rate.”
  5. Click Options.
    Changing the number to a percentage
  6. Change the Format to Percent.