DDEX フィード・デリバリー仕様
最終更新日 10か月前
LabelcampへのDDEXフィード配信に関する仕様と要件は以下の通りです。
⚠️ DDEXフィードの設定前に、必ず担当のビジネスコンタクトから事前承認を得てください。
⚠️ カタログ全体および/または定期的な新作配信の受領前に、テスト配信の検証を数回お願いいたします。
配信設定
サポートチームからS3バケットのログイン情報を受け取った後、割り当てられたバケットへの配信が可能になります。
配信
DDEX情報:
DDEX 契約者名:Labelcamp
DDEX パーティ ID: PADPIDA2011111602K
ファイル形式
状況に応じて、以下の形式で納品可能です:
オーディオファイル(FLAC推奨、WAVも対応。16ビットオーディオの場合、48kHzを超えるビットレートを除くほとんどのビットレートに対応)、
ブックレット(PDF必須、Appleの要件に準拠)、
カバーアート(必須:JPEG、正方形フォーマット、最小3000px~最大4500px、RGBカラースペース、最大サイズ20MB)、
メタデータXML
DDEX仕様
納品物はDDEX XSDで検証され、準拠していない場合は拒否されます。
納品データはDDEX ERN 3.8仕様に準拠している必要があります。関連するXSDスキーマ(例:http://service.ddex.net/xml/ern/41/release-notification.xsd)に基づき検証を行います。
他のDDEXバージョンもサポートする場合がありますが、ご利用希望のバージョンを事前にご連絡いただき、サポート可能かどうかご確認ください。
リリース・レーベル名
XML内の「LabelName」は厳密に統一してください。同一レーベルに属するリリースは必ず同一のLabelNameで配信してください。Labelcampのカタログに既存レーベルとして認識されない場合、自動的に新規レーベルが作成されます。
大文字小文字の区別には多少の許容範囲があります(例:「My Label」と「my label」は同一と見なされます)。
→ Labelcamp では、「レーベル」は「契約」に紐付けられます。契約は流通契約や法人格を表すもので、1つの契約に複数の「レーベル」をグループ化できます(販売レポートや流通管理に有用な機能です)。XML納品物で特定されたレーベルと、お客様のLabelcamp上の契約をマッピングするサポートを提供します。
バッチ要件
すべてのバッチフォルダは、DDEX ERN Choreography Standardで規定されたファイル命名規則に従って命名する必要があります。各バッチは作成日時を『YYYYMMDDhhmmssnnn』形式で識別されます:
'YYYY' はバッチ作成年を表します
'MM' はバッチ作成月を表します
'DD' はバッチ作成日を表します
'hh' はバッチ作成時刻の時間を表します
'mm' はバッチ作成時の分を表します
'ss' はバッチが作成された秒を表します
'nnn' はバッチが作成されたミリ秒を表します
各バッチIDが一意であることを確認してください。
サーバーの構成
各バッチは、上記のバッチIDを名前にした専用のバッチフォルダに格納してください。
そのバッチに含まれるすべてのリリースは、製品のリリースID(例:UPC)を名前にした独自のリリースフォルダに配置する必要があります。リリースの録音ファイルは「resources/」というサブフォルダに配置してください。
当社システムがサポートするバッチ構造の例を以下に示します。
ルート/
|-- 20100310130322000/
| |-- 3663729899990/
| | |-- 3663729899990.xml
| | |-- resources/
| | | |-- 3663729899990_T1_001.flac
| | | |-- 3663729899990_T2_002.flac
| | | |-- 3663729899990.jpg
| |-- 3663729899998/
| | |-- 3663729899998.xml
| | |-- リソース/
| | | |-- 3663729899998_T1_001.flac
| | | |-- 3663729899998_T2_002.flac
| | | |-- 3663729899998.jpg
| |-- バッチ完了_20100310130322000.xml
|-- 承認/
| |-- ACK_3663729899990.xml
| |-- ACK_3663729899998.xml
マニフェストメッセージ/バッチ完了ファイルは、上記の例(BatchComplete_20100310130322000.xml)のように、バッチIDのルートフォルダに配置する必要があります。
FTP 確認応答メッセージ
インジェストが正常に完了した後、FtpAcknowledgementMessagesをルートパスにあるacknowledgementsフォルダに配置します。
→ 送信された各リリースについて、確認ファイルを参照し、貴社側で修正が必要な場合はコンテンツを再配信してください。
ファイル命名規則
各バッチの ManifestMessage のファイル名は、以下の命名規則に従ってください:BatchComplete_BatchId.xml (例:BatchComplete_20100310130322000.xml)。
サポートされる配信タイプ
以下の DDEX メッセージをサポートしています:
新規製品追加用配信
メタデータのみの更新に関する更新
アセット(カバー、ブックレット、オーディオ、ビデオ)に関する更新のための再配信、
プラットフォームからの削除を伴う削除
音楽ジャンル
標準フィード配信
すべての音楽ジャンルを受け付けます。ただし、アルバムに設定されたジャンルがLabelcampのジャンルグリッドに含まれていない場合、追加の手動マッピングが必要となります。Labelcampでは既存のジャンルリストのみを使用してください。
トレンド専用クライアント向けフィード配信
ジャンルランキングを機能させるため、以下のマスターリストからのジャンル指定を必須とします。該当しないジャンルは反映されません:
オルタナティブ/インディー
オーディオブック
児童書/教育
クラシック
カントリー
エレクトロニック
ヒップホップ/ラップ
インスピレーショナル/宗教
インストゥルメンタル
ジャズ / ブルース
その他(コメディ/フィットネス/ホリデー/カラオケなど)
ニューエイジ / スピリチュアル
ポップス / ロック
R&B/ソウル/ファンク
レゲエ
シンガーソングライター / フォーク
サウンドトラック
スポークン・ワード
ワールド