Última actualización: 12 de noviembre de 2024
En esta guía, se explica el proceso de migración del uso de archivos de datos estructurados de la versión 7.1 a la 8, y se describen los cambios entre las dos versiones que pueden afectar tu integración.
Consulta las notas de la versión para obtener una lista exhaustiva de las diferencias entre la versión 7.1 y la 8.
Migra la versión de tus archivos de datos estructurados
Para migrar a la versión 8 de los archivos de datos estructurados (SDF) desde una versión anterior, sigue estos pasos:
- Actualiza tus recursos y acciones de generación de SDF para usar la versión 8.
- Se actualizó la lógica de recursos de anuncios para identificar un tipo en el momento de la creación.
- Se agregó una nueva lógica para leer, crear y actualizar recursos de generación de demanda.
Actualiza la versión de los archivos de datos estructurados
Para usar una nueva versión de los archivos de datos estructurados, actualiza la versión asignada en tus recursos de socio y anunciante superiores, y usa la nueva versión cuando crees tareas de descarga individuales en la API de Display & Video 360.
Actualiza la configuración del recurso superior
Se establece una versión predeterminada de los archivos de datos estructurados a nivel de los recursos del socio y del anunciante. Esta versión se usa como la predeterminada cuando se descargan archivos de datos estructurados a través de la interfaz o la API.
Se establece en la interfaz
A nivel del socio
- Navega al socio deseado.
- Expande el menú Configuración de socios en el panel de navegación de la izquierda y ve a la página Detalles básicos.
- Actualiza la configuración de la versión de SDF en la sección Archivos de datos estructurados a v8.
A nivel del anunciante
- Navega al anunciante deseado.
- Expande el menú Configuración del anunciante en el panel de navegación de la izquierda y ve a la página Detalles básicos.
- Actualiza la configuración de la versión de SDF en la sección Archivos de datos estructurados a v8. Si la versión predeterminada se establece a nivel del socio, es posible que este parámetro de configuración no se pueda editar.
Se establece en la API
- A nivel del socio
- No puedes establecer la versión predeterminada de SDF a nivel del socio en la API.
- A nivel del anunciante
- Realiza una solicitud
advertisers.patchpara actualizardataAccessConfig.sdfConfig.sdfConfig.versionaSDF_VERSION_8y, si es necesario,dataAccessConfig.sdfConfig.overridePartnerSdfConfigaTrue.
Actualiza las solicitudes de sdfdownloadtasks.create en la API
Cuando realices una solicitud sdfdownloadtasks.create con la API de Display & Video 360, configura el campo version del cuerpo de la solicitud como SDF_VERSION_8.
Especifica el tipo en los recursos de anuncios
La versión 8 agrega una columna Ad Type a los archivos Ad, que muestra el tipo de anuncio que representa cada fila. Esta nueva columna es obligatoria y se propagará para los recursos existentes cuando se descarguen archivos de anuncios de v8.
Cuando se actualizan los anuncios existentes, no se debe cambiar el valor de esta columna.
Cuando crees anuncios nuevos, debes propagar esta columna con uno de los valores que se indican en la descripción de la columna.
Actualización de la lógica para los recursos de generación de demanda
La versión 8 admite la creación, recuperación y actualización de campañas de generación de demanda con archivos Línea de pedido, Grupo de anuncios y Anuncio. Los recursos de Demand Gen usan una lógica diferente para la verificación de marcas de tiempo, requieren la propagación de columnas adicionales y están limitados por nuevas restricciones en los tres tipos de archivos.
Verificación de marcas de tiempo
En el caso de todas las líneas de pedido que no son de generación de demanda, la columna Timestamp de un archivo LineItem se completa durante la descarga con la última vez que se modificó una línea de pedido. Este valor se usa cuando se actualiza una línea de pedido con SDF para verificar que no se haya actualizado desde que se descargó el archivo original. De lo contrario, la actualización fallará.
En el caso de las líneas de pedido de generación de demanda, la columna Timestamp y la verificación que la acompaña funcionan de manera diferente. En el caso de las entradas de líneas de pedido de generación de demanda, la columna se completa con la hora actual en la descarga. Durante la carga, Display & Video 360 verifica si transcurrieron más de 24 horas desde la marca de tiempo determinada. Si transcurrieron más de 24 horas, la entrada del archivo original se considera inactiva y la actualización falla. Si esto sucede, vuelve a descargar el archivo y realiza las actualizaciones según la versión más reciente. Este nuevo método de verificación no te impide reemplazar los cambios realizados en las últimas 24 horas. Para evitar reemplazos accidentales, solo incluye los elementos de una sola línea de generación de demanda que deseas actualizar en los archivos que subas.
Columnas obligatorias
Los siguientes tipos de archivos tienen columnas que ahora son obligatorias para ciertos recursos de generación de demanda, además de las columnas que son obligatorias para todas las entidades de ese tipo de archivo.
Línea de pedido
Columnas obligatorias para los siguientes valores de columna Type de Artículo de la factura
|
||||
| Generación de demanda |
|
|||
Anuncio
Columnas obligatorias para los siguientes valores de la columna Ad Type de
Anuncio
|
|||||||||
| Carrusel de generación de demanda |
|
||||||||
| Imagen de generación de demanda |
|
||||||||
| Producto de generación de demanda |
|
||||||||
| Video de generación de demanda |
|
||||||||
Restricciones actualizadas
Además de las nuevas columnas obligatorias para ciertas líneas de pedido y anuncios de generación de demanda, varias columnas de los tipos de archivo Línea de pedido, Grupo de anuncios y Anuncio tienen nuevas restricciones de uso que se aplican a los recursos de generación de demanda.
Estas restricciones son numerosas y específicas de las columnas en cuestión, por lo que esta guía no proporciona una lista exhaustiva de las restricciones. Te recomendamos que leas atentamente la documentación de referencia de v8 para los tipos de archivos Line Item, Ad Group y Ad antes de crear o actualizar recursos de generación de demanda con la carga de SDF.