Los archivos de datos estructurados (SDF) son archivos CSV con un formato especial. Permiten la recuperación, la creación y la edición masivas de recursos en Display & Video 360. Descarga, edita y vuelve a subir los SDF para actualizar los recursos de forma masiva.
La IU de Display & Video 360 admite descargas y cargas de SDF. La API de Display & Video 360 admite las descargas de SDF.
Formatos
Un SDF usa uno de los dos formatos base, Estándar y QA:
- Puedes descargar y subir archivos en formato estándar. Los datos de estos archivos pueden usar IDs numéricos para garantizar la precisión durante la carga. Es posible que se requiera información de referencia para interpretar los datos.
- Puedes descargar archivos en formato de QA. Estos archivos proporcionan los mismos datos que los archivos de formato estándar, pero usan valores más legibles por humanos. Por ejemplo, algunas columnas pueden usar nombres visibles en lugar de IDs. Las columnas específicas de este formato usan el sufijo "Qa".
Tipos de archivo
El SDF admite siete tipos de recursos. Cada tipo de recurso tiene su propio tipo de archivo con su propia estructura de columnas. Los tipos de recursos admitidos son los siguientes:
- Campaña
- Pedido de inserción
- Línea de pedido
- Grupo de anuncios
- Anuncio
- Fuente de inventario
- Producto de medios
Solo los tipos de archivos Línea de pedido y Grupo de anuncios admiten el formato QA.
Las versiones nuevas de SDF se lanzan con regularidad y las versiones anteriores dejan de estar disponibles. Las versiones nuevas actualizan la estructura de la columna de tipo de archivo. Si es necesario, una nueva versión del SDF incluirá una guía de migración en el lanzamiento.
Descargar errores
Las descargas del SDF pueden generar dos tipos de errores: errores de generación de archivos y recursos omitidos.
Errores de generación de archivos
La generación de SDF puede finalizar con un error. Si falla la generación cuando se usa la API de Display & Video 360, la tarea finalizada establecerá su campo error con el objeto Status. El objeto Status contendrá un mensaje que detalla la causa del error.
Obtén más información sobre estos errores en nuestra página de la guía de errores y advertencias.
Errores omitidos
Los SDF no admiten todos los subtipos de recursos. Si no se puede incluir un recurso en un SDF, se incluirá un archivo "Omitido" (por ejemplo, SDF-LineItems-Skipped.csv) en la descarga. Este archivo tiene una estructura de dos columnas. La primera columna identifica el recurso omitido. La segunda columna explica su exclusión.
Subir archivo
Sube SDFs con la IU de Display & Video 360 para crear recursos nuevos o actualizar los existentes.
Sigue estos pasos para minimizar los errores cuando actualices o crees recursos con SDF:
- Descarga los SDFs con la API de Display & Video 360 o la IU.
- Modifica las entradas de archivos existentes para actualizar los recursos existentes.
- Agrega entradas de archivos para crear recursos nuevos.
- Quita las entradas que no sean nuevas ni estén actualizadas. Esto reduce el tamaño del archivo y elimina la posibilidad de actualizaciones involuntarias.
- Sube el archivo en la IU de Display & Video 360.
Después de que se sube y procesa un SDF, se puede descargar un archivo SDF-ResultFile.zip. Este archivo ZIP puede contener dos archivos posibles:
SDF-{ResourceType}-Updated-ResultFile.csv, que enumera los recursos que se actualizaron o crearon correctamente.SDF-{ResourceType}-Failed-ResultFile.csv, que enumera las operaciones fallidas y los mensajes de error pertinentes.
El archivo ZIP puede contener uno o ambos archivos.