Skip to content

Understanding how product offerings are selected

There are two ways an app can discover which product offerings that it's user can purchase.

  • explicit listing available offerings
  • by checking if it's user is entitled to play a certain asset, and if not it will get a list of product offerings that will give access

In both cases the returned product offerings are only the product offerings available in the country the user currently is in.

Determining the current country

The app detects its country location by calling a location endpoint in the backend, which translates the app's IP-address to a country. This country is then used by the backend when the app discovers available product offerings.

Filtering product offerings based on country code

The backend filters product offerings based on provided country.

A product offerings has the following fields to define where to be available

  • Allowed regions
  • Allowed countries
  • Disallowed regions
  • Disallowed countries

If all of these fields are empty the product offering is available in any country.

If disallowed countries or regions matches, then the product offering is not available in any matching country. Disallow has precedence over allow.

Else the product offering is available if allowed countries and allowed regions are empty or if the country matches any of them.


Regions can be defined here: Portal -> Settings -> Service Settings -> Regions and Countries.


Example

A product offering defined as below will be available in Norway (NO), Denmark (DK) and Finland (FI), but not in Sweden (SE).

Allowed regions: nordics (Assume defined as SE, NO, DK, FI)
Allowed countries: (empty)
Disallowed regions: (empty)
Disallowed countries: SE