Sincronización optimizada del catálogo de Salesforce Commerce Cloud

Qué aprenderás

Descubre cómo habilitar las funciones de sincronización de catálogo optimizada para las integraciones de Salesforce Commerce Cloud.

Antes de empezar

• La tienda de SFCC ya debe estar integrada con Klaviyo. Si no es así, completa primero Primeros pasos con Salesforce Commerce Cloud.
• La sincronización optimizada del catálogo es opcional. No es necesario actualizar el cartucho de Klaviyo para usarla.
• Pide al servicio de asistencia de Salesforce que confirme que las exportaciones delta están habilitadas en tu cuenta. No todas las instancias lo tienen de forma predeterminada.
• Se requiere acceso a SFCC Business Manager para completar la configuración.

Sincronización predeterminada del catálogo frente a sincronización optimizada del catálogo

Una sincronización de catálogos tiene 3 componentes:

• El producto y sus variantes asociadas
• Precio y estado del producto
• Inventario

En la sincronización periódica de catálogos predeterminada, Klaviyo usa los puntos de conexión Data OCAPI POST /s/-/dw/data/{version}/product_search y GET /s/-/dw/data/{version}/products/{master_product_id}/variations para sincronizar los 3 componentes al mismo tiempo.

El atributo last_modified indica la última vez que cambiaron los datos del producto. Sin embargo, no se actualiza cuando se produce un cambio de precio o de inventario. Debido a esta limitación, Klaviyo debe resincronizar todo el catálogo en cada ejecución de sincronización predeterminada para detectar todas las actualizaciones de precio e inventario.

Cuanto más grande sea el catálogo, más tardará Klaviyo en ejecutar una sincronización periódica del catálogo. Una sincronización completa suele tardar 8 horas o más.

La sincronización optimizada del catálogo separa los productos y las variantes, el inventario, el precio y el estado del producto en 3 sincronizaciones:

Al hacerlo, tanto los productos/variantes como el inventario han pasado a una sincronización delta y solo se actualizan los productos que estaban last_modified desde la ejecución anterior de la sincronización. Al habilitar actualizaciones por hora para llegar a Klaviyo.

La sincronización de precios se seguirá ejecutando en todo el catálogo. Como las solicitudes solo consultan el precio, será mucho más rápido ejecutar el catálogo completo en comparación con la sincronización de catálogo predeterminada. Puedes programar la sincronización de precios para que se inicie a la misma hora todos los días, para garantizar que cualquier cambio de precio que hayas implementado llegue a Klaviyo poco después.

Cómo configurar la sincronización optimizada del catálogo

Completa estos pasos en orden. No se requiere ninguna actualización de cartridge.

Paso 1: solicitar acceso a las exportaciones delta

Las exportaciones delta no están disponibles de forma predeterminada en todas las cuentas de SFCC. Ponte en contacto con el equipo de soporte de Salesforce para activar la función. Consulta la documentación sobre exportaciones delta de Salesforce para obtener más información.

Paso 2: crear una exportación delta para la lista de inventario

En SFCC Business Mánager, ve a Administración > Desarrollo del sitio > Exportaciones delta.

Crea una exportación delta para cada sitio que se sincronice con Klaviyo. Para cada exportación:

1. Configura Consumidor como klaviyo.
2. Configura Nombre de exportación como klaviyo-{site ID}. Sustituye {site ID} por el ID del sitio real.
3. Añade el tipo de datos Listas de inventario.
4. Selecciona la lista de inventario de ese sitio. No selecciones todas las listas.
5. Configura la programación para que se ejecute cada 3 horas.
6. Ejecuta la exportación una vez para completar la configuración.

Cada exportación debe contener exactamente 1 lista de inventario. Klaviyo asigna cada registro de una exportación al sitio identificado por el nombre de la exportación, así que incluye solo la lista de inventario de ese sitio.

Paso 3: concede a Klaviyo acceso a WebDAV

En Business Manager, ve a Administración > Organización > Permisos del cliente WebDAV.

Concede acceso de lectura a /impex/src/platform/outbox/klaviyo para el ID de cliente que ya tiene acceso a OCAPI.

Texto de ejemplo que se debe añadir en Permisos de la aplicación cliente de WebDAV:

{
  "client_id": "{Client ID that is assigned to Klaviyo}",
  "permissions": [
    {
      "operations": [
        "read"
      ],
      "path": "/impex/src/platform/outbox/klaviyo/"
    }
  ]
}

Importante: Antes de continuar, confirma que el acceso a WebDAV y el acceso a OCAPI usan el mismo ID de cliente. Este es el error de configuración más común.

Paso 4: Activa la sincronización optimizada del catálogo en Klaviyo

1. En Klaviyo, ve a la configuración de integración de Salesforce Commerce Cloud.
2. Haz clic en Habilitar en la tarjeta Sincronización optimizada del catálogo.

3. En Precio y estado, elige la hora a la que comenzará la sincronización diaria. La hora usa la zona horaria de la cuenta de Klaviyo, que se muestra en el cuadro de diálogo.
4. Haz clic en Habilitar en el cuadro de diálogo para guardar la configuración y activar la sincronización optimizada del catálogo.

En Producto e inventario, comprueba el estado de cada sitio. En buen estado significa que Klaviyo puede acceder a los archivos de exportación de ese sitio. Última exportación muestra la hora de exportación más reciente cuando está disponible; no confirma que Klaviyo haya terminado de sincronizar la exportación.

Si un sitio muestra Sin acceso, confirma que el mismo ID de cliente de API que se usa para OCAPI tenga acceso de lectura a /impex/src/platform/outbox/klaviyo.

Si un sitio muestra No se ha encontrado ninguna exportación, confirma que su exportación usa klaviyo como consumidor y klaviyo-{site ID} como nombre de la exportación, y que se ha ejecutado al menos una vez.

Recursos adicionales