Partner Managed Row
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 | タイトルの下に評価が表示されます。この評価は、コンテンツの再生にPINの入力が必要かどうかを判定する、Amazon Fire TVの機能制限の設定にも使用されます。このエクストラまたはsetMaturityRating()の値を含まないおすすめは、成人向けコンテンツとみなされ、デバイスの機能制限の設定でPINの入力が必要になる場合があります。
現時点でサポートされている値は次のとおりです。
|
あり |
com.amazon.extra.ACTION_OPTION |
ArrayList<int> | 各おすすめに表示されるコンテキストメニューオプションを決定します。コンテキストメニューでは2つのアクションがサポートされていますが、1つめのアクションのみ構成可能です。 ユーザーがおすすめのタイルまたは1つ目のコンテキストメニューオプションをクリックすると、Amazon Fire TVは、おすすめとともに渡された、対応するコンテンツのインテントデータを使用して、アプリを起動します。注： アプリがアクションのArrayListを提供している場合は、 次の値を
値が指定されていない場合、デフォルトのアクションは |
あり |
com.amazon.extra.RANK |
int | このエクストラはアイテムをランクを条件に昇順でソートするために使用されます。ソート後は、送信時刻によって（最新のものから順に）サブソートされます。指定されていない場合、送信時刻が単独で使用されます。指定できる値の範囲は、0～INTEGER.MAX_VALUEです。値が小さいほどランクが高くなります。つまり、小さい値は大きい値より先に表示されます。 |
なし |
com.amazon.extra.CONTENT_ID |
String | このIDは、カタログ統合で使用されるコンテンツIDに対応します。 | なし |
com.amazon.extra.LIVE_CONTENT |
int | おすすめがライブコンテンツかどうか、また、CONTENT_START_TIMEおよびCONTENT_END_TIMEに基づいて表示または非表示にする必要があるかどうかを判断するために使用されます。サポートされる値は次のとおりです。
| なし |
com.amazon.extra.CONTENT_RELEASE_DATE |
String | コンテンツのリリース年。例： 2016、2015、1977など。 | あり |
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY |
int | コンテンツのクローズドキャプションの可否。
| あり |
com.amazon.extra.IMDB_ID |
String | コンテンツのIMDb ID（たとえば、URLがhttp://www.imdb.com/title/tt0417148の場合、IDはtt0417148です）。 |
なし |
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のプレビュー。 | なし |
com.amazon.extra.TAGS |
ArrayList<String> | コンテンツが4K（Ultra HD）の場合に、タグ ["UHD"] を追加する。 |
あり |
com.amazon.extra.CONTENT_CUSTOMER_RATING |
int | ユーザーによる評価。有効な値は0～10の範囲です。 | あり |
com.amazon.extra.CONTENT_CUSTOMER_RATING_COUNT |
int | このコンテンツを評価したユーザーの数。 | あり |
おすすめカードのサンプル
次のおすすめカードのサンプルは、フィールドがカード上でどのように表示されるかを示しています。
カード上のコールアウト番号は、次のフィールドを示します。
- Title
- Text
- ContentImage
- 表示名（com.amazon.extra.DISPLAY_NAME）
おすすめに関連付けるタグによって、ボタンの表示ラベルは異なります。カテゴリー ボタンの表示ラベル Home <DISPLAY_NAME>で今すぐ観る Your Videos <DISPLAY_NAME>で今すぐ観る