「近日公開」機能の概要
コンテンツは、現在がアベイラビリティフィードで指定した配信可能期間内であり、かつ有効となっている場合にのみ、Apple TVアプリで公開されます。ただし、テレビ番組や映画の新作を公開前にプロモーションする場合は、coming_soonオファータイプを使用することで、実際の公開期間より前にアプリで表示できるようになります。
この機能はAppleサブスクリプションビデオパートナーのみが利用できるもので、利用に先立ちAppleビデオビジネス担当者による審査が必要となります。
「近日公開」ページをApple TVアプリで作成するには、次の要素が必要となります。
- 新しいテレビ番組や映画の
<item>
レコード。カタログフィード内に記述する必要があります。テレビ番組に関しては、この「近日公開」機能を有効にする際にエピソードやシーズンを関連付ける必要はありません。 - また
<item>
レコードには、タイトル、説明、年齢制限指定など、必須メタデータをすべて含める必要があります。 - アートワークに関する要素(
cover_artwork_horizontal
、tile_artwork
、centered_background
、centered_background_small
、content_logo_polychromatic
)。カタログフィードの<item>
レコード内に記述します。 - テレビ番組か映画に関連付けられた、再生可能なExtrasタイプのアイテム(previewなど)を一つ以上。Extrasのアイテムに対しては、テレビ番組や映画の本編用のものとは別に、カタログへの入力やアベイラビリティレコードの作成が必要となります。プレビューコンテンツやボーナスコンテンツの納品について詳しくは、こちらをご覧ください。
フィード内でのcoming_soonオファータイプの設定方法
「近日公開」ページに関する設定作業の大半は、カタログフィードとアベイラビリティフィードで行います。プレビューアイテムはまた、テレビ番組や映画のフィードレコードと依存関係があります。なお、この機能はApple TVアプリ内で一度も公開されたことがない、完全に新規のテレビ番組か映画のみでサポートされる機能です。あらかじめご了承ください。
カタログフィードの設定
現在、「近日公開」機能はコンテンツタイプがtv_show
とmovie
のもののみでサポートされています。新作のテレビ番組や映画に対する<item>
レコードをカタログフィード内に記述します。
テレビ番組において、最初のエピソードが公開される7日前まではtv_season
レコードやtv_episode
レコードを含める必要はありません。
「近日公開」ページで適切な表示が行われるよう、新作のテレビ番組や映画の<item>
レコードには、以下のメタデータを含める必要があります。
- タイトル
- 説明
- 年齢制限指定
- 出演者/スタッフ
- アートワーク(仕様の詳細は「アートワーク仕様」)
- 16:9のカバーアート(
cover_artwork_horizontal
) - 2:3のカバーアート(映画のみ、
cover_artwork_vertical
) - タイル/キーフレーム/バナーのアートワーク(
tile_artwork
) - 横長の背景(
centered_background
)、縦長の背景(centered_background_small
)、フルカラーのコンテンツロゴ(content_logo_polychromatic
)は「近日公開」機能に対しては必須ではありませんが、Apple TVアプリでおすすめコンテンツとして取り上げられるためには必須となります。
- 公開対象地域に合わせた地域別のメタデータもすべて必須となります。詳しくは、「サブスクリプションビデオパートナーの追加要件」をご覧ください。
以下は、新しい映画に対する<item>
レコードのサンプルです。
<item contentId=“MOVIE_1” contentType=“movie”>
<pubDate>2020-05-01T18:00:12-07:00</pubDate>
<title locale="en-US">Mountain High</title>
<description locale="en-US">There's no higher place than Mountain High.</description>
<genre>travel</genre>
<rating systemCode="mpaa" value="R" />
<credit role="actor" order="1">
<name>Ted Green</name>
<character imageUrl="https://www.acme.com/castInCharacter1234.jpg">
<characterName>The Boss</characterName>
</character>
</credit>
<artwork url="https://www.acme.com/imageassets/11/12/movie1112.jpg" type="cover_artwork_vertical" locales="en-US" />
<artwork url="https://www.acme.com/imageassets/11/12/movie1113.jpg" type="centered_background" />
<artwork url="https://www.acme.com/imageassets/11/12/movie1117.jpg" type="centered_background_small" />
<artwork url="https://www.acme.com/imageassets/11/12/movie1119.jpg" type="content_logo_polychromatic" locales="en-US" />
<artwork url="https://www.acme.com/imageassets/11/12/movie1114.jpg" type="cover_artwork_horizontal" locales="en-US"/>
<artwork url="https://www.acme.com/imageassets/11/12/movie1112S1.jpg" type="tile_artwork" />
<movieInfo>
<type>feature</type>
<duration>5460</duration>
<studio>Platonic Studios</studio>
<originalReleaseDate country="US">2021-03-08</originalReleaseDate>
<version>standard</version>
</movieInfo>
</item>
アベイラビリティフィードの設定
アベイラビリティフィード内で「近日公開」機能を指定するには、<offers>
ブロック内でcoming_soon
の値に<offeringType>
要素を使用します。この<offer>ブロックの記述を、新作のテレビ番組や映画に対して行う必要があります。
現在coming_soon
オファータイプは、コンテンツタイプがtv_show
のもののみで使用できます。
coming_soonオファータイプにはまた、<windowStart>
要素と<windowEnd>
要素を使い開始日と終了日も指定する必要があります。<windowStart>
には、Apple TVアプリでコンテンツのページを表示可能とする日を指定します。coming_soonオファータイプの<windowEnd>
には、コンテンツページで作品が公開される日を指定します。テレビ番組の初回エピソードや映画に対するタイムスタンプには、<windowStart>
の1日が開始してから数時間後の時刻を指定してください。テレビ番組の初回エピソードや映画については、コンテンツが配信開始されるとアベイラビリティフィードでのcoming_soonオファーの記述は無効となります。
Apple TVアプリで表示される日付は、現地標準時ではなく太平洋標準時(UTC-08:00)に基づいたものとなります。このため、<windowEnd>
で指定する日時は、太平洋標準時(UTC-08:00)で真夜中を過ぎた日時に設定します。こうすることで正しい日付が表示されます。
以下はカタログから抜粋した、映画に対するアベイラビリティレコードのサンプルです。
<item contentType="movie" contentId="MOVIE_1" catalogId="com.catalog.acme" variantId="1">
<pubDate>2020-05-01T18:00:12-07:00</pubDate>
<offers>
<offer>
<offeringType>coming_soon</offeringType>
<windowStart>2021-01-01T02:00:00+01:00</windowStart>
<windowEnd>2021-03-08T05:00:00+01:00</windowEnd>
</offer>
<offer>
<offeringType>subscription</offeringType>
<windowStart>2021-03-08T01:00:00+01:00</windowStart>
<windowEnd>2025-03-07T05:00:00+01:00</windowEnd>
</offer>
</offers>
</item>