Within an Apple TV app, Top Playlists are designated playlists you can place within slider images at the top of your app as previewed below:
Top Playlist Restrictions
Playlists that can be opened from top sliders are located directly under 'Root' playlist in the Playlists > Manage Relationships section.
At the example above playlists that can be used as a top playlist are: Set of Playlists, Live Recordings, Main Playlist and Series.
To create these playlists in the CMS, you will need to create a titled Top Playlists. Follow the instructions below to do so.
Step 1: Create the Zobject
In your Zype account, click the settings gear in the top right corner. Select Zobject Types from the menu. On the Zobjects Type page, click "New Zobject" in the top right corner.
Fill out the Zobject Details with the following information:
- Title: top_playlists
- Videos Enabled: On
You will create two custom attributes for your Top Playlist Zobject:
Playlist ID: This allows you to associate playlists to the Top Playlist
- Name: playlistid
- Type: String
- Show List: Visible
Priority: This allows you to determine the order of the Top Playlists. The highest number will be the first playlist displayed.
- Name: priority
- Type: integer
- Show List: Visible
Click Save Changes at the bottom of the page. Here is what the completed Zobject should look like:
Step 2: Add Top Playlists
You will now select playlists you want to promote at the top of the app to be your top playlists. We suggest selecting 2-4 playlists.
Tip: Select the playlists you want to use before following the directions below. You will need the title and playlist ID of the playlists you want to use, and it will be helpful to gather this information before creating the Top Playlist. Refer to the screenshot below for the information you need from a playlist to create a Top Playlist:
To start adding Top Playlists, select your "Top Playlist" Zobject on the left hand side of your Zype account. On the Top Playlists page, click "Add New Top Playlist" at the top right corner.
You will now use the information from the playlist you are using to create a Top Playlist. You need the following information:
- Friendly Title
Click "Save Changes" at the bottom of the page when the required information is filled out.
Step 3: Adding Top Playlist Images
Each Top Playlist requires an image. The Top Playlist image should be in the following format:
- 1740 x 700px, JPG
To add an image to a Top Playlist, click into the Top Playlist. From the Edit Top Playlist page, click the Images tab at the top of the page.
Click the Add Image button and add the image file, then click Save Changes at the bottom of the page. You will see the image preview when an image is added successfully:
Step 4: Top Shelf Image
The top shelf image and top shelf image wide are added in the app building process on your Video Apps tab.
Click into 'Edit Advanced Settings' of your Apple TV app:
Choose the 'Build Details' tab and upload Top shelf image & top shelf image wide from here:
Step 5: Click 'Save Advanced Settings' at the bottom of the page