Kaltura MediaSpace

DocsAssets › Kaltura MediaSpace

Last updated: 27 Mar 2020 / 11:21 AM / GMT

Our monetization platform features a fully developed integration with Kaltura MediaSpace.


Before you start

To use the Kaltura MediaSpace integration successfully, please make sure that you have already connected your InPlayer and Kaltura accounts.

If you haven’t done this and are not sure on how to go about doing it, make sure to read our guide.

Kaltura MediaSpace setup

First, go into your Kaltura MediaSpace admin panel.

You can access the admin panel by going to your MediaSpace portal and typing /admin at the end of the URL.

Ex. https://myportal.mediaspace.kaltura.com/admin

Next, from the left-hand menu, click on the Auth tab.

Scroll down to the enableMultiAuth option and set it to Yes.

Then, scroll down to the authMethods section. You will need to set up two authMethods.

You can do that by clicking on .

In the first authMethod, select SSO Gateway AuthN as the method and in the second, select Kaltura AuthN.

What this does, is to set up an admin lock to your channels page, so that only users that can log in as Admins will be able to add content.

The reason for enabling multiAuth is so that you can log in as administrator and configure your MediaSpace.
Once you set everything up, we recommend that you go back to the admin panel and disable multiAuth, by setting up the enablemultiAuth setting to No. After doing this, make sure to also set the authNAdapter settings to SSO Gateway AuthN (or Kms_Auth_AuthN_Sso if the first one is not available0), and the authZAdapter settings to SSO Gateway AuthZ (or Kms_Auth_AuthZ_Sso if the first one is not available0).
If you ever need to create a new channel, just go back here and re-enable the enableMultiAuth. After you’re done, disable it again.

Next, scroll down do the SSO section.

In the loginURL field, enter the InPlayer MediaSpace App URL, making sure to first edit the merchant-uuid part of the link with your InPlayer Account (Merchant) UUID and the domain-url part of the link with the MediaSpace domain URL:
https://mediaspace.inplayer.com/merchant-uuid?mediaspace=domain-url&login=true

Note: If you are using an InPlayer demo account, use this link instead:
https://staging-mediaspace.inplayer.com/merchant-uuid?mediaspace=domain-url&login=true

In the logoutURL enter the following, making sure to first edit the merchant-uuid part of the link with your InPlayer Account (Merchant) UUID and the domain-url part of the link with the MediaSpace domain URL:
https://mediaspace.inplayer.com/merchant-uuid?mediaspace=domain-url&logout=true

Note: If you are using an InPlayer demo account, use this link instead:
https://staging-mediaspace.inplayer.com/merchant-uuid?mediaspace=domainurl&logout=true

The Account (Merchant) UUID can be found in the Account details of your InPlayer dashboard. It is listed as Account UUID.

The domain-url should be the URL where your MediaSpace portal is hosted.
Note that if you’ve set up a custom URL for your MediaSpace, as opposed to using the default 123456.mediaspace.com format, depending on your custom URL domain configuration, you might need to enter the full URL, along with the www. part. You can test whether you need to use the www. part by checking whether your webpage is accessible without typing www. in front of it in Chrome’s guest mode. It is is, you don’t have to add the www. in the MediaSpace set up, and if it is not, you do.

Next, from the left-hand menu, go to the Ssogroupsync tab.

Set the enabled option to Yes.
Then click on .

Name the new privilege offerIds and leave the valueMappingType as Use privilege value as group name.

Finally, click the  button at the bottom.

Adding a custom tab to your MediaSpace menu

To make sure your customers have quick access to the page where all your assets are embedded, you can add a custom tab in your MediaSpace menu.

To do this, go into your Kaltura MediaSpace admin panel. As we mentioned before, you can access the admin panel by going to your MediaSpace portal and typing /admin at the end of the URL.
Ex. https://myportal.mediaspace.kaltura.com/admin

Go to the Navigation tab, scroll all the way down and click on .

In the new entry, set the type to Link and give your tab a name. In the value field enter the InPlayer MediaSpace App URL, which is the same link you previously entered in the SSO settings of your MediaSpace admin panel:
https://mediaspace.inplayer.com/merchant-uuid?mediaspace=domain-url

Remember to first edit the URL with your InPlayer Account UUID and your MediaSpace domain URL.

Finally, click the  button at the bottom.

The new tab will now appear on your MediaSpace menu:

The final step is to protect your MediaSpace content by creating an asset.

Creating the asset

Log into your InPlayer dashboard and from the navigation bar on the left, click the Assets icon.

Click on .

Select the Video asset type.

Enter a Name for your asset. This will be the name of the asset in your InPlayer Dashboard. The customers won’t see this.

Click .

Under Choose pricing type, choose the login type for the asset.

    1. If Register / Login is needed for access is enabled, the customers will have to register an account before they can access the content.


      With this login type, the following two pricing types are available:

      • Paid – where the customers will have to register an account and then pay so they can see the content.
      • Data Capture – where the customers will have to register an account, but won’t have to pay anything. They will be granted access to the content as soon as they complete their registration.
    2. If Register / Login is needed for access is disabled, the customers will have not have to register an account. Instead, they will log in with a password or a code that they have received or purchased beforehand.
      The way in which you will be distributing or selling the codes or passwords is up to you.


      With this login type, the only available option to select is Code / Password.

Once you’ve set up the pricing type for the asset, click .

Hover over Mediaspace and click on .
Click .

On the new page, you can set up your asset’s properties.

The right side of the screen is where you can set everything up, and the left side provides a preview where you can see how the asset will look on your webpage.

Asset Preview

In the Asset Preview section, set up the preview image, title and description, as well as the text for the BUY button. These will be the details that will appear on the actual asset preview when you embed it on your webpage.

Note that the Title will also appear on the final payment form on the paywall, as well as the notification email your customers will receive.

After setting everything up, make sure to click the button in the bottom right corner.

Price Options

You can set up three different pricing types:

  • ppv –  the customer makes a one-time payment and gets access for a limited time,
  • subscription – the customer accepts a recurrent charge at regular intervals that can be canceled at any time,
  • season – the customer makes a payment and gets access for a limited period, but at the same time accepts a recurrent charge for being able to watch during the next period. The date for the upcoming charge is determined by the merchant.
Setting up a ppv price

In the Price Options section, click .

In the General Info tab of the price option, set up the following:

  • In the Price description field, enter the price description that will appear on the paywall. Make it concise so your customers know exactly what they are buying.
  • In the Payment type field, select ppv.
    This is a one-time payment which grants access that expires after the end of the specified period counter either from the moment of purchase, or if using the Scheduled start feature, from the date set in the Scheduled start field (More on this below).
    The access period can be selected from the drop-down menu.
    You can pick one of the premade periods, or use the custom period option.
    When using the custom period option, you can specify the exact date and time at which the customers’ access will expire. This is very useful for doing presales since the customers’ access will expire on the date you’ve set up, regardless of when they’ve purchased their pass. An alternative way to set up presales is by using the Schedule start option from the Additional Info tab. More on that below.
  • In the Amount field, enter the price.
    The minimum price when using USD, EUR, or GBP is 1. When using all other currencies, the minimum is the equivalent converted amount of 1 USD.
    The currency can be selected from the drop-down menu. If you wish to use a currency that is not in the list, you can contact us at support@inplayer.com and we’ll make sure to add the currency for you asap. We support all currencies listed here.

In the Additional Info tab, you can set up the following:

  • Schedule start
    This is the date and time at which the customer’s access period will start after they’ve purchased the asset. Until that time, they will see a message informing them to come back on the scheduled date.
    This is a useful option for setting up presales. You can select the access period from the Payment type section in the General Info tab, and then set up when will that access period begin. It works for both the pre-defined access periods (24 hours, 48 hours, etc), and for the custom period.
    If you leave the Schedule start field blank, the customers’ access will begin right after purchasing.
  • Geo-restriction
    With this option, you can restrict the price option to specific countries.
    You can choose to either include (whitelist) or exclude (blacklist) a single country, or use a country set you have created previously.
    You can learn more about setting up country sets here.

After setting everything up, make sure to click the button in the bottom right corner.

*Note that once you set the payment type for an asset, you cannot change it. You can change the other payment fields (access period duration, price, etc) but not the payment type. If you wish to set a new payment type, you will need to set up a new price option.

Setting up a subscription price

In the Price Options section, click .

In the General Info tab of the price option, set up the following:

  • In the Price description field, enter the price description that will appear on the paywall. Make it concise so your customers know exactly what they are buying.
  • In the Payment type field, select subscription.
    This is a recurring payment that is renewed automatically. Access is granted at each renewal.
    The renewal period can be selected from the drop-down menu.
  • In the Amount field, enter the price.
    The minimum price when using USD, EUR, or GBP is 1. When using all other currencies, the minimum is the equivalent converted amount of 1 USD.
    The currency can be selected from the drop-down menu. If you wish to use a currency that is not in the list, you can contact us at support@inplayer.com and we’ll make sure to add the currency for you asap. We support all currencies listed here.

In the Additional Info tab, you can set up the following:

  • Free trial
    With this, you can set up a free trial period.
  • Additional fee
    With this option, you can set up a one-time fee that will be charged when the customer purchases the subscription, as an addition to the regular subscription fee. The fee will only be charged once, together with the first subscription charge.
  • Geo-restriction
    With this option, you can restrict the price option to specific countries.
    You can choose to either include (whitelist) or exclude (blacklist) a single country, or use a country set you have created previously.
    You can learn more about setting up country sets here.

After setting everything up, make sure to click the button in the bottom right corner.

*Note that once you set the payment type for an asset, you cannot change it. You can change the other payment fields (access period duration, price, etc) but not the payment type. If you wish to set a new payment type, you will need to set up a new price option.

Setting up a season price

In the Price Options section, click .

In the General Info tab of the price option, set up the following:

    • In the Price description field, enter the price description that will appear on the paywall. Make it concise so your customers know exactly what they are buying.
    • In the Payment type field, select season.
      With this payment type, the customer purchases a season pass that lasts for a specific period, then expires, and is then renewed for a second period at a certain point in the future, upon which a new charge is taken from the customer. The payment will continue to renew in the same manner for as long as you keep scheduling upcoming seasons. A new season needs to be re-scheduled after the end of each one. You will get an automated email at the end of each season reminding you of this.
      The season payment type is best suited for seasonal content, like sports, where using standard back-to-back subscription payments might not be suitable, since content is only available during specific parts of the year, and in between there are periods with nothing or nothing new to watch.
      A basic season cycle is represented here:
  • In the Season start field, enter the start date and time of the season. This determines when the access for customers who purchase a pass will start. It is also possible for access to be granted to the customers from the moment of their purchase. This is accomplished with the Off-season access option. We’ll talk about that further below. Also, a season price option will not be available for purchase until the Season start has been set.
  • In the Season end field, enter the end date and time of the season. This is the access cut-off date for the current season. Access will be re-granted upon the renewal of the payment for the next season. It is also possible for the access to continue beyond the end of the season, i.e. until the moment of renewal of the payment for the next season. This is, again, done with the Off-season access option, which we’ll see below. Also, a season price option will not be available for purchase until the Season end has been set.
  • In the Anchor date field, enter the date and time for the renewal of the payment, i.e. the date and time when the payment for next season will be taken. Note that once you set up the first anchor date, the anchor date for the next season will be automatically set to one year after the first anchor date. You can always go back and change it if you wish.
  • In the Seasonal price field, enter the amount that will be charged upon renewal for the next season, i.e. on the Anchor date. Note that this is not the price for the current season.
    The minimum price when using USD, EUR, or GBP is 1. When using all other currencies, the minimum is the equivalent converted amount of 1 USD.
    The currency can be selected from the drop-down menu. If you wish to use a currency that is not in the list, you can contact us at support@inplayer.com and we’ll make sure to add the currency for you asap. We support all currencies listed here.
  • In the Current price field, enter the account that will be charged for the current season. Whenever a customer goes to your page, they will see this price. You can change this price at any time. For example, you can have it be equal to the Seasonal price at the beginning of the season, and then reduce it as the season progresses.
    The minimum price when using USD, EUR, or GBP is 1. When using all other currencies, the minimum is the equivalent converted amount of 1 USD.
    The currency can be selected from the drop-down menu. If you wish to use a currency that is not in the list, you can contact us at support@inplayer.com and we’ll make sure to add the currency for you asap. We support all currencies that are listed here.
  • With the Off-season access option, you can decide whether the customers will only have access during a season (between the season start and end date), or also during the off-season period, so they can watch replays, for example.

    *Note that once you set the Season start, Season end, Anchor date, and Seasonal price you cannot change them until the current season ends. You can only change the Current price amount.

In the Additional Info tab, you can set up the following:

  • Free trial
    With this, you can set up a free trial period. If the Off-season access option is enabled, the free trial will begin right after the customer completes their purchase. If the Off-season access option is disabled, the free trial will begin on the Season start date.
  • Additional fee
    With this option, you can set up a one-time fee that will be charged when the customer purchases the subscription, as an addition to the regular subscription fee. The fee will only be charged once, together with the first subscription charge.
  • Geo-restriction
    With this option, you can restrict the price option to specific countries.
    You can choose to either include (whitelist) or exclude (blacklist) a single country, or use a country set you have created previously.
    You can learn more about setting up country sets here.

After setting everything up, make sure to click the button in the bottom right corner.

*Note that once you set the payment type for an asset, you cannot change it. You can change the other payment fields (access period duration, price, etc) but not the payment type. If you wish to set a new payment type, you will need to set up a new price option. You also cannot delete a season price option before the current season ends.

Asset content

In the Asset content section, enter your MediaSpace domain URL, without the https:// or http:// part.
As we already mentioned, if you’ve set up a custom URL for your MediaSpace, as opposed to using the default 123456.mediaspace.com format, depending on your custom URL domain configuration, you might need to enter the full URL, along with the www. part. You can test whether you need to use the www. part by checking whether your webpage is accessible without typing www. in front of it in Chrome’s guest mode. It is is, you don’t have to add the www. in the MediaSpace set up, and if it is not, you do.

After setting everything up, make sure to click the button in the bottom right corner.

Restrictions

In the Restrictions section, you can set up any geographic, domain, and/or age restrictions for the asset you wish to use.

You can learn more about setting up the restrictions here, here and here.
After setting everything up, make sure to click the button in the bottom right corner.

Linking the asset with a Kaltura Channel

Once you have your InPlayer asset, it is time to link it to a Kaltura Channel.

First, make sure that your channel is set as Private, so that only users who register an account and make a purchase will be able to see the content. This is very important.

Then, go to the InPlayer MediaSpace App URL, which is the same link you previously entered in the SSO settings of your MediaSpace admin panel:
https://mediaspace.inplayer.com/merchant-uuid?mediaspace=domain-url

Remember to first edit the URL with your InPlayer Account UUID and your MediaSpace domain URL.

Here, you will see the InPlayer asset you have just created.

You now need to create a user group.

For this, go to your Kaltura MediaSpace admin panel and then to the MANAGE GROUPS tab.

Create a new user group by clicking on .

In Group Name and Group ID, fill in the Asset ID from the InPlayer Dashboard.
Leave the Add Users field blank.

To find the Asset ID, go to the Assets tab of your InPlayer Dashboard.
The Asset ID for your asset will be listed in the asset list.

Next, go to your Kaltura KMC dashboard.

Go to the CATEGORIES tab and click the channel you wish to link to the InPlayer asset.

On the left-hand menu, click Entitlements, scroll down to the bottom and click on Manage Users.

Click on .

Go back to the InPlayer Dashboard, go to the Assets tab, copy the Asset ID from the asset you wish to link to this channel and paste it in the Select End-Users filed.
Press Enter on your keyboard and then click .

And with that, you’re done!

Do the same steps for every individual channel you wish to monetize.

Customer Experience

A customer comes to your MediaSpace portal and clicks on the tab where you’ve embedded your assets:

Once there, they click on the asset they wish to purchase.

The paywall appears, they click on  and fill out the register form.

On the next screen, they select one of the available price options for that asset.

If there’s only one price option available, instead of the price selection screen, they are immediately forwarded to the final payment screen, where they enter their credit card or PayPal information.

They finish the purchase by clicking .

The following message appears, where the customer can choose to either purchase more channels, or go straight to their list of purchased channels.

To log into an already purchased channel, a customer just needs to go to the tab where you’ve embedded your assets, click on the asset they purchased, and log in.After logging in, they will be forwarded to their list of purchased channels.

Removing the InPlayer Integration

If you ever wish to remove the integration, just set back all the settings in the Kaltura admin panel  to their default states by doing the following:

In the Auth tab:
Under SSO, delete the loginurl and logouturl links.
Under Auth Adapters, set the authNAdapter and authZAdapter values to Kaltura AuthN.

In the Ssogroupsync tab:
Set the module to enabled: NO
Delete the whole offerIds privilege.

For more information about the ins and outs of Kaltura MediaSpace read Introduction to Authentication and Authorization Solutions 5.x.

For any questions, don’t hesitate to contact us on support@inplayer.com.

We use cookies to analyse our traffic. We also share information about your use of our site with our analytics partners. See details