Integrating SAP Sports One with Third Party Applications

SAP Sports One is the ultimate platform for integrating data from third party providers, ensuring a smooth and efficient data flow. By default, SAP Sports One comes with Heimspiel as the primary master data provider, automatically delivering updates for your teams and matches. You can choose to receive Heimspiel data in either English or German. Beyond Heimspiel, SAP Sports One also supports data imports from other providers, including Ligen, Skillcorner, Impect, and more.

To connect to your third party data providers, go to Admin → Providers Configuration and go to the area for your third-party data provider. Enter your account details (user and password or connection token) and then check that the connection is working by clicking on Test Connection. For more details on your connection credentials, please contact the provider directly.

Additionally, you can use Impect match data in several areas to analyze matches and players. Typically, the Impect data is mapped automatically to the matches in SAP Sports One. But if the automatic mapping fails, you can map the Impect data manually.

To do so, please go to Admin → Provider Configuration → Impect. Here you can find the Impect data that you want to map by selecting the Impect season, country and competition. The number in brackets shows you how many unmapped matches there are.

In the Competition Mapping section, select the matching country and competition in SAP Sports One. In the Team Mapping section, select the matching teams in SAP Sports One. In the Match Mapping section, check which matches SAP Sports One mapped.

In SAP Sports One your videos are stored on Amazon Web Services (AWS). AWS provides a reliable and cost-effective storage solution, the AWS media storage called Amazon S3.

You integrate SAP Sports One with AWS to use the following services:

1. Data Storage: for the upload, storage, and consumption of videos in SAP Sports One, and in the SAP Challenger Insights and the SAP Team One mobile apps.
2. Media Services: for the encoding and cutting of your video content in SAP Sports One.

If your club or association doesn’t have an AWS account, create one now by going to the AWS website

Creating a setup user generates the details needed for connecting AWS and SAP Sports One together in an upcoming step. The user also lets SAP complete actions on your behalf. More information on how to create a setup user, can be found on the SAP Help Portal. After creating the user it’s time to open the SAP Sports One web app so that you can connect AWS and SAP Sports One.

To connect SAP Sports One with AWS, you need to enter your AWS access keys and select a data center. In the SAP Sports One web app, go to Admin → Providers → AWS Media Storage and click Start Setup. Afterward, enter your access keys in the Enter Your AWS Account Details dialog. The Region drop down menu lets you decide in which AWS data center your videos are stored. Select the region that is closest to you. Then click Save.

Wait a few minutes and then click Test Connection to make sure SAP Sports One and AWS are connected. Let's now activate video storage on AWS so that new video uploaded to SAP Sports One is stored on AWS. If you left, go back to the AWS Media Storage settings. Click Activate AWS Storage.

When the integration with AWS is fully completed, we recommend that you delete the setup user that you created in AWS because the user has powerful permissions that are no longer needed. More information on how to delete the user on the SAP Help Portal.

For more information on the Setup User's Permissions as well as for Calculating AWS Costs, please have a look at the SAP Help Portal.

After completing the AWS setup, you can also manage the Video Quality and Encoding Preferences. To do so, click on Edit. The settings let you pick the video quality offered to viewers when streaming. Please note, that the choice affects your AWS storage because high quality videos require more space. We recommend that you encode all MP4 files and that you choose either 720p or 1080p for the video quality. This approach makes sure that all videos can be played on all devices. It also offers a good compromise between good streaming experience, high video quality, and reduced storage and encoding costs.

Additionally, you have three encoding options for uploaded MP4 files. The system always converts other formats, such as .mov, to the standard MP4 format. Remember that AWS charges a fee for converting each video:

1. Encode all - Convert all uploaded MP4 files to the standard MP4 file format. Your video quality settings define the quality of the converted videos.
2. Ignore small - Only convert medium and large MP4 files to the standard MP4 file format. Your video quality settings define the quality of the converted videos.
3. No encoding - Select this option if you’re sure that the MP4 files uploaded by everybody can be played on all devices. The files are stored in the quality that they were recorded in.

More information on the video quality and the encoding preferences on the SAP Help Portal

The SAP Sports One API library allows you to export data from SAP Sports One. You can use this data outside of SAP Sports One, such as for data scientists or during the decommission process to retain certain data after terminating your SAP Sports One license. To export data, you need to request SAP to activate the API library for your SAP Sports One tenant. Get in touch with your SAP contact person to request activation.

Before you can start, you need theAPI Administrator role assigned to your SAP Sports One user. With this role, you can create and manage technical API users. Please make also sure, that you have created an email address to use with the technical API user that you will set up in the following steps. Example: apiuser@sapunited.com

Once you have the role of API Administrator, you can start to set up API users. To do so, go to Admin → Technical API Users and click on Create Technical API User. Enter all relevant API user information. Please use the generic email address that you created previously. Afterwards, please click on Save.

By clicking on the three dots beside of the created user, you can define permissions for the API user. By selecting the permissions, choose the relevant API endpoints that the technical API user can use. Choose Save. An account activation email is sent to the newly created technical API user. They must log in and set a password as normal user, too.

In the next step, we want to show you how to test the data export by using the integrated Swagger UI. Log in to SAP Sports One with the technical API user created before. After log in, you can also access the API documentation by using the Switch Apps menu (top right) or by clicking the API Documentation button in the Technical API User section.

In the API Documentation, please select the API you want to test to access the Swagger UI.

In the Swagger UI, you can select various parameters to influence the API response. Click Try it Out and Execute, then enter the technical API user's email address and password. You are now able to test and see the results.