Fuel Cycle provides a seamless experience to community members as they participate in studies. From the member's perspective, it's important that this navigation is a smooth transition and frictionless experience. This encourages participation and quality responses.
The seamless experience is accomplished with redirects. Redirects pass the member from Fuel Cycle to your platform and back to Fuel Cycle (once the study is complete). This strategy also makes it easy to pass parameters efficiently.
Redirect Process
When members choose to participate in a study, they click on a link on the Fuel Cycle platform that navigates them to your platform. This link is the Participation URL you specified to Fuel Cycle when the study was created (See: API Calls - Create Study).
Fuel Cycle automatically appends several parameters to the participation URL as a query string. These parameters will be passed to you when the member clicks on the URL.
Examples
When you create a study, you'll provide Fuel Cycle with a participation URL.
The following examples reference fictional URLs. The actual URLs in production will vary according to the participation, edit, and report URLs you specify and the redirects provided by Fuel Cycle.
Initial URL
This is the initial URL you specify to Fuel Cycle when you call Create Study.
Participation URL
When Fuel Cycle presents the participation URL to members, we automatically append additional parameters. You'll receive these parameters when the member clicks on the link to participate in your study. You'll need these parameters to in later steps.
Our system will automatically detect if there is an existing query string in your participation URL. If there is, we'll simply append our parameters with an ampersand.
Fuel Cycle attaches three important parameters in this query string.
| Parameter | Description |
|---|---|
| fcUserId | This is the user ID of the participant. Use this parameter to fetch the member's pseudoanonymized profile points by calling Get User Data. |
| fcTrackId | This is the unique ID instance for this response by this user to this study. Use this parameter to notify Fuel Cycle the participation status of the member. |
| redirectUrl | This is the redirect URL to return the user back to Fuel Cycle when they complete or terminate from your study. This URL is encoded (with standard percent-encoding and must be decoded). This URL must include the fcTrackId parameter that's automatically added in advance. |
Send Study Status URL
We need you to communicate the participation status for each user once the study is completed (or the user terminates). This can be accomplished in two ways. One of the easiest methods is through the redirect URL by appending the participation status code.
Learn more about communicating the participation status back to Fuel Cycle.
You'll need to decode the redirect URL to remove the "percent encoding" so that the browser will recognize it as a URL.
Comments
0 comments
Please sign in to leave a comment.