top

Application Registration

Samsung Smart TV Ecosystem launches your applications after Samsung's QA testing/verification and your certification if required. This guide explains the application registration process.

Overview

When registering a new application, only Tizen app can be registered. Tizen applications are available to be submitted on 2015 and later TV model groups.

Since 28th Feb, 2018, Seller Office will support you can submit and launch the Tizen .Net application for Samsung Smart TV. Tizen .Net applications are available to be submitted on 2018 and later TV model groups.

Important

Restricted Submission

If you have an Samsung Legacy Platform application launched on 2015 devices and you proceed to version up with a Tizen platform application on that App ID, then you will no longer be able to update the Samsung Legacy Platform application version. You will need to proceed with the Tizen submission from that point forward.

Figure 1. Application Registration Process

Figure 1. Application Registration Process

Web App Registration Process

Preparation

Before registering application at the Seller Office, the following materials should be prepared. Please refer to the detailed specifications for each item.

  • Application icons
  • Application screenshots
  • Application description file
  • Application source package

Basic Information

You should input the basic information to be registered.

Table 1. Application Basic Information
Input Field Updatable Input Field Updatable
App ID No App Name for manage No
Category Yes
(Except for QA testing)
Rating Yes
Language Yes Privacy Policy Yes
Country Yes
(Except for QA testing and submitted)
Rating Certification Yes
App Title Yes
(Except for QA testing)
App Description Yes
Icon Images Yes
(Except for QA testing)
Screenshots Yes
Seller Information Yes

The below is the explanation about what to be registered at Basic Information registration step.

1. Generating a new App ID with App Name

App ID is a unique application identifier throughout the whole certification process. In order to generate a new App ID, enter the application name and check for its availability. An app cannot have the same name as another application registered by a different Seller. If the name is available, you can create a new App ID under this name.

Important

  • "Application Name (App Name)" and "App ID" are used for the identifiers of an application. Seller cannot change any of them after creation.
  • App ID in Seller Office should not be confused with Tizen ID in application package. More information on this topic is available in chapter ‘Tizen ID’.
  • "App Name" is different from "App Title" which will be displayed on TV screen.

Figure 2. Generate new application ID

Figure 2. Generate new application ID

2. Entering Basic Information

After creating a new App ID, enter the general information and upload required metadata. The metadata will be displayed in Samsung Smart TV's Apps page.

The following table explains the details for each field.

Table 2. Basic Information Input Fields
Input Field Description Displayed on TV
Category One of the following: Videos, Game, Sports, Lifestyle, Information, Education Yes
Rating Age rating of the content. In some countries additional rating certificate may be necessary.
If you set age rating as 18+, your application cannot be launched at Korea. For more details, refer to Age Rating.
Yes
Language You need to register your application service languages as which your application is served to users when execution. Yes
Privacy Policy If you collect privacy data via your application, your Privacy Policy URL should be registered. The URL information shall be explained on Smart TV. Yes
Country Countries specified in your contract with Samsung. If you are public seller and public group, you can launch your service only in United States. No
Rating Certification If you are issued a Rating Certification, you must register the certification. To serve Brazil, upload MY/DEJUS certificates or select an age rate. No
App Title and Description You need to register these information for all the languages supported on TV settings. Yes
Icons and Screenshots These data will be used when your application is displayed on TV. Yes
Seller Information Seller name, Support email, Homepage, Representative, Phone number, Address
※ If the seller who registers application is already joined a group, the group's seller information will be set as default information, but the information can be changed.
Yes
Note

  • The basic information can be changed later with "Modify App Info" button.
  • The uploaded screenshots will be displayed at TV same as the uploaded order. By drag & drop, you can change the order of screenshots and the change will be applied on TV.
Important

The default language of Tizen application title MUST be same with the app title in its application source. Otherwise Pre-Test will be failed during version-up.

3. Basic Information Completion

When you enter all of the fields, proceed to the next step with clicking the "Next" button.

Test Information

At this step, sellers should enter special feature information supported by the seller application. This information is used by Samsung Smart TV certification team.

1. Selecting Target Model Groups

At first, choose the target model groups where you would like to launch your application. If you want to submit a Tizen application, you are limited to select 2015 TV models or later only.

Figure 3. Select Target Model Groups

Figure 3. Select Target Model Groups

Note

  • If your application supports Samsung Checkout, you cannot select the model groups which don't support Samsung Checkout.
  • If your application supports Smart View SDK, you should select at least one model group which supports Smart View SDK. Including Smart View SDK supporting model group, you are available to select more model groups regardless Smart View SDK support.

2. Selecting Release Request Date

In this step you can choose the application's launching timing since the certification.

  • Normal Release
    Means that application is released as soon as passed in certification.

  • Scheduled Release
    Means that application is released on the requested date even the application has been certificated before the date. Of course application cannot be released if its verification is not completed before that date.

The sellers usually choose the manual release when they want to promote their application on that day.

Figure 4. Release Date Registration

Figure 4. Release Date Registration

3. Entering Detailed Test Information

Table 3. Test Information Input Fields
Input Field Description
App Feature Check if Samsung Smart TV features implemented in the application.
Caption Information about video subtitles (if applicable).
TTS (Text to Speech) Check if your application supports TTS.
In-app AD Check if your application is connected an advertising platform to monetize. In-app AD app should define the relevant privilege API in "config.xml" file and you are required to confirm the information of Advertising Indentifier.
Billing Check if your application uses any billing features. 1) If the application use embedded billing function in Samsung Smart TV, select "Samsung Checkout". For this feature, the relevant privilege APIs should be definded in "config.xml" and you are required to register "Bank Account Information". 2) If use partner's own billing function, select "3rd Party Billing". 3) If the application don't have a billing function, select "Free".
Player Specification Check the details of your video streaming solutions. This can be helpful for investigating any issues related to video playback.
App Description File Basic app documentation, to help testers understand app workflow and user scenarios. The document template can be downloaded from here.
Note for Tester Change log since the previous app version, any other information that can be useful for testers.
Geo IP Block Geo-filtering used for application content. If applicable, make sure that all IP addresses used by Samsung testers are whitelisted on your servers.
Test Account/Password, Voucher Code Test account with enough credit to check the whole application in detail on all requested platforms.
Important

  • Missing information in App Description File, Test account or Geo IP may result in rejecting your application from certification process. Check these items carefully and make sure provided information is enough to fully test your app.
  • Apps that support In-app AD must be updated by to use the relevant API’s. And apps that support Samsung Checkout must be updated by to use the relevant API’s. Otherwise, the app will be failed while performing the pre-test.
  • App service that 3rd party billing has been applied may be available for a limited time and it may be terminated without further notice.

4. Test Information Completion

After you enter all of the fields, proceed to the next step with clicking the "Next" button. If you skip some of the mandatory fields or complete them with incorrect value, it will be impossible to proceed.

App Upload & Pre-Test

You can perform Pre-Test before the actual certification process using the automation test tool provided by Samsung. With this Pre-Test process, Samsung supports that sellers detect critical defects before complete application submission. The Pre-Test result will be shown on screen immediately.

1. Uploading Application Package

You should submit your application package at this step.

2. Pre-Testing

Right after an application package has been uploaded, the Seller Office's Pre-Test tool will validate the uploaded application package automatically. After Pre-Test, whether the Pre-Test is passed or failed is reported on screen immediately.

Note

Some data about the application will be extracted from the config.xml for intenal back end application management purposes.

The following table shows the Pre-Test checklist for seller applications to meet.

  
Table 4. Pre-testing Criteria for Tizen Web App
Criteria Check Item
*.wgt If the file name does not contain any special characters except for “_”.
If the file name is less than or equal to 100 bytes.
If the file can be unzipped.
config.xml If "config.xml" file exists.
If there are "Tizen ID", "App Version", "API Version", "App Title" and features information.
If other application has the same "Tizen ID".
If the format of "App Version" is valid. (255.255.65535)
If "API Version (Required Version) " format is valid. (x.y)
If "API Version (Required Version) " is not higher than Max API required version for target model groups.
If "App Title" is same with the app title for default language in metadata.
If the Screen Size is specified.
If Hosted-Web App tag is used with proper authorization.
If privilege APIs are used with proper authorization.
If the permitted APIs are used.
If ADinfo privilege API is used with in-app AD feature.
If SmartController Microphone privilege API are used with proper authorization.
If the privilege APIs related with Samsung Checkout is used with Samsung Checkout feature.
If Ticker tag is not used. There are some exceptions.
If Smart Hub Preview tags are used with proper rules.
If there is an endpoint URL information as the value of Smart Hub Preview.
If No Display tag is used with proper authorization.
If the value of Install Location tag is auto.
If the value of Background Support tag is used with proper authorization.
If Linked Device tags are used with proper rules.
If target model groups for app used HBB TV Link tag is 2016 and later TV model groups.
If Provider ID tags are used with proper rules.
If TV Key Config tag is used with proper authorization and there is a value of TV Key.
If Required Services tag is used with a value of name and min-version.
author-signature.xml If "author-signature.xml" file does exist.
If "author-signature.xml" file is valid.
signature1.xml If "signature1.xml" file does exist.
Important

  • If the last version number of application is already higher than 255, you cannot update it for Tizen. You need to register the application package again with a new App ID.
  • If the Pre-Test is failed, you cannot proceed to the next step. In such a case, after review and fix all problems, please resubmit the application package.
  • The Pre-Test check list for Samsung Legacy Platform SDK is different from Tizen's ones.

3. Pre-Test Completion

If your application is passed at Pre-Test step, you are almost ready to submit. To confirm the registered information, please proceed to the next step, "Preview". Click the "Next" button.

Preview

After Pre-Test step, a summary of all submitted information will be shown on screen, which is preview step. You are expected to review all of the form fields and correct where necessary. If those inputs are right, click the "Next" button to go to the submit step.

Submit

The Submit step is the final process of Application Registration. In this step, you need to consent two kinds of agreement.

1. Agreements

  • Release agreement
    If application release is available even there may be some minor defects

  • Code sharing agreement
    If the registered code is available to be shared with the same group members

If you agree with the release with minor defects, Samsung may release your application without your confirmation even there are some minor defects. However Samsung will not release any application with critical defects.

Figure 5. Check Agreements before Submission

Figure 5. Check Agreements before Submission

2. Submit Completion

If you click the "Submit" button, the application registration process is done.

After registration process, your application will be put to certification process. You can check the certification status of the application at "Seller Office" > "Applications" > "Management". For more details, refer to Application Certification.

.Net App Registration Process

Preparation

Before registering application at the Seller Office, the following materials should be prepared. Please refer to the detailed specifications for each item.

  • Application icons
  • Application screenshots
  • Application source package
  • Application description file

Basic Information

You should input the basic information to be registered.

Table 1. Application Basic Information
Input Field Updatable Input Field Updatable
App ID No App Name for manage No
Category Yes
(Except for QA testing)
Rating Yes
Language Yes Privacy Policy Yes
Country Yes
(Except for QA testing and submitted)
Rating Certification Yes
App Title Yes
(Except for QA testing)
App Description Yes
Icon Images Yes
(Except for QA testing)
Screenshots Yes
Seller Information Yes

The below is the explanation about what to be registered at Basic Information registration step.

1. Generating a new App ID with App Name

App ID is a unique application identifier throughout the whole certification process. In order to generate a new App ID, enter the application name and check for its availability. An app cannot have the same name as another application registered by a different Seller. If the name is available, you can create a new App ID under this name.

Important

  • "Application Name (App Name)" and "App ID" are used for the identifiers of an application. Seller cannot change any of them after creation.
  • App ID in Seller Office should not be confused with Tizen ID in application package. More information on this topic is available in chapter ‘Tizen ID’.
  • "App Name" is different from "App Title" which will be displayed on TV screen.

Figure 6. Generate new application ID

Figure 6. Generate new application ID

2. Entering Basic Information

After creating a new App ID, enter the general information and upload required metadata. The metadata will be displayed in Samsung Smart TV's Apps page.

The following table explains the details for each field.

Table 2. Basic Information Input Fields
Input Field Description Displayed on TV
Category One of the following: Videos, Game, Sports, Lifestyle, Information, Education Yes
Rating Age rating of the content. In some countries additional rating certificate may be necessary.
If you set age rating as 18+, your application cannot be launched at Korea. For more details, refer to Age Rating.
Yes
Language You need to register your application service languages as which your application is served to users when execution. Yes
Privacy Policy If you collect privacy data via your application, your Privacy Policy URL should be registered. The URL information shall be explained on Smart TV. Yes
Country Countries specified in your contract with Samsung. If you are public seller and public group, you can launch your service only in United States. No
Rating Certification If you are issued a Rating Certification, you must register the certification. To serve Brazil, upload MY/DEJUS certificates or select an age rate. No
App Title and Description You need to register these information for all the languages supported on TV settings. Yes
Icons and Screenshots These data will be used when your application is displayed on TV. Yes
Seller Information Seller name, Support email, Homepage, Representative, Phone number, Address
※ If the seller who registers application is already joined a group, the group's seller information will be set as default information, but the information can be changed.
Yes
Note

  • The basic information can be changed later with "Modify App Info" button.
  • The uploaded screenshots will be displayed at TV same as the uploaded order. By drag & drop, you can change the order of screenshots and the change will be applied on TV.
Important

The default language of Tizen application title MUST be same with the app title in its application source. Otherwise Pre-Test will be failed during version-up.

3. Basic Information Completion

When you enter all of the fields, proceed to the next step with clicking the "Next" button.

App Upload & Pre-Test

You can perform Pre-Test before the actual certification process using the automation test tool provided by Samsung. With this Pre-Test process, Samsung supports that sellers detect critical defects before complete application submission. The Pre-Test result will be shown on screen immediately.

1. Uploading Application Package

You should submit your application package at this step.

2. Pre-Testing

Right after an application package has been uploaded, the Seller Office's Pre-Test tool will validate the uploaded application package automatically. After Pre-Test, whether the Pre-Test is passed or failed is reported on screen immediately.

Note

Some data about the application will be extracted from the tizen-manifest.xml for intenal back end application management purposes.

The following table shows the Pre-Test checklist for seller applications to meet.

Table 5. Pre-testing Criteria for Tizen .Net App
Criteria Check Item
*.tpk If the file name does not contain any special characters except for “_”.
If the file name is less than or equal to 100 bytes.
If the file can be unzipped.
tizen-manifest.xml If "tizen-manifest.xml" file exists.
If there are "Tizen ID", "App Version", "App Title" and features information.
If other application has the same "Tizen ID".
If the format of "App Version" is valid. (255.255.65535)
If "App Title" is same with the app title for default language in metadata.
If the Screen Size is specified.
If privilege APIs are used with proper authorization.
If the permitted APIs are used.
If SmartController Microphone privilege API are used with proper authorization.
If Smart Hub Preview tags are used with proper rules.
If there is an endpoint URL information as the value of Smart Hub Preview.
If Display Hidden tag is used with proper authorization.
If the value of Pre-launch Support tag is used with proper authorization.
If the value of Background Support tag is used with proper authorization.
If Required Package tags are used with proper authorization and proper rules.
If TV Info tags are used with proper rules.
If Application Type tag is used with proper authorization and proper rules.
If the value of Auto-restart tag or On-boot tag is false.
If Provider ID tags are used with proper rules.
If Required Services tag is used with a value of name and min-version.
If Background Update tag is used with a value.
author-signature.xml If "author-signature.xml" file does exist.
If "author-signature.xml" file is valid.
signature1.xml If "signature1.xml" file does exist.
Important

  • If the last version number of application is already higher than 255, you cannot update it for Tizen. You need to register the application package again with a new App ID.
  • If the Pre-Test is failed, you cannot proceed to the next step. In such a case, after review and fix all problems, please resubmit the application package.

3. Pre-Test Completion

When your application is passed at Pre-Test step, proceed to the next step with clicking the "Next" button.

Test Information

At this step, sellers should enter special feature information supported by the seller application and define the certification test information.

Based on the selected features and the application “tizen-manifest.xml” file, we lists the TV model groups that support your application.

1. Checking App's Features

At first, check if Samsung Smart TV features implemented in the application.

Table 6. Additional Features
Feature Description
Smart View Check if your application supports to mobile App developed through ‘Samsung SmartView SDK’.
Mobile Device Check if your application works with mobile device. If supported, you need to attach a mobile App.
In-app AD Check if your application is connected an advertising platform to monetize. In-app AD app should define the relevant privilege API in "tizen-manifest.xml" file and you are required to confirm the information of Advertising Indentifier.
Caption Check if your application supports Caption, If supported, you need to input information about video subtitles.
TTS(Text to Speech) Check if your application supports TTS.
Overlay Check if the application supports Overlay.
HDR Check if the application supports 'High Dynamic Range'.
External Devices Check if your application use external devices such as USB, camera, microphone, select this feature, and please describe all external devices used.
Player Check if your application supports Player. If supported, you need to input the details of video streaming solutions.
Important

AD info privilege API is available only to In-app AD app. If the detected information in "tizen-manifest.xml" file includes A Dinfo privilege, you must select on the 'In-app AD' feature.

And, check if your application uses any billing features.

Table 7. Billing Methods
Feature Description
Samsung Checkout Check if your application use embedded billing function in Samsung Smart TV. If the privilege APIs releated with Samsung Checkout are detected in the Pre-test step, this is automatically selected and cannot be unselected. And if the application use Samsung Checkout, you are required to register "Bank Account Information".
3rd Party Billing Check if your application use partner's own billing function.
Free Check if your application don't have a billing function.
Important

App service that 3rd party billing has been applied may be available for a limited time and it may be terminated without further notice.

2. Selecting Target Model Groups

And then, choose the target model groups where you would like to launch your application. If you want to submit a Tizen .NET application, you are limited to select 2018 TV models or later only.

Figure 7. Select Target Model Groups

Figure 7. Select Target Model Groups

Note

  • If your application supports Samsung Checkout, you cannot select the model groups which don't support Samsung Checkout.
  • If your application supports Smart View SDK, you should select at least one model group which supports Smart View SDK. Including Smart View SDK supporting model group, you are available to select more model groups regardless Smart View SDK support.

3. Entering Detailed Test Information

This information is used by Samsung Smart TV certification team.

Table 8. Test Information Input Fields
Input Field Description
App Description File Basic app documentation, to help testers understand app workflow and user scenarios. The document template can be downloaded from here.
Note for Tester Change log since the previous app version, any other information that can be useful for testers.
Geo IP Block Geo-filtering used for application content. If applicable, make sure that all IP addresses used by Samsung testers are whitelisted on your servers.
Test Account/Password, Voucher Code Test account with enough credit to check the whole application in detail on all requested platforms.
Important

Missing information in App Description File, Test account or Geo IP may result in rejecting your application from certification process. Check these items carefully and make sure provided information is enough to fully test your app.

4. Entering Release Information

In this step you can choose the application's launching timing since the certification.

  • Normal Release
    Means that application is released as soon as passed in certification.

  • Scheduled Release
    Means that application is released on the requested date even the application has been certificated before the date. Of course application cannot be released if its verification is not completed before that date.

The sellers usually choose the manual release when they want to promote their application on that day.

Figure 8. Release Date Registration

Figure 8. Release Date Registration

And, you need to consent two kinds of agreement.

  • Release agreement
    If application release is available even there may be some minor defects

  • Code sharing agreement
    If the registered code is available to be shared with the same group members

If you agree with the release with minor defects, Samsung may release your application without your confirmation even there are some minor defects. However Samsung will not release any application with critical defects.

5. Test Information Completion

After you enter all of the fields, proceed to the next step with clicking the "Next" button. If you skip some of the mandatory fields or complete them with incorrect value, it will be impossible to proceed.

If your application is passed at Pre-Test step, you are almost ready to submit. To confirm the registered information, please proceed to the next step, "Preview". Click the "Next" button.

Preview & Submit

You are almost ready to submit. A summary of all submitted information will be shown on screen, which is preview step. You are expected to review all of the form fields and correct where necessary. If those inputs are right, click the "Submit" button, the application registration process is done.

After registration process, your application will be put to certification process. You can check the certification status of the application at "Seller Office" > "Applications" > "Management". For more details, refer to Application Certification.