Última actualización: 18/10/2023
En esta guía, se explica el proceso de migración a los archivos de datos estructurados (SDF) v7 desde una versión anterior y los cambios, tanto obligatorios como sugeridos, que puedes realizar para optimizar mejor tu integración.
Consulta las notas de la versión para obtener una lista completa de las diferencias entre las versiones 6 y 7.
Cómo migrar tu versión de archivos de datos estructurados
Para migrar a archivos de datos estructurados v7 desde una versión anterior, debes especificar la versión nueva, actualizar los espacios de ID para un subconjunto de columnas existentes y agregar integración con columnas nuevas.
Cómo actualizar la versión de archivos de datos estructurados
Para actualizar a una nueva versión de los archivos de datos estructurados, debes actualizar la versión que asignaste a los recursos superiores de socio y anunciante y a tus tareas de descarga individuales en la API de Display & Video 360.
Actualizar la configuración de recursos superiores
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 predeterminada cuando se descargan archivos de datos estructurados a través de la interfaz o la API.
Configurar en la interfaz
- A nivel del socio
- Navega al socio deseado. Dirígete a la página Basic Details en el menú Partner Settings del panel de navegación izquierdo. Actualiza la configuración de la versión SDF en la sección Archivos de datos estructurados a la v7.
- A nivel del anunciante
- Navega al anunciante deseado. Dirígete a la página Detalles básicos del menú Configuración del anunciante en la barra de navegación de la izquierda. Actualiza la configuración de la versión SDF en la sección Archivos de datos estructurados a la v7. Si la versión predeterminada se establece en el nivel de socio, es posible que esta configuración no se pueda editar.
Configura en la API
- A nivel del anunciante
- Realiza una solicitud
advertisers.patchpara actualizar eldataAccessConfig.sdfConfig.sdfConfig.versionaSDF_VERSION_7y, si es necesario,dataAccessConfig.sdfConfig.overridePartnerSdfConfig, aTrue.
Actualiza las solicitudes sdfdownloadtasks.create en la API
Cuando realices una solicitud sdfdownloadtasks.create con la API de Display & Video 360, establece el campo version del cuerpo de la solicitud en SDF_VERSION_7.
Actualiza los IDs en las columnas obligatorias
En la versión 7, los espacios de ID que usa un subconjunto de columnas se actualizaron para separar los archivos de datos estructurados del producto Entity Read Files obsoleto y alinearse aún más con herramientas compatibles, como la API de Display & Video 360.
En esta sección, se enumeran todas las columnas con ID diferentes a los de la versión 6 y con instrucciones para recuperar información de referencia sobre los valores nuevos.
Pedido de inserción
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación por aplicación: Excluir Orientación a aplicaciones: Incluir |
Estas columnas se actualizaron para usar identificadores de apps con el formato " Las plataformas de aplicaciones se identifican con un valor de cadena. Los IDs de app son los que proporciona la plataforma relevante, como un ID de paquete de Play Store de Android o un ID de app de la App Store de Apple. |
|
Segmentación por navegador: Excluir Orientación por navegador: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
|
Segmentación por operadores: Excluir Segmentación por operadores: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
|
Segmentación por canal: Excluir Segmentación por canal: Incluir |
Esta columna se actualizó para usar el valor
Recupera recursos |
|
Segmentación por dispositivo: Excluir Segmentación por dispositivo: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
| Mide el canal de DAR |
Esta columna se actualizó para usar el valor
Recupera recursos |
Segmentación por sitio: Excluir Orientación por sitio: Incluir |
Esta columna se actualizó para identificar sitios a través de cadenas de URL. |
Línea de pedido
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación por aplicación: Excluir Orientación a aplicaciones: Incluir |
Estas columnas se actualizaron para usar identificadores de apps con el formato " Las plataformas de aplicaciones se identifican con un valor de cadena. Los IDs de app son los que proporciona la plataforma relevante, como un ID de paquete de Play Store de Android o un ID de app de la App Store de Apple. |
| Multiplicadores de ofertas |
Esta columna se actualizó a fin de usar nuevos IDs de criterios para los tipos de fila app y site. El tipo de fila app se actualizó para usar valores de cadena concatenados del ID de la plataforma de la app y la plataforma de la app, separados por dos puntos, para los IDs de los criterios. Las plataformas de aplicaciones se identifican con un valor de cadena. Los IDs de apps son los que proporciona la plataforma relevante, como un ID de paquete de Play Store de Android o un ID de app de la App Store de Apple. El tipo de fila site se actualizó para usar strings de URL como ID de criterios. |
|
Segmentación por navegador: Excluir Orientación por navegador: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
|
Segmentación por operadores: Excluir Segmentación por operadores: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
|
Segmentación por canal: Excluir Segmentación por canal: Incluir |
Esta columna se actualizó para usar el valor
Recupera recursos |
|
Segmentación por dispositivo: Excluir Segmentación por dispositivo: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
Segmentación por sitio: Excluir Orientación por sitio: Incluir |
Esta columna se actualizó para identificar sitios a través de cadenas de URL. |
Producto multimedia
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación por canal: Excluir Segmentación por canal: Incluir |
Esta columna se actualizó para usar el valor
Recupera recursos |
| Segmentación por dispositivo: Incluir |
Esta columna se actualizó para usar los valores
Recupera recursos |
Agregar integración con columnas agregadas a partir de la versión 6
Si migras de v6 a v7, debes agregar las siguientes columnas a los archivos relevantes:
| File type | Columna |
|---|---|
| Línea de pedido | Recuento de frecuencia objetivo de TrueView |
| Línea de pedido | Período de frecuencia objetivo de TrueView |
| Grupo de anuncios de YouTube | Segmentación optimizada |
Si migras desde una versión anterior de archivos de datos estructurados, consulta las notas de la versión de archivos de datos estructurados para obtener información sobre las columnas adicionales que se agregaron entre tu versión actual y el SDF v6.
Cambios adicionales
En la versión 7, también instauramos algunos cambios superficiales que deberían ayudarte a simplificar tu integración y evitar el uso de archivos de lectura de entidades obsoletos a modo de referencia.
Nuevo orden de lista para algunas columnas
SDF v7 garantiza un orden estable de ciertas columnas de lista después de que se generan los archivos. Esto da como resultado un comportamiento más coherente y una revisión más sencilla. Este orden no se aplica de manera forzosa cuando se sube el archivo, pero se aplica posteriormente cuando se genera el archivo actualizado.
Consulta las notas de la versión v7 para obtener una lista completa de las columnas que ahora se generan en orden ascendente, numérico o alfabético.
Recomendaciones de referencias de nuevos IDs
Actualizamos las definiciones de varias columnas para quitar la referencia a los archivos de lectura de entidades obsoletos y, en su lugar, recomendar otros medios de búsqueda de ID.
Los valores que muestran las siguientes columnas no son diferentes a los de SDF v6, pero te sugerimos que actualices tu integración para recuperar los ID con el nuevo método recomendado, que se puede encontrar en las descripciones de las columnas de la versión 7.
| Tipos de archivos y sus columnas | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| Pedido de inserción |
|
|||||||||||||||||||||
| Línea de pedido |
|
|||||||||||||||||||||
| Producto multimedia |
|
|||||||||||||||||||||
| Grupo de anuncios de YouTube |
|
|||||||||||||||||||||