keyboard_return Back to docs
Tracking Survey Completion

Inclivio records how your participants interact with each ping, allowing you to track survey completion rates and problem solve obstacles before they become major issues. In your Dashboard console and in the Activity tab in each participant page, you can find information on when and how pings are sent, whether your participant required reminders, and when they clicked on their ping. Using our Survey Completion API, you can also use Inclivio to track when your surveys are actually completed by participants.

Inclivio sends the pingid as a survey parameter with each ping. If your survey software allows, you can send this value back to Inclivio at the end of the survey along with survey-complete = true in the body of your API call to inform Inclivio that your participant has completed their survey.

How to set up your survey to interact with Inclivio's Custom Survey Parameter API

The following example shows you how to achieve this using the web service feature in Qualtrics®.

  1. Capture the pingid survey parameter as embedded data (refer to the Survey Parameters documentation for more information)
  2. Add a New Element Here > Web Service
  3. Add the following information:
    • Method: POST
    • URL: https://https://incliv.io/surveyCallback/surveyCallback
  4. Select 'Add a body parameter to send to web service'
  5. Set the parameter as pingid and the value as ${e://Field/pingid} (this is equivalent to Insert Piped Text > Embedded Data Field > pingid).
  6. Add a second body parameter by pressing the button. Add your project's API key (found in Project > Settings > Project API Key). Set the parameter as api-key and the value as your project's API key.
  7. Add another parameter called survey-complete and set the value as true to indicate that the participant has completed their survey. Make sure to place this module at the end of your survey flow, right before your participants receives confirmation of their submission.