Migración de inventario de v1 a v2

El inventario v1 es una estructura jerárquica de entidades de feed en formato JSON-LD. Este esquema permitió que los socios del programa de acceso anticipado usaran el esquema para integrarse en los pedidos de extremo a extremo. El esquema de inventario v1 está obsoleto.

La versión más reciente de la especificación del feed de datos, el inventario v2, tiene una estructura plana y usa un modelo de esquema relacional. Esto permite a los socios extraer y transformar entidades de sus bases de datos relacionales de una manera más directa para crear los feeds de datos. El inventario v2 está en NDJSON, que es un formato JSON delimitado por saltos de línea.

Por qué es recomendable migrar de la versión 1 a la versión 2

Aunque continuamos brindando asistencia de mantenimiento a los socios con pedidos de integraciones de esquemas de inventario v1 de extremo a extremo, todas las integraciones de socios nuevas deben usar el inventario de v2.

Es posible que las funciones nuevas del inventario de la versión 2 no estén disponibles en el de la versión 1. Para ver un ejemplo, consulta Acuerdo.

Pasos de la migración

El uso del inventario v2 requiere un proyecto de pedido integral independiente y una nueva integración. En el siguiente proceso, se explica cómo migrar un inventario de v1 a uno de v2.

  1. Para crear un proyecto de v2 nuevo, primero completa los pasos de integración.
    1. Para implementar los feeds de datos, usa el esquema de inventario relacional.
    2. Si corresponde, vuelve a usar el extremo de entrega de tu proyecto de la versión 1.
  2. Cuando tu proyecto v2 esté listo para el lanzamiento, sigue estos pasos:
  3. Asegúrate de que tu proyecto de v2 cumpla con la lista de tareas de preparación para el lanzamiento.
    1. Para evitar entregar el esquema de inventario v1 y v2 a los usuarios finales, anula la implementación de la versión de producción de tu proyecto v1. El inventario del proyecto v1 deja de publicarse en producción minutos después de este paso.
    2. Crea una versión de producción para tu proyecto v2 y notifica a tu asesor de Google.

Revertir pasos

Si quieres revertir a la versión 1 después de la implementación de la versión de producción del proyecto de la versión 2, puedes anular la implementación de la versión de producción en el proyecto de la versión 2 y volver a implementar la versión de producción del proyecto de la versión 1.

Impacto en los datos de socios y la clasificación de proveedores

Los siguientes son impactos potenciales en los datos de los socios y la clasificación de los proveedores.

  • Los registros de transacciones y los datos de estadísticas del proyecto v1 no se transfieren al proyecto v2.
  • Las métricas de rendimiento, como los porcentajes de conversiones y las métricas de la API de tu proyecto de la versión 1, no se transfieren al proyecto de la versión 2. Esto restablece la clasificación de tu proveedor en el ordenamiento de extremo a extremo.