Incidence pricing is a sliding-scale pricing model determined by the rarity of the survey's screened audience, as measured by an audience test. You can create a survey to target people by asking them a screening question. The survey is billed at a rate proportional to the incidence rate of the property—people who select a threshold (screening) answer to the screening question.
Incidence pricing enables surveys created by API to trigger the new incidence pricing model and run provisionally. It also enables developers to manage the new variably priced surveys by updating the API call flows and endpoint surfaces.
Responses of survey API calls
All surveys go through a review before they're available to the public.
For incidence pricing, the API's response state will indicate
prior to calculating a survey's price.
While the price quote is being calculated, the API returns the state
calculatingPriceQuote. If the price quote is calculated
successfully, the API returns the state
paused and you can call
to start the survey. If the calculation fails due to a low incidence rate,
it returns the state
error. For more details on the minimum incidence rate,
help center article.
If the survey does not run to completion after the incidence test, due to an incidence rate lower than expected, a refund is issued in the form of an account credit.
For more information on survey states and transitions, consult the Survey State Diagram.