Cómo migrar a archivos de datos estructurados v7

Última actualización: 18 de octubre de 2023

En esta guía, se explica el proceso de migración a la versión 7 de los archivos de datos estructurados (SDF) 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 exhaustiva de las diferencias entre la versión 6 y la 7.

Migra la versión de tus archivos de datos estructurados

Para migrar a la versión 7 de los archivos de datos estructurados desde una versión anterior, debes especificar la versión nueva, actualizar los espacios de ID para un subconjunto de columnas existentes y agregar la integración con columnas nuevas.

Actualiza 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 de socio y anunciante superiores, así como tus 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 del recurso 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. Ve a la página Detalles básicos en el menú Configuración de socios de la barra de navegación de la izquierda. 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 de la izquierda. 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 del socio, es posible que este parámetro de configuración no se pueda editar.

Se establece en la API

A nivel del anunciante

Realiza una solicitud advertisers.patch para actualizar dataAccessConfig.sdfConfig.sdfConfig.version a SDF_VERSION_7 y, si es necesario, dataAccessConfig.sdfConfig.overridePartnerSdfConfig a True.

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_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 desacoplar los archivos de datos estructurados del producto obsoleto de archivos de lectura de entidades y alinearse aún más con las herramientas admitidas, como la API de Display & Video 360.

Advertencia: Es posible que los IDs actualizados no sean compatibles con las secuencias de comandos de ofertas personalizadas. Te recomendamos que revises la documentación de referencia de los indicadores de las secuencias de comandos de ofertas personalizadas para obtener la información más reciente sobre los IDs que se deben usar antes de migrar.

En esta sección, se enumeran todas las columnas que usan IDs diferentes de la versión 6 y las instrucciones para recuperar información de referencia sobre los valores nuevos.

Pedido de inserción

Instrucciones de migración a la versión 7 para las columnas
Segmentación por aplicación: Excluir Segmentación de aplicaciones: Incluir	Estas columnas se actualizaron para usar identificadores de apps que siguen el formato “App Platform:App ID”. Entre los ejemplos, se incluyen los siguientes: “APP:com.google.android.gm”, “APP:422689480” y “ANDROID_TV_APP:com.google.android.youtube.tvunplugged”. Las plataformas de apps se identifican con un valor de cadena. Los IDs de app son los IDs 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 Segmentación por navegador: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en tipo de segmentación TARGETING_TYPE_BROWSER. Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Segmentación por operadores: Excluir Segmentación por operadores: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en tipo de segmentación TARGETING_TYPE_CARRIER_AND_ISP. Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Segmentación por canal: Excluir Segmentación por canal: Incluir	Esta columna se actualizó para usar el valor channelId del recurso Channel de la API de Display & Video 360. Recupera recursos Channel de forma individual o en listas paginadas con los servicios advertisers.channels y partners.channels.
Segmentación por dispositivo: Excluir Segmentación por dispositivo: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en los siguientes tipos de segmentación: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Mide el canal de DAR	Esta columna se actualizó para usar el valor channelId del recurso Channel de la API de Display & Video 360. Recupera recursos Channel de forma individual o en listas paginadas con los servicios advertisers.channels y partners.channels.
Segmentación por sitio: Excluir Segmentació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 a la versión 7 para las columnas
Segmentación por aplicación: Excluir Segmentación de aplicaciones: Incluir	Estas columnas se actualizaron para usar identificadores de apps que siguen el formato “App Platform:App ID”. Entre los ejemplos, se incluyen los siguientes: “APP:com.google.android.gm”, “APP:422689480” y “ANDROID_TV_APP:com.google.android.youtube.tvunplugged”. Las plataformas de apps se identifican con un valor de cadena. Los IDs de app son los IDs 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ó para usar nuevos IDs de criterios para los tipos de filas de app y sitio. Se actualizó el tipo de fila app para usar valores de cadena concatenada de la plataforma de la aplicación y el ID de la plataforma de la aplicación, separados por dos puntos, para los IDs de criterios. Las plataformas de apps se identifican con un valor de cadena. Los IDs de app son los IDs 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. Se actualizó el tipo de fila site para usar cadenas de URL como IDs de criterios.
Segmentación por navegador: Excluir Segmentación por navegador: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en tipo de segmentación TARGETING_TYPE_BROWSER. Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Segmentación por operadores: Excluir Segmentación por operadores: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en tipo de segmentación TARGETING_TYPE_CARRIER_AND_ISP. Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Segmentación por canal: Excluir Segmentación por canal: Incluir	Esta columna se actualizó para usar el valor channelId del recurso Channel de la API de Display & Video 360. Recupera recursos Channel de forma individual o en listas paginadas con los servicios advertisers.channels y partners.channels.
Segmentación por dispositivo: Excluir Segmentación por dispositivo: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en los siguientes tipos de segmentación: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.
Segmentación por sitio: Excluir Segmentación por sitio: Incluir	Esta columna se actualizó para identificar sitios a través de cadenas de URL.

Producto multimedia

Instrucciones de migración a la versión 7 para las columnas
Segmentación por canal: Excluir Segmentación por canal: Incluir	Esta columna se actualizó para usar el valor channelId del recurso Channel de la API de Display & Video 360. Recupera recursos Channel de forma individual o en listas paginadas con los servicios advertisers.channels y partners.channels.
Segmentación por dispositivo: Incluir	Esta columna se actualizó para usar los valores targetingOptionId de los recursos TargetingOption de la API de Display & Video 360 en los siguientes tipos de segmentación: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Recupera recursos TargetingOption de forma individual o en listas paginadas con el servicio targetingTypes.targetingOptions.

Se agregó la integración con las columnas agregadas desde 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	Ventana de tiempo de la frecuencia objetivo de TrueView
Grupo de anuncios de YouTube	Segmentación optimizada

Si migras desde una versión anterior de los 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 la versión 6 de los SDF.

Cambios adicionales

En la versión 7, también implementamos algunos cambios superficiales que deberían ayudarte a simplificar tu integración y dejar de usar los archivos de lectura de entidades obsoletos como referencia.

Nuevo orden de la lista para un subconjunto de columnas

SDF v7 garantiza un orden estable de ciertas columnas de lista cuando se genera un archivo. Esto genera un comportamiento más coherente y una revisión más fácil. Este orden no se aplica cuando se sube el archivo, sino que se aplica posteriormente cuando se genera el archivo actualizado.

Revisa las notas 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.

Nuevas recomendaciones de referencia de ID

Actualizamos las definiciones de varias columnas para quitar la referencia a los archivos de lectura de entidades obsoletos y, en su lugar, recomendamos otros medios de búsqueda de ID.

Los valores que muestran las siguientes columnas no son diferentes de los de la versión 6 de SDF, pero te sugerimos que actualices tu integración para recuperar los IDs con el nuevo método recomendado, que se encuentra en las descripciones de las columnas de la versión 7.

Tipos de archivos y sus columnas
Campaña	Segmentación geográfica: Excluir Segmentación geográfica: Incluir Segmentación por fuente de inventario: Excluir Segmentación por fuente de inventario: Incluir Segmentación por idioma: Excluir Segmentación por idioma: Incluir
Pedido de inserción	Segmentación por públicos afines y en el mercado: Excluir Segmentación por públicos afines y en el mercado: Incluir Segmentación por colección de aplicaciones: Excluir Segmentación de recopilación de aplicaciones: Incluir Segmentación por público: Excluir Segmentación por público: Incluir Segmentación por categoría: Excluir Segmentación por categoría: Incluir Segmentación por género de contenido: Excluir Segmentación por género de contenido: Incluir Segmentación por lista de clientes Segmentación geográfica: Excluir Segmentación geográfica: Incluir Segmentación por fuente de inventario: Excluir Segmentación por fuente de inventario: Incluir Segmentación por lista de palabras clave: Excluir Segmentación por idioma: Excluir Segmentación por idioma: Incluir
Línea de pedido	Segmentación por públicos afines y en el mercado: Excluir Segmentación por públicos afines y en el mercado: Incluir Segmentación por colección de aplicaciones: Excluir Segmentación de recopilación de aplicaciones: Incluir Segmentación por público: Excluir Segmentación por público: Incluir Segmentación por categoría: Excluir Segmentación por categoría: Incluir Segmentación por público combinado Segmentación por género de contenido: Excluir Segmentación por género de contenido: Incluir IDs de actividad de Floodlight de conversión Asignaciones de creatividades Segmentación por lista de clientes Segmentación geográfica: Excluir Segmentación geográfica: Incluir Segmentación por fuente de inventario: Excluir Segmentación por fuente de inventario: Incluir Segmentación por lista de palabras clave: Excluir Segmentación por idioma: Excluir Segmentación por idioma: Incluir
Producto multimedia	Segmentación por público: Excluir Segmentación por público: Incluir Segmentación por categoría: Excluir Segmentación por categoría: Incluir Segmentación geográfica: Incluir Segmentación por idioma: Excluir Segmentación por idioma: Incluir
Grupo de anuncios de YouTube	Segmentación por públicos afines y en el mercado: Excluir Segmentación por públicos afines y en el mercado: Incluir Segmentación por público: Excluir Segmentación por público: Incluir Segmentación por categoría: Excluir Segmentación por categoría: Incluir Segmentación por lista de clientes