Audioburst Personalized Playlist

Overview

This document provides instructions on how to get and manage user’s personalized playlists.

Audioburst personalized playlists provide listening identities that follow your users’ habits and desires. Audioburst’s AI-based audio engine organizes audio content every day. Our platform listens to, understands, segments and indexes millions of minutes of audio information from top radio stations and podcasts. From the Audioburst segmentation process, we can create personalized listening identities, an experience now available to all developers through the following set of APIs:

Instructions

  1. POST Register User - Use this API to create a UserID for each of your users, POST this ID to Audioburst.
  2. GET Personalized Playlist - Use the personalized API to get the listening identity preferences. Display the preferences on your application’s user interface to allow your users the ability to set their preferred news categories and topics. Audioburst listening identities are built from trending news topics, as well as other themed categories and subcategories, such as sports and entertainment.

    (You can review all supported topics using the GET User Preferences API.)

  3. POST Set User Preferences - After the user has selected their desired topics from the UI, post the user’s preferences to Audioburst. Preferences will be set for the user’s listening identity and will be kept until you POST new preferences.
  4. GET Personalized Playlist API - Each time the user asks for the personalized playlist, use the GET personalized playlist API following the UserID.
  5. Display Audioburst personalized configurations - Provide your users with the option to configure their listening identity on a usable user interface. This interface could be accessible from your app side menu, a personalized screen or any other location that will be accessible to the user.

    (See our UX recommendations below for ideas on developing an appropriate user interface.)

  6. To display your user's configurations above the complete list of Audioburst topics, use the GET Personalized Playlist API call along with the GET User Preferences API call. On the UI mark, the user selected categories and topics will be previewed above the Audioburst topics. If the user made any changes to their listening identity, use the POST Set User Preferences API with the UserID to send the new configuration to Audioburst.

UX recommendations

Personalized onboarding:

  • Open the personalized playlist for the first time. (Screen 1)
  • The user selects categories or topics to be included in the playlist. (Screens 2,3)

Add user generated topics:

  • Select the option to add a topic. (Screen 1)
  • The user inputs a topic into the playlist. (Screen 2)
  • The user can remove the topic by tapping the ‘x’ next to its listing. (Screen 3)

Provide a UI to change the user personalized playlist configuration:

  • Set a place to configure the personalized playlist. (Screen 1, 2)
  • The user can tap selected topics to unselect, or delete their customized topics by tapping the ‘x’ next to its listing.