Última actualización: 18 de octubre de 2023
En esta guía, se explica el proceso de migración de una versión anterior a Archivos de datos estructurados (SDF) v7, así como los cambios obligatorios y sugeridos que puedes implementar para optimizar tu integración.
Consulta las notas de la versión para obtener una lista exhaustiva de las diferencias entre las versiones 6 y 7.
Cómo migrar la versión de tus 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.
Actualizar la versión de los archivos de datos estructurados
Para actualizar a una nueva versión de los archivos de datos estructurados, debes actualizar la versión que asignas a tus recursos superiores de socio y anunciante, y tus tareas de descarga individuales en la API de Display & Video 360.
Actualizar configuración de recursos superiores
Se configura una versión predeterminada de archivos de datos estructurados a nivel de 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 hasta el socio deseado. Ve a la página Detalles básicos en el menú Configuración de socios en el panel de navegación izquierdo. Actualiza la configuración de la versión de SDF en la sección Archivos de datos estructurados a v7.
- A nivel del anunciante
- Navega al anunciante deseado. Ve a la página Detalles básicos en el menú Configuración del anunciante en el panel de navegación izquierdo. Actualiza la configuración de la versión de SDF en la sección Archivos de datos estructurados a v7. Si la versión predeterminada se establece a nivel de socio, es posible que no se pueda editar esta configuración.
Configurado en la API
- A nivel del anunciante
- Realiza una solicitud
advertisers.patchpara actualizardataAccessConfig.sdfConfig.sdfConfig.versionaSDF_VERSION_7y, si es necesario,dataAccessConfig.sdfConfig.overridePartnerSdfConfigaTrue.
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, se actualizaron los espacios de ID que usa un subconjunto de columnas para separar los archivos de datos estructurados del producto obsoleto de Archivos de lectura de entidades y alinearse aún más con las herramientas compatibles, como la API de Display & Video 360.
En esta sección, se enumeran todas las columnas con diferentes IDs a los de la versión 6, así como instrucciones para recuperar información de referencia en los valores nuevos.
Pedido de inserción
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación de aplicación: excluir Segmentación por app: Incluir |
Estas columnas se actualizaron para usar identificadores de apps con el formato " Las plataformas de apps se identifican mediante un valor de cadena. Los IDs de app son los que proporciona la plataforma relevante, como el ID de paquete de Play Store de Android o el ID de app de la App Store de Apple. |
|
Segmentación por navegador: excluir Segmentación por navegador: Incluir |
Esta columna se actualizó para utilizar los valores
Recupera recursos |
|
Segmentación por operadores de telefonía móvil: excluir Segmentación por operadores de telefonía móvil: incluir |
Esta columna se actualizó para utilizar los valores
Recupera recursos |
|
Segmentación del 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 valores
Recupera recursos |
| Mide el canal de DAR |
Esta columna se actualizó para usar el valor
Recupera recursos |
Orientación del sitio: excluir Orientación del sitio: Incluir |
Esta columna se actualizó para identificar sitios mediante cadenas de URL. |
Línea de pedido
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación de aplicación: excluir Segmentación por app: Incluir |
Estas columnas se actualizaron para usar identificadores de apps con el formato " Las plataformas de apps se identifican mediante un valor de cadena. Los IDs de app son los que proporciona la plataforma relevante, como el ID de paquete de Play Store de Android o el ID de app de la App Store de Apple. |
| Multiplicadores de ofertas |
Esta columna se actualizó para usar nuevos ID de criterios en los tipos de fila app y site. El tipo de fila app se actualizó para usar valores de string concatenados de la plataforma de la app y el ID de la plataforma de la app, separados por dos puntos, en los IDs de criterios. Las plataformas de apps se identifican mediante un valor de cadena. Los IDs de app son los que proporciona la plataforma relevante, como el ID de paquete de Play Store de Android o el ID de app de 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 Segmentación por navegador: Incluir |
Esta columna se actualizó para utilizar los valores
Recupera recursos |
|
Segmentación por operadores de telefonía móvil: excluir Segmentación por operadores de telefonía móvil: incluir |
Esta columna se actualizó para utilizar los valores
Recupera recursos |
|
Segmentación del 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 valores
Recupera recursos |
Orientación del sitio: excluir Orientación del sitio: Incluir |
Esta columna se actualizó para identificar sitios mediante cadenas de URL. |
Producto multimedia
| Instrucciones de migración de la versión 7 para columnas | |
|---|---|
|
Segmentación del 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 valores
Recupera recursos |
Agregar integración con columnas agregadas a partir de la versión 6
Si migras de la versión 6 a la 7, 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 la 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 los archivos de datos estructurados para obtener información sobre las columnas adicionales que se agregaron entre tu versión actual y SDF v6.
Cambios adicionales
En la versión 7, también implementamos algunos cambios superficiales que deberían ayudarte a simplificar la integración y dejar de usar archivos de lectura de entidades obsoletos como referencia.
Nuevo orden de lista para un subconjunto de columnas
SDF v7 garantiza un orden estable de ciertas columnas de lista cuando 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 de la versión 7 para obtener una lista completa de las columnas que ahora se generan en orden alfabético o numérico ascendente.
Recomendaciones para las referencias de IDs nuevos
Actualizamos las definiciones de varias columnas para quitar la referencia a 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 IDs con el nuevo método recomendado, que se puede encontrar en las descripciones de sus columnas v7.
| Tipos de archivo y sus columnas | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| Pedido de inserción |
|
|||||||||||||||||||||
| Línea de pedido |
|
|||||||||||||||||||||
| Producto multimedia |
|
|||||||||||||||||||||
| Grupo de anuncios de YouTube |
|
|||||||||||||||||||||