メインコンテンツへスキップ
ウェルカム・ドックス

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/ソウル/ファンク

  • レゲエ

  • シンガーソングライター / フォーク

  • サウンドトラック

  • スポークン・ワード

  • ワールド