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が必要になる場合があります。 サポートされる値は次のとおりです。
|
||||||||||||||||||||||||||||
| com.amazon.extra.TAGS | ArrayList<String> | 任意 |
おすすめが表示されるFire TV UIカテゴリーを指定します。指定されていない場合、デフォルトはHomeです。現在サポートされている値は、 Home、Your Videos、UHDです。Home： ホーム画面に表示される映画またはTVのおすすめ。Your Videos： ユーザーが追加料金なしで視聴できる映画やTV番組のおすすめ。UHD： 4K（ウルトラHD）のおすすめに使用されます。ミニ詳細にUHDアイコンが追加されます。現在はサポートされていませんが、将来の使用のために予約されている値は、 Movies、TV Shows、Trailers、Short 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つ目のコンテキストメニューオプションをクリックすると、おすすめと共に渡された対応するコンテンツインテントデータを使用して、アプリが起動されます。
|
||||||||||||||||||||||||||||
| com.amazon.extra.LIVE_CONTENT | int | 任意 |
おすすめがライブコンテンツかどうかを指定します。ライブコンテンツの場合は、CONTENT_START_TIMEとCONTENT_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を指定します。 |
おすすめカードのサンプル
次のおすすめカードのサンプルは、フィールドがカード上でどのように表示されるかを示しています。
カード上のコールアウト番号は、次のフィールドを示します。
- Title
- Text
- ContentImage
- 表示名（com.amazon.extra.DISPLAY_NAME）
おすすめに関連付けるタグによって、ボタンの表示ラベルは異なります。カテゴリー ボタンの表示ラベル Home <DISPLAY_NAME>で今すぐ観る Your Videos <DISPLAY_NAME>で今すぐ観る