Fire TVのPMR


Fire TVのPMR

Androidの通知を使用して、PMR(Partner Managed Row)におすすめを送信します。Amazonでは、通知にエクストラフィールドを使用することで、拡張機能を提供しています。

Android TVのPMR

Androidフレームワークでは、アプリはAndroidの通知を使用しておすすめを送信できます。APIレベル21以上では、通知に特別なおすすめカテゴリーのタグが付けられます。標準のAndroid通知を作成し、カテゴリーをNotification.CATEGORY_RECOMMENDATIONに設定します。

Androidでは、アプリごとに一度にアクティブにできる通知数が50に制限されています。これには、おすすめとして分類された通知も含まれます。

Fire TV向けのPMR Amazon拡張機能

通知とおすすめは、標準のAndroidデバイスとFire TVデバイスでは同じメカニズムで送信されます。Amazonのローカルのおすすめメカニズムは、標準のAndroidのContentRecommendation.Builder APIに基づいて構築されています。

拡張機能は、エクストラを通じて使用できます。開発者は、Notificationオブジェクトに次のエクストラ値を追加できます。

エクストラの名前 必須/任意 詳細
com.amazon.extra.DISPLAY_NAME String 必須 [...で今すぐ観る]コンテキストメニューのテキストラベルの一部として表示されるアプリ名の簡潔バージョンです。最大文字数は15文字です。文字数がこれを超える場合は切り捨てられます。
com.amazon.extra.MATURITY_RATING String 必須 このレーティングは、Fire TVデバイスのペアレンタルコントロール設定で、アクセスにPINが必要かどうかを判断するために使用されます。この値を含まないおすすめは、成人向けコンテンツとみなされます。したがって、デバイスのペアレンタルコントロール設定によっては、PINが必要になる場合があります。

サポートされる値は次のとおりです。
米国ドイツ英国
G
PG
PG13
R
NC17
TVY
TVY7
TVG
TVPG
TV14
TVMA
FSK0
FSK6
FSK12
FSK16
FSK18
BBFCPG
BBFC12
BBFC15
BBFC18
BBFCU
日本インド
EIRIN_G
EIRIN_PG12
EIRIN_R15
EIRIN_R18
ALL
7+
13+
16+
18+
NR
com.amazon.extra.TAGS ArrayList<String> 任意 おすすめが表示されるFire TV UIカテゴリーを指定します。指定されていない場合、デフォルトはHomeです。

現在サポートされている値は、HomeYour VideosUHDです。

Home: ホーム画面に表示される映画またはテレビのおすすめ

Your Videos: ユーザーが追加料金なしで視聴できる映画やテレビ番組のおすすめ

UHD: 4K(ウルトラHD)のおすすめに使用されます。ミニ詳細にUHDアイコンが追加されます。

現在サポートされていませんが、将来の使用のために予約されている値: MoviesTV ShowsTrailersShort Form
com.amazon.extra.RANK int 任意 このエクストラはアイテムをランクで昇順にソートするために使用されます。ソート後は、送信時刻によってサブソートされます(最新のものから順に)。指定されていない場合、送信時刻が単独で使用されます。指定できる値の範囲は0~INTEGER.MAX_VALUEです。値が小さいほどランクが高くなります。つまり、小さい値は大きい値より先に表示されます。
com.amazon.extra.CONTENT_ID String 任意 このIDは、カタログ統合で使用されるコンテンツIDに対応します。
com.amazon.extra.ACTIONS ArrayList<String> 必須 このタグは、各おすすめのコンテキストメニューで使用できるオプションを決定します。注: PMRでは現在2つのコンテキストメニューアクションがサポートされていますが、1つ目のアクションのみ設定可能です。おすすめのタイルまたは1つ目のコンテキストメニューオプションをクリックすると、おすすめと共に渡された対応するコンテンツインテントデータを使用して、アプリが起動されます。

アクション
1<App name>で今すぐ観る
101Watch
2<App name>で続きを観る
102Resume
3<App name>のプロフィールを切り替え
103Switch Profile
4<App name>の設定を変更
5<App name>で観る
105View
6<App name>で再生
106Play
7<App name>で聞く
107Listen
com.amazon.extra.LIVE_CONTENT int 任意 おすすめがライブコンテンツかどうかを指定します。ライブコンテンツの場合は、CONTENT_START_TIMECONTENT_END_TIMEに基づいて表示の可否が決まります。

0:ライブコンテンツではない
1:ライブコンテンツ

現在サポートされていません。
com.amazon.extra.CONTENT_RELEASE_DATE String 必須 コンテンツのリリース年(2016、2015、1977など)を示します。
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY int 必須 コンテンツのクローズドキャプションの有無を示します。

0:クローズドキャプションなし
1:クローズドキャプションあり
com.amazon.extra.IMDB_ID String 任意 コンテンツのIMDB IDを指定します。
com.amazon.extra.IMDB_SCORE String 任意 コンテンツのIMDBレーティングを指定します。
com.amazon.extra.CONTENT_START_TIME long 任意 ミリ秒単位での開始時刻を示します(エポック)。
com.amazon.extra.CONTENT_END_TIME long 任意 ミリ秒単位での終了時刻を示します(エポック)。
com.amazon.extra.LONG_DESCRIPTION String 任意 おすすめの詳細な説明です。最大文字数は512文字で、文字数がこれを超える場合は切り捨てられます。
com.amazon.extra.LAST_WATCHED_DATETIME long 任意 おすすめコンテンツのミリ秒単位での最終視聴時刻(エポック)を示します。
com.amazon.extra.PREVIEW_URL String 任意 おすすめのプレビュービデオ・画像のURLを指定します。

おすすめカードのサンプル

次のおすすめカードのサンプルは、フィールドがカード上でどのように表示されるかを示しています。

カード上のコールアウト番号は、次のフィールドを示します。

  1. Title
  2. Text
  3. ContentImage
  4. 表示名(com.amazon.extra.DISPLAY_NAME)

    おすすめに関連付けるタグによって、ボタンの表示ラベルは異なります。
    カテゴリーボタンの表示ラベル
    Home<DISPLAY_NAME>で今すぐ視聴する
    Your Videos<DISPLAY_NAME>で今すぐ視聴する