Grato por sua visita. Neste momento esta página está apenas disponível em inglês.

PMR on Fire TV

You submit recommendations to a Partner Managed Row (PMR) by using Android notifications. Amazon provides expanded functionality by using extra fields in the notification.

PMR on Android TV

The Android framework allows applications to submit recommendations by using Android notifications. In API level 21 and above, notifications may be tagged with a special recommendation category. You create a standard Android notification and set the category to Notification.CATEGORY_RECOMMENDATION.

Note that Android imposes a limit of 50 notifications active for at one time for any app. This includes notifications categorized as recommendations.

PMR Amazon Enhancements for Fire TV

Notifications and recommendations are submitted through the same mechanism on standard Android devices and Fire TV devices. Amazon's local recommendation mechanism is built on the standard Android ContentRecommendation.Builder API.

Expanded functionality is available through extras. Developers can add the following extra values to their Notification object.

Extra name Type Req Details
com.amazon.extra.DISPLAY_NAME String Yes This is a concise version of app name displayed as part of the text label of the Watch Now with … context menu. The length is limited to 15 characters and truncated if necessary.
com.amazon.extra.MATURITY_RATING String Yes This rating will be used by the Parental Control settings on the Fire TV device to determine if a PIN is required for access. Any recommendation without this value will be treated as Mature content and may require a PIN, subject to the Parental Control settings on the device.

Supported values include:
USGermanyUK
G
PG
PG13
R
NC17
TVY
TVY7
TVG
TVPG
TV14
TVMA
FSK0
FSK6
FSK12
FSK16
FSK18
BBFCPG
BBFC12
BBFC15
BBFC18
BBFCU
JapanIndia
EIRIN_G
EIRIN_PG12
EIRIN_R15
EIRIN_R18
ALL
7+
13+
16+
18+
NR
com.amazon.extra.TAGS ArrayList<String> No This helps determine in which Fire TV UI category a recommendation will appear. Defaults to Home if not supplied.

Currently supported values include Home, Your Videos, UHD:

Home: Movie or TV recommendations that should appear on the home screen

Your Videos: Recommendations for Movies and TV shows that can be consumed without additional payment by the customer

UHD: Used for 4K (Ultra HD) recommendations. This will add an UHD icon on mini-details

Not currently supported but reserved for future use: Movies, TV Shows, Trailers, Short Form.
com.amazon.extra.RANK int No This extra is used to sort items in acscending order by rank, after which they are subsorted by time of submission (most recent first). If absent, time of submission is used alone. Possible values range from 0 to INTEGER.MAX_VALUE. The lower the value, the higher the rank; that is, low values appear ahead of high values.
com.amazon.extra.CONTENT_ID String No This id corresponds to the content id used in Catalog Integration.
com.amazon.extra.ACTIONS ArrayList<String> Yes This tag helps determine which options are available on the context menu for each recommendation. Note: PMR currently supports two context-menu actions, but only the first action is configurable. When clicking a recommendation tile or its first context menu option, the corresponding content intent data passed with the recommendation will be used to launch the application.

ValueAction
1Watch now with <App name>
101Watch
2Resume with <App name>
102Resume
3Switch <App name> Profile
103Switch Profile
4Change <App name> Settings
5View with <App name>
105View
6Play with <App name>
106Play
7Listen with <App name>
107Listen
com.amazon.extra.LIVE_CONTENT int No This specifies whether a recommendation is live content, in which case its visibility should be governed based on CONTENT_START_TIME and CONTENT_END_TIME.

0 – Not live content
1 – Live content

Currently not supported.
com.amazon.extra.CONTENT_RELEASE_DATE String Yes This indicates release year of the content (2016, 2015, 1977, etc.).
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY int Yes This indicates whether or not the content has captions.

0 – Captions are not available
1 – Captions are available
com.amazon.extra.IMDB_ID String No Specifies the IMDB id of the content.
com.amazon.extra.IMDB_SCORE String No Specifies the IMDB rating of the content.
com.amazon.extra.CONTENT_START_TIME long No Indicates the start time in milliseconds (EPOCH).
com.amazon.extra.CONTENT_END_TIME long No Indicates the end time in milliseconds (EPOCH).
com.amazon.extra.LONG_DESCRIPTION String No This is a long description of a recommendation, limited to 512 characters and truncated if necessary.
com.amazon.extra.LAST_WATCHED_DATETIME long No Indicates the last-watched time of the recommended content in milliseconds (EPOCH).
com.amazon.extra.PREVIEW_URL String No Specifies a preview video or image URL for the recommendation.

Sample Recommendation Card

The following sample recommendation card shows how fields are displayed on the card.

The callout numbers on the card refer to the following fields:

  1. Title
  2. Text
  3. ContentImage
  4. Display Name (com.amazon.extra.DISPLAY_NAME)

    Depending on which tag(s) you associate with the recommendation, the button display label will vary:
    CategoryButton display label
    HomeWatch Now with <DISPLAY_NAME>
    Your VideosWatch Now with <DISPLAY_NAME>