Month: November 2020

Knovio

Posted on by inplayer_support

Introduction

By integrating your Knovio and InPlayer accounts, you will be able to quickly and easily monetize all your Knovio videos, as well as track the payment analytics straight from your Knovio account.

At the moment, the InPlayer paywall can be used for individual Knovio videos. Knovio Showcase support is coming soon as well, but for the time being you will need to contact Knovio’s Support team if you wish to use this feature.

InPlayer setup

To integrate your InPlayer and Knovio accounts you will be taking advantage of our OAuth & SSO feature.
Log into your InPlayer dashboard, open your account settings menu and under Settings, go to OAuth & SSO.

Create a new OAuth app by clicking on the New app box.

Give your new app a name and click Create.

Once you create your new OAuth app, you will need it’s Key and Secret.

The Key will be shown in the app box, but you will have to generate a new Secret.
To do this, click on Generate new….

Confirm by clicking on Yes, generate!.

Your secret will be displayed in a new window.

Copy the secret key by clicking on Copy app secret key and keep it somewhere safe. Note that once you close this window, you will not be able to see the secret ever again and if you happen to lose it or if its compromised, you will have to generate a new one.

Once you have your Secret and your Key, send them over to Knovio’s support on support@knowledgevision.com, asking them to enable the paywall solution on your Knovio account.
Once they do, you can start monetizing your content.

Knovio setup

Once you get the confirmation from Knovio’s support team that the paywall feature has been enabled, you can start using it on your videos.

To do this, log into your Knovio account and go to your list of videos in the Manage tab.

On the video you wish to monetize, click Share, and scroll down to the Sharing Settings section.

In the Sharing Settings, choose InPlayer Paywall.

In the new window, enter the Title and Description that will appear on the paywall screen in front of the video, and select the InPlayer Branding Theme (if you have one set up).

Then click on Create Paywall.

Next, you will need to set up the pricing for your video. To do this, click on the Edit Paywall button.

You will be redirected to your InPlayer dashboard and land directly into the properties of your video asset.

Here, you can set up your asset’s properties.

Setting up the InPlayer asset

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 various sections of the assets will look on your webpage.

Preview

In the Preview section, set up the preview title, description, and thumbnail 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 viewers will receive.

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

Preview templates

In the Preview templates section, you can choose how the asset will appear when you embed it on your webpage.

You can go with the default preview, or select one from the list.

If you’ve set up a default branding theme in your dashboard Settings, where you’ve selected a default preview template, and you want to use that template for this asset as well, make sure to click the Reset to default option.

If, however, you wish to use a separate preview template for this asset, despite the fact that you have set up a default one in your branding theme, make sure to choose a preview template and then click on Save.

When choosing your preview template, you can click on the View fullscreen button at the top left to see how that template would look on various screen sizes.

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

Preview default branding theme

If you have set up a default branding theme in the Settings (more on this here), you can see how the asset will look like once the theme will be applied to it.

To do this, just click the Preview default branding theme toggle.

Price options

You can set up three different pricing types:

  • ppv –  the viewer makes a one-time payment and gets access for a limited time,
  • subscription – the viewer accepts a recurrent charge at regular intervals that can be canceled at any time,
  • season – the viewer 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.

Note that the season price type needs to be activated on your account by our team, so make sure to contact us at clients@inplayer.com for this.


In the Price options section, click New price.

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 viewers 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 Schedule start feature, from the date set in the Schedule 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 viewers’ access will expire. This is very useful for doing presales since the viewers’ 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 on the list, you can contact us at clients@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 viewers’ 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 viewers’ access will begin right after purchasing.
    Note that if you change the scheduled start setting after some viewers have made their purchase, their access start will not change.
  • Geo-restriction
    With this option, you can restrict the price option to specific countries.
    You can choose to either allow (whitelist) or deny (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 Save 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.


In the Price options section, click New price.

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 viewers 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 on the list, you can contact us at clients@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 viewer 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 Save 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.


In the Price options section, click New price.

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 viewers know exactly what they are buying.
  • In the Payment type field, select season. With this payment type, the viewer 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 viewer. 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 viewers who purchase a pass will start. It is also possible for access to be granted to the viewers 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 Next rebill 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 rebill date, the rebill date for the next season will be automatically set to one year after the first date. You can always go back and change it if you wish.
  • In the Next rebill price field, enter the amount that will be charged upon renewal for the next season, i.e. on the Next rebill 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 clients@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 viewer 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 New rebill 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 clients@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 viewers 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, Next rebill date, and Next rebill 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 viewer 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 viewer 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 allow (whitelist) or deny (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 Save 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.

Content

The Content section will already be filled in with the iframe of your video. No need to do anything here.

Restrictions

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

Geo-restrictions make the asset available only in certain countries, URL restrictions make it embeddable on only certain URLs, and Age restrictions make it accessible by only viewers who fall under a certain age group.

You can learn more about setting up the restrictions here, here and here.

Remember that any restrictions you set up in the individual assets will overwrite the ones that have been set up in the dashboard Settings.
After setting everything up, make sure to click the Save button in the bottom right corner.

Additional metadata

Here, you can add additional metadata to your asset, which can be used for various purposes. An example would be to add metadata that will group the assets in different categories that you can later use in a filter you have developed for your webpage.

Go back to your Knovio account, go to the Manage tab and then to the video’s Share settings, and get the embed code or the link for the video.
You can then embed your video on your page or share the link to it and start monetizing it!

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

JW Player

Posted on by inplayer_support

Connecting InPlayer and JW Player

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on JW Player.

Enter the Secret and Key from your JW Player property, and click Save.

Make sure you are integrating the correct JW Player Property.

How to find the Secret and Key

Log into your JW Player account.

If your account has multiple Properties, open the one you wish to integrate.

Once you’re in the right Property, in the top right corner, click on , and then on API Credentials.

Click on SHOW CREDENTIALS and the Secret and Key information will be presented.
Make sure you get the credentials of the correct property.

Once you connect your InPlayer and JW Player accounts, the next step is to protect your JW Player content by creating an asset.

You can learn how to do that here.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Eventbrite

Posted on by inplayer_support

Connecting InPlayer and Eventbrite

First, log into your InPlayer Dashboard.

Go to Settings, then to the Integrations tab, and finally to Third-party integrations.

Click on Eventbrite.

Enter the Private Token from your Eventbrite account, and click Save.

How to find the Private Token

Log into your Eventbrite account.

Click on your account avatar at the top right and go to Account Settings.

In the Developer Links menu, click on API Keys.

Click on Create API Key.

Fill out your info and click Create Key at the bottom.

Once your API Key is created, click on Show API key, client secret and tokens.

You will find your Private Token in the list that pops up.

Creating the Eventbrite event

The following is a quick guide on creating your Eventbrite event. For a detailed breakdown of all the various steps and settings in the event creation process, you can check out the official Eventbrite guide. If you decide to follow the steps there, when configuring the event make sure to select Online Event under Location, and Single Event under Date and time. Also, keep in mind that the video content should not be added to the Eventbrite event, since it is going to be injected via the InPlayer asset instead.

Before we start, an important thing to note is that the video content for the Eventbrite event will be injected via the InPlayer asset. This means that you should not add the protected video content in the Eventbrite event itself.

Log into your Eventbrite account.

In the header section of the page, click on Create an Event.

Fill out your event details.

When filling out the details, keep in mind the following:
Under Location, make sure to select Online Event.
Under Type of event, make sure to select Singe Event. The Recurring Events option is not supported.

When you’re done, click on Save & Continue.

Proceed to fill out the rest of the event details.

When you’re done, save the changes, and click on the Tickets tab from the left-hand menu.

Configure the ticket settings.

When you’re ready, click Save.

Make sure not to publish your event yet.

The next step is to create the InPlayer asset and connect it to the Eventbrite event.

Creating the InPlayer asset

Our platform supports many different types of assets. You can find guides on how to create them here, depending on your wishes.

When creating the asset, make sure to skip the Price options and Embedding the asset sections of the guides.

After creating your asset as per the guide, finish the setup by doing the following:

In the asset sections, click on Relate an Eventbrite event.

If your Eventbrite and InPlayer accounts have been properly connected in the first step of this guide, you should see your Eventbrite organization listed. Click on See events.

You will see a list of your Eventbrite events.

To connect your Eventbrite event with the InPlayer asset, turn the Relate event toggle on.

Click Save.

Go back to your Eventbrite event page, and on the left-hand side click on Online Event Page.

Scroll down and you will now notice the InPlayer module.
Here, you will need to add the App Secret Key from the Default OAuth App in your InPlayer Dashboard. If you don’t know your App Secret Key, click Find App Secret Key to go to the screen where you can get a new one.

Note that if you ever generate a new secret key for your default OAuth app, you will need to update your Eventbrite events with it.


In the InPlayer Dashboard, click on the Generate new… button.

Copy the key and paste it in the App Secret Key field in Eventbrite.

Click Save.

The final step is to publish your event.

To do this, go to Publish Event from the top menu, and click on Publish Now.

With that, you are all done.

Your Eventbrite event and InPlayer asset are connected.

Whenever a viewer purchases a ticket on your Eventbrite event, an account will be created in the InPlayer Dashboard and they will get access to the content. And the content they will see will be the one that you’ve set up in your InPlayer asset.

If access to the content is revoked or granted in the InPlayer Dashboard, the same thing will happen in Eventbrite as well.

Considerations

There are a few notable things to keep in mind for the InPlayer/Eventbrite integration.

First, the email that will be used for the InPlayer account will be the email that the viewer enters in the ticket info fields, and not in the Contact Information part at the top of the ticket purchasing screen.

If a viewer is buying multiple tickets, and thus they enter multiple emails in the ticket info fields, an InPlayer account will be generated for each of those emails.

Second, the created InPlayer account will not contain a password, which means that the viewer will not be able to log into the InPlayer paywall itself. They will only need to log into the Eventbrite platform.

Finally, if a viewer purchases a pass for an event, and then you change the event date in Eventbrite, the access period for the viewer in the InPlayer dashboard will not be changed accordingly. This means that access period changes will need to be done in the InPlayer platform, either manually, or via API.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Flowplayer

Posted on by inplayer_support

Connecting InPlayer and Flowplayer

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on Flowplayer.

Enter the Site ID from your Flowplayer account, and click Save.

How to find the Site ID

Log into your Flowplayer account.

You will find your Site ID in your workspace Settings screen.

The next screen will display the Site ID:

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

DaCast

Posted on by inplayer_support

Connecting InPlayer and DaCast

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on DaCast.

Enter the API Key from your DaCast account, and click Save.

How to find the API Key

Log into your DaCast account.

Click on Settings and then on Integrations.

If the API option is missing, you will need to contact DaCast’s support team and have them enable it for you.

Once available, you will find your API Key there.

If you don’t see it, just click Generate and a new API Key will be generated.

Once you connect your InPlayer and DaCast accounts, the next step is to protect your DaCast content by creating an asset.

Note that using the DaCast integration, you can only protect individual videos. You cannot protect a DaCast “Package”, i.e. a playlist of multiple videos created on the DaCast platform.
To do this, please use the HTML asset type, and put the embed code of the DaCast Package inside the Content section of the asset. You can learn how to do that here.
Alternatively, you can create a Package by using InPlayer’s own Package feature. Read more about that here.


If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Brightcove Gallery

Posted on by inplayer_support

Our monetization platform features a fully developed integration with Brightcove Gallery.

Before you start

To use the Brightcove Gallery integration successfully, please make sure that you have already connected your InPlayer and Brightcove accounts.
If you haven’t done this and are not sure how to go about doing it, make sure to read our guide.

Once both accounts are connected, you will need to create an InPlayer video asset for each of the videos you wish to include in your Brightcove Gallery Experience.
To learn how to do that, read our guides depending on the type of asset you want to have.

Important: Due to Brightcove Gallery limitations, if you apply Geo-restrictions on an InPlayer asset, the paywall for that video will not show up for users in restricted countries. They will be able to watch the video for free. The paywall will only show up for users from allowed countries. Therefore, always make sure you set up geo-restrictions for these videos directly in Brightcove as well, to make sure they are not freely available for users from restricted countries. Alternatively, you can set up a geo-restriction to only the asset price, and not the whole asset. This will make sure the paywall always shows up for everyone, but the price itself will only show up for viewers from allowed countries, while users from other counties will see a message that there are no price options available for them.


Brightcove Player setup

To start, you should first set up a Brightcove player with the InPlayer plugin.

To do this, follow the steps below.

Log into your Brightcove account and navigate to the Players section.

Create a new player or open an existing one.

Go to the Plugins section of the player.

Click Add a Plugin and select Custom Plugin.

Under Plugin Name, enter:

inplayerPaywall

Under  JavaScript URL, enter:

https://brightcove.inplayer.com/gallery/inplayer-plugin.js

If you are using an InPlayer demo account, use this URL instead:
https://demo.inplayer.com/client/inplayer-plugin.js


Under Options (JSON), enter the following code, modified with your InPlayer Account UUID :

{
"inplayerUUID": "INSERT YOUR INPLAYER UUID HERE",
"brandingId": "INSERT YOUR BRANDING ID HERE",
"language": "INSERT 2 LETTER LANGUAGE CODE HERE"
}

To find your UUID, just log into your InPlayer account, and go to Account Details.
To find your branding ID, go to Settings and then to Branding. The branding ID will be displayed on the branding theme.
To see a list of the 2 letter language codes that need to be used when filling out the language line, go to this page.

If you don’t wish to include the branding ID or the language line, you can delete it.
However, when deleting lines, make sure the last line before the final } of the code does not have a comma after it.

If you delete the line:
“language”: “INSERT 2 LETTER LANGUAGE CODE HERE”
the default language will be English.

Click Save to save the changes you’ve made, then Publish & Embed, and finally Publish Changes.

Brightcove Gallery Experience setup

Once you have set up your player, it is time to set up the Gallery Experience.

To do this, follow the steps below.

In your Brightcove account, navigate to the Gallery section.

Create a new Experience and open it.

From the left-hand menu, go to APPEARANCE AND BEHAVIOR and then to Custom.

Under Custom JavaScript URL, enter the following URLs:
For the V2 paywall: 

https://assets.inplayer.com/paywall/latest/paywall.min.js

For the V3 paywall:

https://assets.inplayer.com/paywall/v3/paywall.min.js

If you are using an InPlayer demo account, use these URLs instead:
For the V2 paywall: https://assets.inplayer.com/paywall/staging/paywall.min.js
For the V3 paywall: https://assets.inplayer.com/paywall/v3/staging/paywall.min.js


Click Save at the bottom of the page.

Next, go to the VIDEO AND PLAYBACK section, and then to Player and Lead Form.

Here, select Use site-specific player and choose the player that you’ve previously set up with the InPlayer paywall.

Click Save at the bottom of the page, and then click Publish at the top.

You can now add your videos and otherwise modify the Gallery.

Make sure to save and publish your Gallery every time you make a change to it.

Also, remember that you will need to create a separate asset in the InPlayer dashboard for every video you are going to add to the Gallery. Read our guides to learn how to do that.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Brightcove

Posted on by inplayer_support

Connecting InPlayer and Brightcove

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on Brightcove.

Enter the Client ID, Client Secret and Account ID from your Brightcove account, and click Save.

You will also notice the Private Key field. This is an optional field but it provides higher protection.

If you have mobile app or TV app integration, i.e. sell your assets via a mobile or a TV app, this is a mandatory field.

If you are going to embed the assets on a webpage only, the field is optional, but it does provide Brightcove’s Playback Authorization Service (PAS), which means higher security for your content. What it does is, it enables tokenisation, which signs your content with a one-time-use-only token, which means the content cannot be shared. We therefore strongly suggest that you take advantage of it.

How to find the Client ID, Client Secret and Account ID

Log into your Brightcove account.

Go to ADMIN.

Click on API Authentication.

Click on Register New Application.

Enter a Name and Description for the client registration.

Select one or more of your accounts for authorization.

Under Exposed Brightcove APIs, select the Read/Write from the Audience section and Video Read/Write from the CMS section.

Click Save.

The Client ID and Client Secret will be displayed.

Copy them and paste them in the InPlayer Dashboard.

Next, go to ADMIN and click on Account Information.

Here you can see your Account ID.

How to find the Private Key (optional)

First, make sure your Brightcove account has these two services enabled:

  • Playback Authorization Services
  • Dynamic Delivery

Contact your Account Manager at Brightcove for this.

Next, you need to create a Public and Private Key pair.
Brightcove already provides useful documentation and several examples on how to do this in this article.

Then, you need to create client credentials for Brightcove Video Cloud Key management.
To do so, you will need to log into your Brightcove account, and then get the BC_TOKEN that is saved in your browser’s cookies.

To get the BC_TOKEN, log into your Brightcove account using Google Chrome, right-click anywhere on the page, and click on Inspect to open the dev tools console.
In the console, go to the Applications tab, expand the entry Cookies, and click on http://studio.brightcove.com/
The BC_TOKEN will be displayed.

With the BC_TOKEN you can make another request to create the client credentials for Brightcove Key API management. To do that, use this call:

curl --location --request POST 'https://oauth.brightcove.com/v4/client_credentials' \
--header 'Authorization: BC_TOKEN ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type":"credential","maximum_scope":[
            {"identity":{"type":"video-cloud-account","account-id":replace_with_account_ID},
                "operations":
                    ["video-cloud/playback-auth/key/read","video-cloud/playback-auth/key/write"]
            }
                        ],
                        "name":"PAS Creds","description":"App for PAS"
                        }'

Save the Client ID and the Secret Key that are returned from the call.

Next, you need to create the Access Token you will use to register your Public Key in the Brightcove platform.
The Access Token can be generated with the below request, where your Client ID and Client Secret are passed as the username:password in a basic Authorization header.

curl --location --request POST 'https://oauth.brightcove.com/v4/access_token' \
--header 'Authorization: Basic {client_id}:{client_secret} ' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials'

Save the Access Token that is returned from the call.

Please note that the Access Token is valid for one subsequent request. Make sure to generate it prior to creating a new public key.


Using the Access Token you can now register your Public Key with Brightcove. To do that, use this call:

curl --location --request POST 'https://playback-auth.api.brightcove.com/v1/accounts/79364953001/keys' \
--header 'Authorization: Bearer {Access Token}' \
--header 'Content-Type: application/json' \
--data-raw '{"value":"Your Public Key Value"}'

The last step is to enter the Private Key in the InPlayer Dashboard, in the Private Key field of the Brightcove Integration section.

It is very important to note that only videos that have Dynamic Delivery enabled can be protected by this method.


An easy way to check whether a video has Dynamic Delivery is to look at the video icon in the Video list in Brightcove. The videos with a green cloud have Dynamic Delivery and the ones with a grey cloud do not.

Media Module Video List

Once your Brightcove account manager enables the Dynamic Delivery feature, it can be used for newly uploaded videos or for videos that have already been uploaded.

To enable Dynamic Delivery on a new video, make sure to select an Ingest Profile listed under DYNAMIC DELIVERY, during the uploading process.

You can choose between 4 Dynamic Delivery ingest profiles:

  • Multiplatform Extended (7 Renditions)
  • Multiplatform Standard with MP4 (7 Renditions)
  • Multiplatform Standard (6 Renditions)
  • Multiplatform Extended with MP4 (8 Renditions)

To enable Dynamic Delivery on an already uploaded video, open the video, scroll down to the VIDEO FILES section on the left, and click Restranscode.

Select one of the Dynamic Delivery ingest profiles.
You will notice that the profiles here are not divided as Dynamic Delivery and Legacy as when you upload a new video, but the Dynamic Delivery ones are easy to spot since they will always start with the word Multiplatform, and will be the same 4 that are mentioned above.

Click Restranscode to start the re-transcoding process.

As soon as the process finishes, the video will have Dynamic Delivery. Until it does, it will still be playable, but as a non-Dynamic Delivery video.

Once you set everything up, the next step is to protect your Brightcove content by creating an InPlayer asset.

You can learn how to do that here.

Once you create your assets, you can use them individually, or as a part of a Brightcove Gallery.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Amazon IVS

Posted on by inplayer_support

Introduction

Amazon Interactive Video Service (Amazon IVS) is a managed live streaming solution that is quick and easy to set up, and ideal for creating live interactive video experiences. You can learn all about it here.

Our platform supports integration with IVS which makes using it very convenient.

Let’s see how everything works.

Note that IVS can only be used for live streams and not for VODs.

Before you start

To complete the Amazon IVS integration, an IAM role must be created that will allow the service role to access IVS resources.
This is most easily accomplished by using a cloudformation stack.
The stack will create a role named InPlayerIVSIntegrationRole under your AWS account. You can rename the role if you wish.

Resources:
#Create an IAM role that will allow our IAM role to assume it
  InplayerIVSRole:
    Type: 'AWS::IAM::Role'
    Properties:
      RoleName: InPlayerIVSIntegrationRole
      AssumeRolePolicyDocument:
        Version: 2012-10-17
        Statement:
          - Effect: Allow
            Principal:
              AWS:
                - >-
                  arn:aws:iam::299695708834:role/InPlayerIVSIntegrationRole
            Action:
              - 'sts:AssumeRole'
#Create a Policy that will enable the role to access IVS resources
  InplayerIVSPolicy:
    Type: 'AWS::IAM::Policy'
    Properties:
      PolicyName: InPlayerIVSIntegrationPolicy
      PolicyDocument:
        Version: 2012-10-17
        Statement:
          - Effect: Allow
            Action: 'ivs:*'
            Resource: '*'
      Roles:
        - !Ref IVSRole

For your convenience, we have created the following links which you can click to log into your AWS console and run the above code automatically, depending on which InPlayer environment you are using (Staging vs Production):

Staging link

Production link

After creating the stack, the Role ARN can be found on this link.

Open the role, copy the ARN and write it down somewhere.

The ARN will have the following format:

arn:aws:iam::AWS_ACCOUNT_ID:role/InPlayerIVSIntegrationRole

You’ll also need the Private Key.

For this, go to this link and select the region.

Next, click on Playback keys and then click Create playback key. This will generate the private key. The key will be downloaded to your computer.

Protip: The search bar doesn’t support partial search, so after creating the key, if you need to search for it, make sure you use the full name.

Connecting InPlayer and IVS

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on the icon with the Amazon IVS logo.

Enter the Role ARN and Private Key from your Amazon IVS account, and click Save. For the Key, make sure to paste everything from the file that was downloaded previously, including the BEGIN and END tags.

The point of the Role ARN in the InPlayer integration is to enable you to list, create, and delete channels. And the point of the Private key is to enable the showing of the live stream behind the paywall for the viewers.

Your IVS account is now paired with your InPlayer account, and you are ready to create your first IVS asset.

You can learn how to do that here.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Amazon CloudFront

Posted on by inplayer_support

Introduction

Using the Amazon CloudFront integration, you can quickly and easily protect and monetize your content that is being processed through AWS Elemental and delivered through CloudFront.
All you need to do is insert the CloudFront URL of your content into your CloudFront InPlayer asset, and embed the asset on your webpage.
Using our CloudFront integration is a very secure way of protecting your online content, because our platform makes it impossible for users to share the content once they access it through the paywall.

Let’s take a look at how everything works.

Before you start

Before you can connect your CloudFront and InPlayer accounts, you will need two things:

  • CloudFront Key-Pair ID
  • Private Key

You will also need to make sure that your CloudFront distribution has been set as Private so that your files aren’t directly accessible.

To get the CloudFront Key-Pair ID and the Private Key, just follow these steps:

  1. Log into your AWS account.
  2. On your IAM dashboard, click Security Credentials.
  3. You may receive a message giving you the options to either Continue to security credentials or Get started with IAM Users. Select Continue to security credentials (you can check the option to prevent this pop up from coming up in the future).
  4. Scroll down to Cloudfront Key Pairs.
  5. Check that you have no more than one active key pair. You can’t create a key pair if you already have two active key pairs.
  6. Click Create New Key Pair.
  7. In the Create Key Pair dialog box, click Download Private Key File.
    Important! Save the private key for your CloudFront key pair in a secure location. If someone gets your private key, they can generate valid signed URLs and signed cookies and download your content. You cannot get the private key again, so if you lose or delete it, you must create a new CloudFront key pair.
  8. Close the dialog box.
  9. Scroll up to Access Keys.
  10. Click on Create new access Key.
  11. Click Download Key File (this will come in a .csv format. Note that you can also click on Show above Secret Access Key and then copy the displayed key, and save it in a text file.
  12. This is your CloudFront Key-Pair ID.

For more info, you can visit this page.

Once you have your CloudFront key, you are ready to connect your CloudFront and InPlayer accounts.

Connecting InPlayer and CloudFront

First, log into your InPlayer Dashboard.

Go to Settings, and then to the Integrations tab.

Click on Amazon CloudFront.

Enter the CloudFront Key-Pair ID and Private Key from your Amazon CloudFront account, and click Save.

Your CloudFront account is now paired with your InPlayer account, and you are ready to create your first CloudFront asset.

You can learn how to do that here.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Custom register fields

Posted on by inplayer_support

Custom register fields are additional fields on the paywall’s registration form. They can be used to gather all kinds of metadata from your audience. These details will help you discover, identify and describe your viewer, and understand their connection and feelings about your product or service.

For each of the custom register fields, you can set up whether they are going to be required or non-required.

You will find the Custom register fields feature in the Authentication tab of the Dashboard settings.

Adding custom register fields

To add a custom field, click Add custom field.

There are several different types of custom fields.

Text field

The text input field is where your viewers can type in text.

  • Database label – This is the name of the field which is stored in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _. Note that there is a 20 character limit.
  • Paywall label – Here you can type in a short description that will tell the viewers what they should enter in the field.
  • Default value – This is going to be the default text in the field. You can leave this blank.

The dropdown menu field lets you add a drop-down menu to the registration form.

  • Database label – This is the name of the field which is stored in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _. Note that there is a 20 character limit.
  • Paywall label – Here you can type in a short description for the field.
  • Dropdown menu entries – This is where you add the drop-down menu entries.
    • Database label – This is the title of the entry that will be written in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _.
    • Paywall label – This is the title of the entry that will appear on the paywall, and what your viewers will actually see.

Once you set up an entry, make sure to click the + button on the right of it to save it.
You can add up to 30 entries.

Radio button

The radio button field lets you add a set of multiple options from which the viewer will have to select only one.

  • Database label – This is the name of the field which is stored in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _. Note that there is a 20 character limit.
  • Paywall label – Here you can type in the description or title of the field that your viewers will see.
  • Radio button entries – This is where you add the multiple options.
    • Database label – This is the title of the option that will be written in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _.
    • Paywall label – This is the title of the option that will appear on the paywall, and what your viewers will actually see.

Once you set up an option, make sure to click the + button on the right of it to save it.

Checkbox

The checkbox field lets you add a checkbox.

  • Database label – This is the name of the field which is stored in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _. Note that there is a 20 character limit.
  • Paywall label – Here you can type in the description or title of the field that your viewers will see.
  • Default value – Set whether the field will be checked or unchecked by default.

A very useful feature of the Checkbox custom register field is that you can add a hyperlink to the Paywall label text.
To do this, select the text you want to hyperlink to and click  .

When getting an audience report, the values for a checkbox field will be one of the following:
blank – viewer did not check the checkbox field on registration and has never checked it since,
on – viewer currently has the checkbox field checked,
off – viewer had the checkbox field checked, but they have currently unchecked it.

Country list

With the country list, your viewers can select their country.

  • Paywall label – Here you can type in a short description for the field.

Date picker

This will include a date picker field.

  • Database label – This is the name of the field which is stored in the database. Your viewers will not see this. Make sure not to include any blank spaces or special characters, except _. Note that there is a 20 character limit.
  • Paywall label – Here you can type in the description or title of the field that your viewers will see.

Modifying custom register fields

Once created, the custom fields can always be modified.
To do this, just open the field you wish to edit by clicking on the  button next to it.

Removing a custom field

To remove a custom field, just open it, and click the Delete field button.

Getting the metadata from the custom fields

The viewer metadata gathered from the custom fields can be accessed and exported at any time

To do this, go to the Audience tab of your InPlayer Dashboard.

To get the viewers’ metadata, click on the  button on the right, under the Edit column in the viewer’s row.

In the METADATA section, you can see the metadata that was gathered from the viewer upon registration.

Additionally, if you want to export the data for a report, you can always do so by clicking on Generate report in the Audience tab.

Here, in Select report columns, you can select all the fields you wish to include in your report, along with the timeframe for it.

Then click Generate.

To view the report, click on View reports.

From there you can download the report as a CSV file and use it in any way you wish.

This concludes our guide.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

Age restrictions

Posted on by inplayer_support

Age restrictions give you a way to restrict access to your content based on age.

The feature is not enabled by default, but if you want to use it, just send us an email at clients@inplayer.com and we will enable it for you.

When a viewer tries to purchase an asset that has been age-restricted, they will have to confirm their date of birth.

If their age is less than the one set up in the InPlayer Dashboard, they will not be granted access.

You can set up a global age restriction that affects your entire content, or an asset-specific age restriction, which affects a single asset. Note that the asset-specific restrictions will always override the global restrictions.

You will find the Age restrictions feature in the Authentication tab of the Dashboard settings.

Setting up a global age restriction

The age restriction you set up in the Age restrictions tab of the Settings is going to be the global restriction, and will affect your entire content, i.e. all of your assets.

To do this, select the minimum age from the drop-down menu.

Then click Save.

Removing a global age restriction

To remove the global age restrictions on your account, go back to Age restrictions tab of the Settings, click Delete and then Yes, delete!.

Setting up an asset-specific age restriction

An asset-specific age restriction will affect only a single asset.

You can set it up in the asset’s settings.

To do this, open the asset from the Content tab, go the Restrictions section, and under Age restrictions select a minimum age.

Make sure to click the Save button in the bottom right corner.

Removing an asset-specific age restriction

To remove an asset-specific age restriction, you would need to revert the restrictions for that asset to default. Note that this will remove all restrictions from that asset, including Geo- and URL restrictions. If you had any Geo- or URL restrictions set up for that asset, you will have to set them up again after reverting to default.

To revert the restrictions to default, open the asset from the Content tab, go to the Restrictions section, scroll down and click Reset to default.

Viewer experience

When a viewer tries to purchase an asset that is age-restricted, they will first need to enter their date of birth.

Upon entering their age, they will receive an email with a PIN number.

They will need to enter this PIN on the next screen on the paywall.

They will be able to use the same PIN each time they log in, but they can also get a new one, in case they lose or forget it.

When they enter their PIN, if their age is equal or greater than the one set up in the age restriction settings, they will be able to purchase the asset and watch the content.

The PIN enables the viewer to watch for one hour. After the hour is up, the PIN window will appear again and the viewer will need to enter it again so they can continue watching.

If the viewer’s age is lower than the one set up in the age restriction settings, they will be shown a message informing them that they won’t be able to watch the content due to their age.

This concludes our guide.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.

URL restrictions

Posted on by inplayer_support

Similar to the geo-restrictions, with URL restrictions you can limit the availability of your content based on a webpage.

This means that your assets will only be embeddable on webpages specified by you.

You can set up a default URL restriction that affects your entire content, or an asset-specific URL restriction, which affects a single asset. Note that the asset-specific restrictions will always override the default restrictions.

You will find the URL restrictions feature in the Authentication tab of the Dashboard settings.

Setting up a default URL restriction

The domain you set up in the URL restrictions tab of the Settings is going to be the default restriction, and will affect your entire content, i.e. all of your assets.

To do this, click on Add a URL.

Enter your URL and click Save.

Make sure to add the exact page URL where your asset is going to be embedded, and that you do not add a / at the end of the URL, nor any other special characters.

If you ever wish to remove a webpage, just click the  button next to it.

Setting up an asset-specific URL restriction

An asset-specific URL restriction will affect only a single asset.

You can set it up in the asset’s settings.

To do this, open the asset, go the Restrictions section, and under URL restrictions, click Add a URL and enter the domain.

Make sure to add the exact page URL where your asset is going to be embedded, and that you do not add a / at the end of the URL, nor any other special characters.

This concludes our guide.

If you have any questions, don’t hesitate to contact us at clients@inplayer.com.