Entering Application Information
This guide explains how to register and update information in the TV application.
Registering Application Image
In the "Applications > App Images" menu, you can register and edit application icons and screenshot images to be displayed on the TV.
Input Field | Description | Displayed on TV |
---|---|---|
Icon Images | Register icon images to be used when your application is displayed on the Smart TV. | Yes |
Screenshot Images | Register screenshot images to be used when your application is introduced on the Smart TV App store. | Yes |
Table 1. App Images input fields
Two sizes of application icons must be registered: 1920x1080 and 512x423 pixels.
The 1920x1080 size is used in Smart TV models released in or after 2016.
If you upload a logo image and a background image separately, 16:9 and 1:1 full-color asset images are automatically created, and the 1:1 size icon can be replaced with another image.
For the logo image, upload a transparent image sized 1920x1080 pixels, in the 32-bit PNG (RGBA) format, and with a file size of 300kB or less.
For the background image, upload an image sized 1920x1080 pixels, in the 24-bit PNG (RGB) or JPG format, and with a file size of 300kB or less.
The 512x423 size is used in old Smart TV models released before 2016.
Upload an image sized 512x423 pixels, in the PNG format, and with a file size of 300kB or less. Afterwards, a 1:1 proportion image is created automatically.
You must register 4 screenshots of your application.
If your application has in-app purchases, please include a screenshot with pricing information.
Upload the screenshot images sized 1920x1080 pixels, in the JPG format, and with a file size of 500kB or less.
Screenshots are displayed on the TV in the order they were uploaded. You can change the order of screenshots by dragging and dropping.
After entering all the application images, click the "Save" button to complete the registration.
Entering Application Title and Description
In the "Applications > Title/Description on TV" menu, you can register and edit the application title and description that are shown on the TV.
Enter the application title and description for each language so that users can view the application information according to the TV's language selection.
You can add and delete multiple languages by clicking the "Add/Delete Language" button.
One of the languages can be designated as the default language, which is then used if there is no application information in the language selected by the user.
Input Field | Description | Displayed on TV |
---|---|---|
App Title | Enter the application title for the given language. | Yes |
Description | Enter a description of the application for the given language. | Yes |
Table 2. Application Title/Description input fields
The application title written in the default language and the application title specified in the configuration file of the application package must be identical. Otherwise, the pre-test will fail during the deployment request process.
Unlike application names that cannot be changed, you can freely change the application titles displayed on the TV.
A blue (complete) icon is displayed for languages for which information has been entered, and a gray (incomplete) icon is displayed for languages for which it has not, so you can tell them apart.
Languages without an application title and description cannot be registered, so delete unnecessary languages from the list.
After entering the application title and description for each language, click the "Save" button to complete the registration.
Entering Service Information
In the "Applications > Service Info" menu, you can register and modify service information provided to the TV.
Input Field | Description | Displayed on TV |
---|---|---|
Service Category | Choose the Smart TV app category to provide your app from the categories presented: Videos, Game, Sports, Lifestyle, Information, Education, etc. | Yes |
Rating | Choose the age rating of the content. In some countries, an additional rating certificate may be necessary. | Yes |
Language | Enter the application languages the user can select when using the application. | Yes |
Privacy Policy | If your application collects personal information from users, you need to register the Privacy Policy URL so that it can be explained on the Smart TV. | Yes |
Seller Information | Enter the seller information such as the seller name, customer support email address, home page URL, representative name, phone number, and mailing address. According to Korean and European laws, you need to register seller information to service your application. | Yes |
Table 3. Service Info input fields
Service categories can be selected from the categories presented: Videos, Game, Sports, Lifestyle, Information, Education, etc.
However, for apps serving a global country (if the country of service includes China and other countries), you cannot select a Videos category unless the app is allowed. You cannot also select a category in which the mapping category shown in (bracket) is Videos.
If the application content is not suitable for the selected age rating, the service may not be released, and if this issue occurs after release, the service may be discontinued.
All applications must not contain violence, pornography, or abusive language.
Applications with an age rating of 18 years or older cannot be offered in Korea. For more information, please refer to the Age Rating guide.
If the applications collect user's personal information, you must enter a URL where the user can view Privacy Policy.
To comply with legal requirements related to personal information, review Samsung's Privacy guide, as well as the legal requirements of the countries in which the service is offered.
When registering an application, a seller group's information is used for it by default, but you can change the information for each application.
Note that the seller group's information changes, the application's seller information does not change accordingly, and vice versa.
To change the seller information displayed on the TV, you need to edit the seller information in the application, not the seller group information.
After entering all service information, click the "Save" button to complete the registration.
Setting Service Country
In the "Applications > Service Country" menu, you can set the country/region where the application will be released.
Input Field | Description | Displayed on TV |
---|---|---|
Country or Region | Select countries where your application is offered. | No |
Rating Certification | If you are issued a rating certification, you must register the certificate. | No |
Table 4. Service Country input fields
Some countries require a certificate to launch the application.
In order to release the application for the Brazilian market, you need to select an age limit and upload a certificate issued by MJ/DEJUS. The age limit may be changed according to review by Samsung SIDIA.
Partner Sellers can launch TV application services in any country, including the US, whereas Public Sellers can only launch in the US.
However, for VOD applications (if the service category or mapping category is Videos), you cannot service global countries unless the applications are specifically allowed. To release the application, you must also either exclude China or set the application to only release in China.
Also, applications with an age rating of 18 years or older cannot be launched in Korea.
When you change the service country of an application that has already been released and is being offered on the TV, you must enter a reason for the change, and the change is deployed after Samsung reviews the reason. Therefore, it is recommended to contact the Samsung Content Manager first before making any changes, as changes made without prior agreement may be rejected.
After setting the service country, click the "Save" button to complete the registration.
If the service country of an application being offered on the TV is changed, the change is not implemented immediately, but only after Samsung's review process.
Entering Billing Information
In the "Applications > Billing Info" menu, you need to enter whether the application has a payment function.
If there is no payment function, select 'Free'.
Feature | Description |
---|---|
Samsung Checkout | Select if your application uses the embedded billing function in Samsung Smart TV. |
3rd Party Billing | Select if your application uses a partner's own billing function. You need to also select the billing type, either transaction-based or subscription-based. |
Free | Select if your application does not have a billing function. |
Table 5. Billing Info input fields
If the Samsung Checkout option is selected, you need to check all items in the integration checklist after reviewing the guidelines presented.
Checklist | Guide |
---|---|
Test in-app purchases in DPI sandbox environment at least once before submitting your application. | Before submitting an application for QA, you are required to test the in-app purchases with actual payment methods for any items in the DPI sandbox environment. Note that a dummy payment is not considered the same as an actual payment method. |
Enter your company's bank information correctly. | For settlement and remittance, your company's bank account information is required. Enter your bank account information at Samsung Checkout DPI. For more information, see the Managing Bank Account Information section of the Managing Seller Groups guide. |
Make sure that your product (SKU) is created at both the operating DPI and the staging DPI before submitting your application. | To test your product, you need to create your product at the staging DPI. To sell your product to Smart TV users, you need to create the product at the operating DPI. Make sure that you register your product at both DPIs. |
The application must call the right DPI server according to the TV's server setting. Make sure that your application detects the TV's server type. | Ensure that your application detects the TV's server type and sets the DPI API URL accordingly. You can find more information under "Prerequisites - 4.Initialize the required variables - 4. Set the DPI URL and service environment depending on the server type" at Implementing the Purchase Process. |
The application must check for a Checkout-available country before calling the DPI Service API. Ensure that the 'Billing Service Available Country Check API’ is integrated to your application to check for Checkout availability. | Ensure that Checkout is supported in your service country by using the Billing Service Available Country Check API. Once availability has been confirmed, your application can call the DPI Service API at Checking Billing Service Available Country/Location. |
Table 6. Checklist for Samsung Checkout integration
In addition, to use the Samsung Checkout function, the related privilege API must be defined in the application package configuration file. Applications that do not have the privilege defined cannot be submitted. For more information on the API, refer to the Billing API guide.
After selecting the billing function, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
And you cannot change this information if you are joining or moving a group.
Entering Application Feature Information
In the "Applications > App Feature Info" menu, you need to enter whether Smart TV features are implemented in the application.
If there is no applicable function, please select 'Not applicable'.
Feature | Description |
---|---|
Caption | Select if your application supports Caption. This feature does not refer to subtitles, but IP video closed captioning which is used mainly in the US. Subtitles are located under Player features. |
External Devices | Select if your application uses external devices such as USB storage, camera, or microphone, and describe all external devices used. |
HDR | Select if your application supports High Dynamic Range. |
In-app AD | Select if your application is connected to an advertising platform for monetization. An application is not considered to be ad-supported if the advertisements are not connected to an advertising platform. An embedded, static image in an application is not classified as an advertisement. |
Mobile Device | Select if your application works with mobile devices and attach the corresponding mobile application. However, if the mobile application was developed using the 'Samsung SmartView SDK', select the 'Smart View' feature instead. |
Overlay | Select if your application supports Overlay PIP. The Overlay technique means the PIP is located in an HTML element in a Tizen web application. |
Smart View | Select if your application supports a mobile application developed through the ‘Samsung SmartView SDK’. |
TTS | Select if your application supports Text to Speech. |
Table 7. App Feature Info input fields
After selecting all implemented functions, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
If you select the Caption, In-app AD, Player, or Smart View functions, you need to additionally enter detailed information for each function in the sub-menu.
Caption Information
If the Caption function is applied, enter the caption application method and details in the "Applications > App Feature Info > Caption" menu.
To comply with the FCC's IP video subtitle rules, content providers must support subtitles for IP video. Applications are considered part of the device and strict rules apply, and CPs must use their own or manufacturer's solutions for captions.
You can download and refer to the 'Video Caption Implementation Guide' and 'User Interface Accessibility Compliance Manual' through the "FCC Guide Document Download" button.
Input Field | Description | Displayed on TV |
---|---|---|
Solution for Captioning | Select what solution was used for captioning. Select CEA-708/CEA-608 or SMPTE-TT/SAMI if using Samsung's solution, or Application UI if you use your own solution. | No |
Content Title and Location | Provide the video title and URL to play with caption. | No |
Table 8. Caption feature input fields
After entering the caption details, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
In-app AD Information
If the In-app AD function is applied, you need to enter whether to use TIFA (Tizen Identifier for Advertising) in the "Applications > App Feature Info > In-app AD" menu.
In addition, to use the In-app AD feature, the related privilege API must be defined in the application package configuration file. Applications that do not have a privilege defined cannot be submitted. For more information on the API, refer to the Adinfo API guide.
If the application is using TIFA , you must review the requisite guidelines.
Input Field | Description | Displayed on TV |
---|---|---|
Use TIFA | Select if your application uses TIFA for advertising purposes. Collecting or using TIFA Information for any other purpose is prohibited. | No |
Confirm TIFA Guideline | Select the check box after reviewing the guideline content and Terms and Conditions for using TIFA. | No |
Table 9. In-app AD feature input fields
After entering the in-app AD details, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
Player Information
If the Player function is supported, enter the details of the video streaming solution in the "Applications > App Feature Info > Player" menu.
Feature | Description |
---|---|
Video Codec | Select the video codec spec between Divx, H.263, H.264, HEVC, Motion JPEG, MPEG1, MPEG2, MPEG4, MVC, RV8/9/10, VC1, VP6, VP8, VP9, WMV7, WMV9, XviD, and Other. |
Audio Codec | Select the audio codec spec between AAC, AC3, ADPCM, AIFF, ALAC, APE, DTS, FLAC, HE-AAC, LPCM, MIDI, MP3, Vorbis, WAV, WMA, WMA/DD+, and Other. |
Container | Select the container spec between 3GPP, ASF, AVI, MKV, MP4(FMP4), MPEG-TS, Mstroska, PS, VOB, VRO, WebM, and Other. |
DRM | Select the DRM spec between AES-128, Playready, Verimatrix, Widevine (Classic), Widevine (Modular), and Other. |
Streaming Engine | Select the streaming engine spec between HLS, HTTP (HTTPS), MPEG-DASH, Smooth Streaming, and Other. |
Player API | Select the player API spec between AVPlay, C#, MSE, and Other. |
Subtitle | Select the subtitle spec between Close Caption, SMPTE-TT, WebVTT, and Other. |
Other | Describe if there are other player specifications not listed above. |
Table 10. Player feature input fields
After entering the player details, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
Smart View Information
If the Smart View function is selected, enter detailed information about the Smart View function and mobile application in the "Applications > App Feature Info > Smart View" menu.
Input Field | Description | Displayed on TV |
---|---|---|
Service Logo | Upload the mobile application icon or website logo. | No |
Service Title | Register the mobile application title on the App store or website. | No |
Service Access | Provide at least one of the following: Application source, Website URL, Other. | No |
Additional Features | Select features you added on your Smart View enabled application, between BLE (Bluetooth Low Energy) discovery, WoW (Wake on Wireless LAN), and Speaker. | No |
Table 11. Smart View feature input fields
For the logo image, upload an image sized 512x512 or 1020x1024 pixels, in the 24-bit PNG format, and with a file size of 300kB or less. Images with transparency are also permitted.
Depending on the service access method selected, upload the application source directly or enter the URL information to access it. If there are other ways to access the mobile application, explain them.
After entering the Smart View details, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.
Entering Verification Information
This information will be used by the Samsung Smart TV certification and verification team, and the process may be rejected if it is missing.
Make sure you can fully test your application with the information you provide before submitting.
Input Field | Description | Displayed on TV |
---|---|---|
App Description File | Provide application documentation to help Samsung testers understand the application's workflow and user scenarios. | No |
Geo IP Block | Select if geo-filtering is used for application content. Make sure that all IP addresses used by Samsung testers are allowed on your servers. | No |
Test Accounts | If your application requires a login to use, provide the credentials for test accounts. You must provide at least 1 test account for each model group that your application supports. Each test account must have enough credit to comprehensively test all the application features on a specific platform. WarningThe application is tested simultaneously across all requested model groups. Consequently, you must provide a number of test accounts equal to or greater than the number of requested model groups. Insufficient test accounts can cause your application to fail verification at the testing phase.
|
No |
Voucher Code | If you have content to use after payment, enter voucher information for testing. | No |
Table 12. Verification Info input fields
After entering the test information, click the "Save" button to complete the registration. Any changes made are reflected when you submit a new version of the application.