Many of our client communities incentivize members to participate. Knowing if and when the member successfully completed a study is an important factor in how clients reward their members. The Fuel Cycle API enables our partners to communicate the participation status back to Fuel Cycle.
Participation Status Codes
|COMPLETED||[Success] Participant met the requirements for successful completion of the study.|
|TERMINATED||[Failure] Participant failed to meet the requirements for successful completion of the study (such as being ineligible).|
|FAILED_DATA_QUALITY||[Failure] Participate did not provide adequate responses, or responses failed to meet quality checks.|
|FAILED_OVER_QUOTA||[Failure] Participant rejected due to quota/caps.
Note: This status is not typical. Quota limits are typically controlled by clients on the Fuel Cycle platform. Clients have full control over segmentation and which members are invited to participate in studies.
Fail states tend to be specific to partner study methodologies.
Fuel Cycle permits partners to define these thresholds that constitute a fail state, such as when a member's responses fail to meet partner data quality standards.
Notifying Fuel Cycle
Whenever a member leaves a study, you should communicate the participation status back to Fuel Cycle.
This can be accomplished with both redirects and an API call. You can implement both solutions as each serves a specific purpose.
The Participation status can be updated and corrected anytime. Fuel Cycle keeps track of the most recent participation status, making it possible to update.
When you redirect members back to Fuel Cycle you can append the status by adding the parameter participationstatus and the appropriate participation status code (above).
The advantage of the redirect is that it happens automatically when you send users back to Fuel Cycle (and it doesn't require an additional API call).
Call Update Study Track and specify the appropriate participation status code (above).
The advantage of this API call is that you can update the participation status at any time, including if the user navigates away from your study before you can redirect.
This API call is also useful for revoking the 'COMPLETED' status with 'FAILED_DATA_QUALITY' if it's discovered later that there were data quality issues with the participant's response. For example, if a client discovers poor quality responses when analyzing the data.