Partner Managed Row
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 | 必須 |
このレーティングは、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>で今すぐ観る