La herramienta de carga masiva te permite importar varios lanzamientos a la plataforma a la vez utilizando una plantilla CSV. Este artículo explica cómo dar formato a tus metadatos, adjuntar activos y manejar errores comunes. 

Puedes descargar la plantilla CSV más reciente al final de este artículo. Para verificar la elegibilidad, deberás enviar un CSV masivo de muestra al servicio de soporte a través de nuestro formulario de contacto. 

General 

• Metadatos del catálogo: A continuación describimos el formato de la plantilla CSV para la carga masiva. Antes de utilizar la herramienta, se recomienda consultar esta guía y leerla detenidamente. 
• Recursos del catálogo: Los recursos no se subirán directamente a la plataforma. En su lugar, el archivo de metadatos debe incluir una URL desde la que los sistemas puedan obtener el recurso en una sola llamada. Nuestra herramienta recuperará automáticamente los recursos en tiempo real, a partir de las URL proporcionadas en el CSV. 

La carga masiva de CSV tiene algunas limitaciones: 

• Esta plantilla específica solo admite inserciones de lanzamientos (excluyendo tonos de llamada y videoclips). 
• Campos no compatibles: Descripción y notas del lanzamiento y de la pista; Letra de la pista, Hora de inicio de la pista. 
  • Estos campos no se pueden insertar como parte de la carga masiva. Puede actualizar estos campos desde la interfaz habitual una vez que se haya completado el proceso de carga. 

Definición de campos de lanzamiento y pista 

A partir de la línea 8 de la plantilla de carga masiva de CSV, debe completar la información de metadatos de su catálogo. Cada línea corresponde a una pista y contiene también los datos del lanzamiento (álbum). De esta manera, si subes, por ejemplo, un lanzamiento con 10 pistas, la primera parte (campos de lanzamiento) de la línea se completará con los mismos datos para todas las pistas (en las 10 líneas), y la segunda parte (campos de pista) será diferente para cada una de las pistas. 

En este ejemplo, una vez que hayas subido el archivo, si no hay errores en el proceso, el sistema subirá 1 álbum con 10 pistas incluidas. 

Corrección de errores 

Si un lanzamiento contiene errores, no se subirá, pero los lanzamientos sin errores se subirán en cualquier caso. Una vez completada la subida, se te proporcionará un CSV de los lanzamientos fallidos, y los detalles sobre los errores aparecerán al hacer clic en «Detalles». Esto te permitirá corregir los lanzamientos fallidos y subir otra versión de los mismos. 

Puedes hacer lo siguiente con respecto a las relaciones entre pistas: 

• Adjuntar una pista existente a un nuevo lanzamiento: Puedes usar esta herramienta para adjuntar una pista que ya se subió en el pasado a un lanzamiento completamente nuevo. Para hacerlo, debes completar los campos ISRC correctos en la sección «Campos de pista» y dejar todos los demás campos en blanco. La sección «Campos de lanzamiento» debe completarse como de costumbre. 
• Adjuntar una nueva pista a varios lanzamientos: Puedes subir una nueva pista para incluirla en varios lanzamientos nuevos dentro del mismo archivo CSV. Para ello, debes completar los mismos campos de metadatos de la pista en la sección «Campos de la pista» en más de una línea y asegurarte de completar diferentes «Campos del lanzamiento» en cada una de las múltiples líneas para adjuntar esta pista a cada uno de estos lanzamientos. 
  • Si esta pista ya existe en el catálogo, sigue las instrucciones del punto 1. 

Formato de archivo 

El archivo debe ser [CSV] con campos separados por comas, opcionalmente entre comillas dobles, según RFC4180. La codificación de caracteres del archivo debe ser UTF-8 para garantizar el tratamiento adecuado de los idiomas que no sean el inglés. 

Los campos opcionales pueden dejarse vacíos, pero sus columnas deben estar presentes en el documento para mantener la estructura para la que está diseñada la herramienta. 

Tipo de lanzamiento 

El formato de lanzamiento se asignará automáticamente, siguiendo estas reglas: 

Subida de lanzamientos 

Podrás subir tus archivos desde el Administrador de lanzamientos. De forma predeterminada, esta función no está disponible en tu cuenta y debe ser activada por tu representante de cuenta, o bien contactando a support@toolost.com e incluyendo un archivo CSV de muestra. 

Instrucciones para el CSV 

Campos de metadatos 

La primera sección del archivo es una sección de metadatos (líneas 1-5). Todos los campos son obligatorios y permiten que nuestra herramienta procese el archivo correctamente. 

Campos de lanzamiento 

Campos de pista 

Las pistas del lanzamiento se numerarán a partir del 1 en el orden en que aparecen en el archivo CSV de carga masiva. En la segunda línea de pista y en las siguientes del mismo lanzamiento, todos los campos del lanzamiento deben estar presentes y ser consistentes con la primera línea del lanzamiento. 

Participantes 

Los roles y nombres de todos los artistas y demás participantes deben aparecer en la columna única «participantes». Cada participante debe ir precedido de su rol y dos puntos. Los pares de rol y nombre deben ir separados por punto y coma. 

Por ejemplo: 

• Artistas principales: Natos, Waor. 
• Colaboración: Ambkor. 
• Remixer: Natos. 
• Productor: Waor. 
• Compositor: Waor. 

La columna «Participantes» debe mostrar: 

• primario:Natos;primario:Waor;con la participación de:Ambkor;remezclador:Natos;productor:Waor;compositor:Waor 

Reglas para los participantes 

• Cada lanzamiento y cada tema deben tener al menos un artista principal. 
• En un lanzamiento o una pista, un artista puede tener un solo rol entre «principal», «intérprete», «colaborador» y «con». 
• En cualquier lanzamiento al que se le asigne un género distinto de «no hablado», debe haber al menos un compositor en cada pista. 
• El artista principal debe ser el primer participante que aparece en la secuencia. 

Nombres de roles de participantes actualmente aceptados (en minúsculas) 

• principal 
• intérprete 
• productor 
• remixer 
• compositor 
• autor 
• editor 
• con la participación de 
• con 
• director 
• arreglista 
• orquesta 
• actor 

Pista duplicada en el mismo archivo CSV 

Si necesita crear una nueva pista, con un ISRC específico, que se compartirá en dos o más lanzamientos, puede hacerlo repitiendo la pista en todos esos lanzamientos, pero tenga especial cuidado de que la información de cada pista sea la misma en todas las duplicaciones. 

Si la información de alguna pista difiere de la de las demás, todas las pistas se marcarán como fallidas. 

Esta pista compartida debe tener un ISRC asignado; no puede ser un ISRC automático. 

Pista repetida en el catálogo del usuario 

Puedes asignar una pista existente en el catálogo del usuario a un lanzamiento recién creado. 

Para ello, en el archivo CSV debemos dejar vacía toda la información de la pista excepto el ISRC, que es el dato que utilizamos para encontrar la pista existente en el catálogo del usuario. 

Cómo adjuntar archivos de activos 

En los campos de enlaces de activos (cover_url a nivel de lanzamiento y audio_url a nivel de pista), debe vincular un archivo disponible para que podamos recuperarlo y subirlo con su contenido. 

Los activos son obligatorios y, si alguno de los enlaces falla, el lanzamiento no se podrá subir. Por lo tanto, debes asegurarte de que las URL apunten a los activos correctos. 
Si las URL (p. ej., WeTransfer) o las credenciales de autenticación (p. ej., URL firmadas de S3) tienen una vigencia limitada, asegúrate de que el tiempo sea suficiente para que el sistema pueda incorporar los activos. 

Consulte nuestra guía de requisitos para archivos de audio. 

Consulte nuestra guía de requisitos para carátulas. 

Métodos compatibles para la ingesta de activos 

Los recursos no se subirán directamente a la plataforma. En su lugar, el archivo de metadatos debe incluir una URL desde la que los sistemas puedan obtener el recurso en una sola llamada. Esto significa que la URL debe ser única para cada recurso. Por ejemplo, el enlace de la portada puede repetirse para cada pista del álbum, pero el audio debe ser único para cada pista (ya que el audio es diferente). La URL debe ser un enlace de descarga directa. 

No se deben incluir credenciales de autenticación de ningún tipo en la URL. El proceso de importación no seguirá ningún procedimiento de inicio de sesión por separado. 

Los metadatos no tienen que estar alojados permanentemente en la URL externa, solo deben ser accesibles mientras los recuperamos para procesar el álbum en nuestra plataforma. De hecho, a partir de ahí, el audio y la portada se almacenan en nuestro sistema. 

Actualmente admitimos las siguientes opciones: 

• URL públicas: 
  • URL HTTP 
  • URL HTTPS 
  • URL FTP 
  • URL de SFTP 
  • URL de Amazon S3 (con una URL firmada si el activo está protegido contra lectura) (este es el método preferido) 
  • Servicios de almacenamiento en la nube que proporcionan enlaces públicos de descarga directa (como Dropbox, WeTransfer o Google Drive) 

• URL autenticadas: 
  Admitimos algunos métodos de URL autenticadas, solo con nombre de usuario y contraseña. Para incluir un enlace autenticado, siga estos formatos: 
  • URL HTTP: http://{usuario}:{contraseña}@{host}/{archivo} 
  • URL HTTPS: https://{usuario}:{contraseña}@{host}/{archivo} 
  • URL de FTP: ftp://{usuario}:{contraseña}@{host}/{archivo} 
  • URL de SFTP*:sftp://{user}:{pass}@{host}/{file} 
  • URL de Amazon S3**: https://{bucket}.s3.amazonaws.com/{file}?AWSAccessKeyId={accesskey}&Signature={signature}&Expires={timestamp} 

* Solo admitimos claves públicas para las URL de SFTP. Para proporcionarnos una clave pública, comuníquese con nuestro centro de soporte y coordine su carga con nuestro equipo. 
** URL de Amazon S3: con una URL firmada si el activo está protegido contra lectura. 

Licencias Creative Commons 

Actualmente solo admitimos la versión 3.0 de CC. Utilice «license_info» para mostrar las cláusulas de Creative Commons con las siglas oficiales, separadas por guiones. 

Ejemplo de importación masiva CSV

Ejemplo de importación masiva CSV