Phân phối qua DDEX (API hoặc SFTP)

Nếu hãng đĩa hoặc doanh nghiệp phân phối của bạn có hệ thống quản lý kho nhạc riêng, bạn có thể gửi bản phát hành đến HILLS Music dưới dạng thông điệp DDEX ERN thay vì nhập tay. Phân phối qua DDEX chỉ dành cho đối tác; nghệ sĩ và hãng đĩa, kể cả hãng đĩa trực tiếp, dùng Tải lên hàng loạt bằng bảng tính.

Thông tin kỹ thuật đầy đủ (cấu trúc thư mục, file đánh dấu, endpoint, scope và báo cáo kiểm thử) có trên trang dành cho nhà phát triển: DDEX deliveries và Test folder.

Ba cách gửi

Cách	Thực hiện	Dành cho
Portal	Import → DDEX inbox: gửi file zip, hoặc file XML kèm các file của nó	Mọi đối tác
SFTP	Thư mục /production và /test trong hộp thư của bạn	Mọi đối tác, sau khi đã thiết lập tài khoản đăng nhập
API	POST /v1/ddex với API key (scope ddex:write)	Đối tác dùng gói Enterprise và Custom

Dù lô được gửi theo cách nào, nó đều được xử lý như nhau và hiển thị trong DDEX inbox → Batches.

Lô được xử lý thế nào

1. Lô được đọc và kiểm tra: file XML, các quy định của HILLS, file âm thanh, ảnh bìa và video, cùng mã UPC và ISRC so với kho nhạc.
2. Mỗi bản phát hành trở thành một bản nháp trong tài khoản tương ứng: kho nhạc của chính bạn, hoặc của một nghệ sĩ hay hãng đĩa thuộc bạn.
3. Bạn kiểm tra các bản nháp rồi gửi đi, hoặc để chúng tự gửi (xem bên dưới). Sau đó chúng đi qua kiểm duyệt và phân phối đến các nền tảng như bình thường.

Bản phát hành đã tồn tại dưới dạng bản nháp với cùng UPC sẽ được cập nhật. Yêu cầu gỡ và cập nhật đối với bản phát hành đang kiểm duyệt hoặc đã live không bao giờ được áp dụng tự động: chúng được chuyển cho đội ngũ của chúng tôi xem xét.

Lô hiển thị kết quả xử lý: số bản nháp đã tạo, MV, các bản phát hành bị bỏ qua kèm lý do, và các thông điệp không đọc được.

Chạy thử trước

Bạn có thể chạy thử một thông điệp hoặc cả một lô trước khi gửi. Lượt chạy thử thực hiện mọi bước kiểm tra như khi phân phối thật nhưng không tạo ra gì: không bản phát hành, bản ghi âm, nghệ sĩ, mã hay lượt phân phối nào.

• Portal: DDEX inbox → Test, với một thông điệp ERN hoặc một gói. Chọn một tài khoản để đối chiếu thêm UPC và ISRC với kho nhạc của tài khoản đó. Có sẵn file ERN mẫu để so sánh.
• SFTP: tải lên /test/<batch>/; báo cáo được ghi ngay bên cạnh.
• API: POST /v1/ddex/validate.

Các lượt chạy thử được liệt kê trong mục Test reports trên trang DDEX.

Thiết lập hộp SFTP

Mỗi tài khoản có đúng một tài khoản đăng nhập SFTP cho phân phối DDEX, nằm trong DDEX inbox → SFTP accounts. Tùy cách thiết lập, bạn tự tạo hoặc đội ngũ của chúng tôi tạo giúp bạn.

1. Chọn username. Username không thể đổi sau này.
2. Chọn cách đăng nhập: mật khẩu (được tạo tự động và chỉ hiển thị một lần), SSH public key, hoặc cả hai.
3. Ghi lại host, port, username và host key hiển thị trên trang.
4. Dùng Test the connection: tải một file nhỏ bất kỳ như ping.txt lên /test. Trang chuyển sang màu xanh khi file đến nơi.

Gửi vào /production/<batch>/: file ERN XML cùng các file mà nó tham chiếu, kết thúc bằng file đánh dấu (BatchComplete_*.xml hoặc bất kỳ file *.complete nào). Thư mục lô nào không có file đánh dấu sẽ bị xóa sau 7 ngày.

Tự động gửi kiểm duyệt

Đánh dấu Submit for review automatically when a delivered release is complete để bỏ qua bước gửi thủ công. Nếu tắt, bản phát hành vẫn là bản nháp cho đến khi bạn gửi. Thiết lập này áp dụng cho portal, API và SFTP.

API

API dành cho đối tác dùng gói Enterprise và Custom. API dùng một loại key duy nhất (hm_live_…), được tạo trên trang Developers của bạn. Hãy bắt đầu với tài liệu dành cho nhà phát triển.