Audience is used to determine content access. The four audience scopes (groups) are:
|Audience Common Name||Audience Internal Name|
* The "local" one is special, because the "local" Audience Scope will always have a station attached to it. So we can have a "local" Audience Scope with the WETA station. Or a "local" Audience Scope with WNET, and so on.
Multiple audiences can be attached to a show. Let's suppose we have following shows:
- Foo (local WETA)
- Bar (local WETA, local WNET, all-stations)
- NOVA (national)
- Arthur (kids)
The audience filtering in the API works as follows:
- You can use multiple scopes when filtering: audience-scope=national&audience-scope=kids
- If the "local" scope is used in the filtering, the "audience" parameter is required. "audience" is the call sign of a station or the station content id. we can have multiple audience filtering: audience=weta&audience=wnet. you can use either the id of the station or the call sign, but not both.
- all national shows and wnet local: audience-scope=national&audience-scope=local&audience=wnet: Bar, NOVA
- all national shows, wnet and weta local: audience-scope=national&audience-scope=local&audience=wnet&audience=weta: Foo, Bar, NOVA
- wnet and weta local: audience-scope=local&audience=wnet&audience=weta: Foo, Bar
- national and kids: audience-scope=national&audience-scope=kids: NOVA, Arthur
- all-stations and national: audience-scope=all-stations&audience-scope=national: Bar, NOVA
Due to the various cache times, we cannot guarantee that a video asset will be available exactly at the start time that is set in Media Manager. For timely content, such as a video that is aligned with a broadcast, we recommend that you schedule your content to go live 30-60 minutes before you want it to go live on your site. This ensures it will go live on time, despite cache times.
Availability is used to describe the interval during which an asset is available. It is also used when playing videos. For example, if a user donated to WGBH and wants to play a video for a show with local audience WGBH, we must use a URL Redirection Service (URS) url from the station members block. This is because when the URS link was registered, the available dates from the "stations members" block were used.
There are three levels of asset availability:
|Public||All users who we don't know anything about (anonymous/non-logged in users or those without a localized station).|
|All Members||All users who made a donation to a station that is different from the show's local audiences. For example, if a user donated to WGBH but is watching a show with audience PBS National, "all members" availability can be used.|
|Station Members||All users who made a donation to a station that is the same as one of the show's local audiences. For example, if a user donated to WGBH and is watching a show with local audience WGBH, "station members" availability can be used.|
Relationship between shows and audience
|Let's assume we have the following shows with assets:||Let's assume we want to have the following shows on a site:|
Connection between audience and availability
|Let's assume we have the following shows with assets:||Let's assume we want to display assets on a site that are available (the value of availability_window property from the API):|
Connection between audience, availability, and playable links
Let's assume we have the following shows with assets:
|Let's assume we want to play assets that are available in a player (the value of playable_window property from the API):|