The Google Surveys REST API will be deprecated effective April 19th, 2019. After this time, the API end point will be disabled, resulting in errors to all Surveys API calls. Please contact your Surveys account manager or if you have any questions.

Incidence pricing

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

If a survey requires provisional prices, the get or update response won't populate the cost field until survey.cost.costPerResponseNanos has been calculated.

All surveys go through a review before they're available to the public. For incidence pricing, the API's response state will indicate awaitingReview 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 start 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, consult the Audience tests 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.

Send feedback about...

Google Surveys
Google Surveys