Real Time Pricing Overview
Project Pricing Overview
This article explains how project pricing is calculated on the Prodege platform and provides guidance to help ensure your project runs smoothly from launch through completion.
How Is CPI Calculated?
Initial CPI Calculation
When creating a project using the Create Project API, you must provide expected_ir and loi. These values are used to calculate a custom CPI based on the agreed upon IR and LOI pricing grid. The calculated CPI is returned in the success response of the Create Project API.
{
"return_status": {
"status_id": 1,
"message": ["Project Created"]
},
"prodege_project_id": 16970575,
"cpi": 1
}Updating CPI Before Fielding
If expected_ir or loi is updated using the Update Project API before the project reaches a minimum number of clicks, the CPI will be recalculated. The updated CPI is returned in the success response.
{
"return_status": {
"status_id": 1,
"message": ["Project Updated"]
},
"prodege_project_id": 16970575,
"cpi": 1
}CPI After Fielding Begins
After a minimum number of survey starts has been reached, CPI is calculated using the project actual IR and median LOI. The current CPI can be retrieved at any time using the Get Project Info API. Upon completion, the CPI for a specific transaction can be retrieved using the Lookup Transaction Status API.
Max CPI
IR and LOI can fluctuate while a project is in field. Setting a Max CPI allows you to cap the CPI and continue sampling up to that price to minimize interruptions. Max CPI can be set when creating a project using the Create Project API or updated at any point during the project lifecycle using the Update Project API. The Max CPI can be retrieved at any time using the Get Project Info API.
Your account can be configured to compare the Max CPI against either the current project CPI or the average project CPI. Please consult with Prodege to configure this behavior.
If changes in IR or LOI require a CPI that exceeds the Max CPI, the project will be paused.
What If My Project CPI Is Higher Than Originally Quoted?
If real time project performance results in a CPI that exceeds both the originally estimated CPI and the Max CPI, the project will be paused. To resume sampling, the required CPI must be approved, the Max CPI must be increased if necessary, and the project status must be set back to LIVE using the Update Project API.
When a project is paused due to real time pricing, an email alert containing the current and required CPI can be sent to recipients of your choosing. Please contact your Prodege account representative to enable email notifications.
Detecting CPI Related Pauses
You can detect whether a project has been paused due to CPI changes through the Real Time Pricing webhook or via fields returned in the Get Project Info API response.
The disabled_by_cpi_reality_check field appears only when a project is paused due to real time pricing and will be set to true. The ir_based_cpi field also appears only in this scenario and represents the newly required CPI that exceeds the Max CPI. This field is returned alongside cpi and max_cpi.
Example response for a project paused due to real time pricing:
How Is IR Calculated?
IR is calculated using the following formula:
IR = Completes / (Completes + DQ + OQ)
For example, with 50 completes, 150 DQ, and 50 OQ, the IR would be 20 percent.
What Happens After I Approve a Higher CPI?
Once a revised CPI and Max CPI are approved, the project may resume sampling and the project status may change from PAUSED to LIVE. If subsequent changes in IR or LOI require a CPI higher than the newly approved amount, the project may pause again and trigger another alert.
Will My CPI Decrease If Performance Improves?
Yes. The Prodege platform continuously monitors project performance while the project is live. CPI can increase or decrease based on real time IR and LOI. Completes are charged at the CPI in effect at the time the transaction occurs. The current CPI can always be retrieved using the Get Project Info API.
Last updated