Audiences
An audience is a saved set of conditions about visitors, such as "mobile visitors from India". A test that uses one copies its conditions, so editing the audience later never changes a test that already uses it.
List audiences
Returns the project's saved audiences, oldest first. Each one comes with the number of tests that took their conditions from it.
Create an audience
Saves a named set of conditions that any test in the project can then use. Needs an `editor` or `publisher` key, and a plan that includes saved audiences.
Get an audience
Returns one saved audience, with the number of tests that took their conditions from it.
Update an audience
Changes only what you send. `name` on its own renames the audience. `conditions` replaces the whole set of conditions; it is never merged into the old one. Tests that already use the audience keep the conditions they copied, so an edit reaches only the tests that apply it next. Needs an `editor` or `publisher` key, and a plan that includes saved audiences.
Delete an audience
Deletes a saved audience for good. It is refused while any test took its conditions from it. Deleting works without the saved audiences plan, so an account that lost it can still tidy up. Needs an `editor` or `publisher` key.
List audience fields
Returns every field an audience condition can name, and the values each one takes. Read it before writing conditions: a country is `US`, not `USA` or `United States`. A field that takes free text has `values` set to `null`.